← 返回 Skills 市场
Openclaw Smart Search
作者
fdenny11gg
· GitHub ↗
· v1.0.14
· MIT-0
144
总下载
0
收藏
0
当前安装
15
版本数
在 OpenClaw 中安装
/install openclaw-smart-search
功能描述
统一智能搜索技能,整合多个搜索引擎(百炼 MCP、Tavily、Serper、Exa、Firecrawl),自动选择最佳引擎并融合结果
安全使用建议
This skill mostly does what it claims (combines multiple search engines) but pay attention to key handling before installing:
- Metadata mismatch: the registry summary claims no required env vars but SKILL.md and code require OPENCLAW_MASTER_KEY. Treat OPENCLAW_MASTER_KEY as required.
- Inspect where the master key is stored: setup-wizard writes a .env inside the skill directory (./.env). That can expose the master key if the skill directory is not protected. Prefer to set OPENCLAW_MASTER_KEY in your user shell or a proper secret manager and do not leave .env in the repo.
- Review src/key-manager.ts before trusting automatic setup: ensure encryption is implemented correctly and that no code transmits keys to external endpoints. Verify the encrypted file (~/.openclaw/secrets/smart-search.json.enc) is created with 0o600 and that the code does not print keys or upload them.
- mcporter interaction: the Bailian setup will look for mcporter configs (including /etc paths) and will call mcporter. That is consistent with integrating Bailian but may read other local config files — only run if you expect mcporter integration.
- Avoid running setup scripts that auto-generate and write keys until you confirm where they write them and with what permissions. If you run setup, afterwards check file permissions (chmod 600) and remove any stray .env or unencrypted key files.
Recommended steps before installing:
1. Inspect src/key-manager.ts and setup scripts for any network calls that might send secrets off-host.
2. Set OPENCLAW_MASTER_KEY in your environment or a dedicated secret manager rather than relying on automatic .env writes.
3. After setup, verify ~/.openclaw/secrets/smart-search.json.enc exists and has 0o600 permissions.
4. If you don't use Bailian/mcporter, skip setup-bailian and only configure engines you trust. If anything seems unexpected, don't proceed and ask the maintainer to clarify the metadata and .env write behavior.
功能分析
Type: OpenClaw Skill
Name: openclaw-smart-search
Version: 1.0.14
The skill is a highly professional and security-conscious search aggregator. It implements robust defensive measures, including AES-256-GCM encryption for API keys with PBKDF2 key derivation (src/key-manager.ts), comprehensive input sanitization and injection detection (src/utils/sanitize.ts), and safe external process execution using spawn with shell:false (src/engines/bailian.ts). While scripts/quick-config.sh contains hardcoded API keys, these appear to be the author's own keys provided for testing/demo purposes rather than a mechanism to steal user data. All network traffic is directed to the official APIs of the integrated search services (e.g., api.tavily.com, api.exa.ai, google.serper.dev).
能力评估
Purpose & Capability
技能声明整合 5 个搜索引擎并使用 node + mcporter(用于百炼),代码包含多个引擎适配器和密钥管理模块 — 要求的二进制(node, mcporter)与描述匹配。异常点:注册表顶级元数据报告“Required env vars: none”,但 SKILL.md 和源码明确依赖 OPENCLAW_MASTER_KEY(用于加密密钥存储)。这种元数据不一致需要修正或说明。
Instruction Scope
SKILL.md 与脚本指导用户在本地生成并设置主密钥、将主密钥写入 .env(setup-wizard 将 .env 写入技能目录),并将 API Keys 加密存储到 ~/.openclaw/secrets/smart-search.json.enc。这些步骤本身与功能相关,但存在敏感操作(生成/写入主密钥、检测/读取 mcporter 配置路径、调用 mcporter 命令、写入本地加密文件)。尤其值得注意:setup-wizard 自动在技能目录写入 .env(可能暴露主密钥,取决于目录权限);setup-bailian 会尝试读取 mcporter 的配置路径(包括 /etc 路径),这会访问其他工具的配置文件。总体上指令范围接近功能,但在密钥存储/位置和对系统路径的读取上存在风险点。
Install Mechanism
安装说明仅通过 npm 安装 TypeScript 运行时/依赖(typescript, ts-node, @types/node, dotenv),没有从不受信任的外部 URL 下载可执行文件。相对低风险且与 Node.js 项目一致。
Credentials
技能需要一个主密钥(OPENCLAW_MASTER_KEY)用于 AES-256-GCM 加密,这是合理的。但注册表元数据未列出该 env var while SKILL.md 和脚本都依赖它 — 元数据不一致会误导用户。脚本/指南鼓励将主密钥写入 .env 或 shell 启动脚本;setup-wizard 会在技能目录生成并写入 .env 文件(潜在明文存储),且没有明确在写入时设置严格权限。这让主密钥可能被意外暴露。技能也会读取/检测多个 API KEY 环境变量(BAILIAN_API_KEY 等),这种行为与其功能相关且可接受。
Persistence & Privilege
技能未请求 always: true,并且只在用户显式安装/运行时活动。它写入自己的加密配置文件到 ~/.openclaw/secrets 和技能目录的 .env,但没有证据显示它修改其他技能或系统范围的代理配置。
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install openclaw-smart-search - 安装完成后,直接呼叫该 Skill 的名称或使用
/openclaw-smart-search触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.14
openclaw-smart-search 1.0.14
- Minor code maintenance: updates in router implementation (src/router.ts, dist/src/router.js).
- Updated dependency pins in package.json/package-lock.json.
- No functional or breaking changes to CLI or APIs.
- Documentation unaffected; usage remains the same.
v1.0.13
## openclaw-smart-search v1.0.13 Changelog
- Updated documentation in SKILL.md for improved clarity and structure.
- No functional or behavioral changes to the skill logic.
- Internal metadata and manifest files updated for consistency.
v1.0.12
openclaw-smart-search v1.0.12
- 增加 dotenv 依赖,支持自动从 .env 文件加载环境变量,不再需要手动 source。
- 更新安装命令与依赖说明,明确包含 dotenv。
- 文档新增对 .env 自动加载与 Shell 命令调用安全机制的详细说明。
- 加强对 OPENCLAW_MASTER_KEY 的自动读取说明,提升用户配置体验。
v1.0.11
openclaw-smart-search 1.0.11
- Added TypeScript definition files and built JS files to the `dist/` directory for all engines, scripts, and core modules.
- Introduced new management scripts: `doctor`, `import-keys`, `manage-keys`, `set-key`, and `setup-bailian`, making CLI operations more modular.
- Updated package scripts and internal references to use the new compiled/built files.
- General refactoring and preparation for improved distribution and CLI accessibility.
v1.0.10
openclaw-smart-search v1.0.10
- Added documentation and scripts for easier configuration and testing:
- New `CONFIG_AND_TEST.md` guide
- Added `scripts/quick-setup.sh` for quick setup
- Added `test-config.js` for configuration testing
- Updated `package.json` and `CHANGELOG.md` to reflect new files and setup aids
v1.0.9
openclaw-smart-search v1.0.9
- Updated type definitions and improved type safety in multiple source files.
- Enhanced internal routing and parameter parsing logic.
- Various internal code improvements and refactoring for clarity and maintainability.
- No changes to CLI usage or configuration; user experience remains the same.
v1.0.8
openclaw-smart-search v1.0.8
- Updated metadata and dependency versions in package.json and openclaw.plugin.json.
- Expanded and updated CHANGELOG.md.
- No user-facing feature or CLI/API changes in this release.
- Documentation (SKILL.md) unchanged.
v1.0.7
openclaw-smart-search v1.0.7
- Added openclaw.plugin.json for enhanced plugin metadata and integration.
- Expanded and clarified SKILL.md security documentation (安全说明), including setup examples and best-practice reminders for the master key.
- No functional or breaking changes; focuses on documentation and ecosystem compatibility improvements.
- Updated internal documentation and package metadata for alignment and clarity.
v1.0.6
- Added version-check.json for improved version management.
- Updated scripts/doctor.ts and src/router.ts for compatibility with new version checks.
- Bumped package version in package.json to 1.0.6.
- Minor updates to documentation and metadata.
v1.0.5
openclaw-smart-search v1.0.5
- 明确声明仅支持 CLI 调用,不提供 HTTP API。
- 丰富 CLI 用法说明,支持更多参数和搜索意图。
- 文档更新:全部 5 个搜索引擎均已实现,补充智能路由与降级机制描述。
- 移除 AGENTS.md 集成示例,聚焦 CLI 操作指引。
- 其他说明文案优化,细化参数、意图、兼容性与故障排查指引。
v1.0.4
openclaw-smart-search v1.0.4
- Added two new scripts: doctor.ts for environment checks and setup-bailian.ts for Bailian engine configuration.
- Improved and updated engine integration with changes in bailian.ts, exa.ts, firecrawl.ts, serper.ts, and tavily.ts.
- Enhanced package management and scripts in package.json.
- Updated documentation in README.md with new setup instructions and troubleshooting tips.
v1.0.3
openclaw-smart-search 1.0.3
- Added `CHANGELOG.md` file.
- Updated requirements: now declares dependency on both node.js and mcporter in skill metadata.
- Declared required environment variable `OPENCLAW_MASTER_KEY` in skill metadata.
- Improved encryption details and salt handling in documentation and metadata.
- Minor documentation updates and corrections for security and setup guidance.
v1.0.2
openclaw-smart-search v1.0.2
- Added detailed instructions and support for master key (OPENCLAW_MASTER_KEY) via environment variable or .env file for AES-256-GCM encryption.
- Expanded SKILL.md with a new “密钥管理” (key management) section, covering recommended security practices and encryption technical details.
- Added Jest testing config (jest.config.js).
- Various updates to code and documentation files to support new security requirements and clarify setup steps.
v1.0.1
Version 1.0.1
- Added input sanitization utility for enhanced security (`src/utils/sanitize.ts`)
- Improved command input validation and filtering to prevent command injection and unsafe characters
- Updated Bailian engine logic to apply stricter input checks
- SKILL.md updated: documents new security measures, lists input validation and best practices
- Minor package updates and internal refactoring
v1.0.0
Initial release of smart-search: unified intelligent search with multiple engines.
- Integrates Bailian MCP, Tavily, Serper, Exa, and Firecrawl search engines.
- Automatically selects the best engine and merges results.
- Provides guided, manual, and JSON import options for managing API keys.
- Includes encrypted key storage with AES-256-GCM and strong security practices.
- Offers command-line interface for searching, key management, and engine status checks.
- Supports major search intents: general, academic, technical, and news.
元数据
常见问题
Openclaw Smart Search 是什么?
统一智能搜索技能,整合多个搜索引擎(百炼 MCP、Tavily、Serper、Exa、Firecrawl),自动选择最佳引擎并融合结果. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 144 次。
如何安装 Openclaw Smart Search?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install openclaw-smart-search」即可一键安装,无需额外配置。
Openclaw Smart Search 是免费的吗?
是的,Openclaw Smart Search 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Openclaw Smart Search 支持哪些平台?
Openclaw Smart Search 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Openclaw Smart Search?
由 fdenny11gg(@fdenny11gg)开发并维护,当前版本 v1.0.14。
推荐 Skills