← Back to Skills Marketplace
fdenny11gg

Openclaw Smart Search

by fdenny11gg · GitHub ↗ · v1.0.14 · MIT-0
cross-platform ⚠ suspicious
144
Downloads
0
Stars
0
Active Installs
15
Versions
Install in OpenClaw
/install openclaw-smart-search
Description
统一智能搜索技能,整合多个搜索引擎(百炼 MCP、Tavily、Serper、Exa、Firecrawl),自动选择最佳引擎并融合结果
Usage Guidance
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.
Capability Analysis
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).
Capability Assessment
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,但没有证据显示它修改其他技能或系统范围的代理配置。
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-smart-search
  3. After installation, invoke the skill by name or use /openclaw-smart-search
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug openclaw-smart-search
Version 1.0.14
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 15
Frequently Asked Questions

What is Openclaw Smart Search?

统一智能搜索技能,整合多个搜索引擎(百炼 MCP、Tavily、Serper、Exa、Firecrawl),自动选择最佳引擎并融合结果. It is an AI Agent Skill for Claude Code / OpenClaw, with 144 downloads so far.

How do I install Openclaw Smart Search?

Run "/install openclaw-smart-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Openclaw Smart Search free?

Yes, Openclaw Smart Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Openclaw Smart Search support?

Openclaw Smart Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Openclaw Smart Search?

It is built and maintained by fdenny11gg (@fdenny11gg); the current version is v1.0.14.

💬 Comments