安全扫描
OpenClaw
可疑
medium confidence技能基本符合其宣传目的(支持多后端的国内友好搜索),但存在几个不匹配和草率/奇怪的问题代码(未声明的环境变量、一个意外的搜索端点,以及一个可能将空结果视为成功的逻辑错误)。
评估建议
安装/使用前需检查的事项:- 在确认端点之前,不要导出敏感的全局凭据。技能要求你设置 VOLC_SEARCH_API_KEY / TAVILY_API_KEY / SEARCHAPI_API_KEY,但注册表元数据并未声明它们——这种不一致很草率,可能会造成意外。- 检查并验证捆绑代码中的端点。volcengine 处理器向 https://open.feedcoopapi.com/search_api/web_search 发送请求,这不是显而易见的 volcengine 域名;在发送 API Key 之前请确认该主机是合法的。- 注意一个功能 bug:try_volcengine 在某些成功的 HTTP 响应上返回空列表,而主 search() 将任何非 None 返回值(包括空列表)视为成功。这可能导致技能报告成功但返回无结果。- 如果你计划使用 multi-search 回退,请单独查看或安装 multi_search_engine 包并检查其行为。- 优先创建专用的、最低权限的 API 密钥(不要重复使用高权限令牌)并先在沙箱环境中测试该技能。如果不确定,请要求发布者更新注册...详细分析 ▾
⚠ 用途与能力
技能的声明目的(聚合多个免费搜索 API)与代码和 SKILL.md 一致,但注册表元数据未列出所需的环境变量,而 README/SKILL.md 和代码需要多个 API 密钥。此外,volcengine 实现调用了一个意外的端点(open.feedcoopapi.com)而不是显而易见的 volcengine 域名,这一点未作解释。
⚠ 指令范围
SKILL.md 指令保持在声明的目的范围内(如何获取 API 密钥、GitHub 登录技巧、使用示例)。然而,指令未能在注册表元数据中声明所需的环境变量,且代码引用了未在注册表中声明的环境变量。没有步骤指示读取无关文件,但 GitHub 镜像建议指向第三方站点(githubs.cn)——并非固有恶意但值得注意。
✓ 安装机制
没有安装规范(仅指令安装),因此在安装时不会下载或执行任何内容。捆绑了一个 python 模块文件,代理在使用时会运行它;没有外部安装 URL 或解压步骤。
⚠ 凭证需求
根据 SKILL.md 和代码,技能需要 API 密钥(VOLC/TAVILY/SEARCHAPI),这对于搜索聚合器来说是相称的。问题是:注册表元数据未声明所需的环境变量(不一致)。此外,代码检查了 README 中未记录的替代环境变量名称(VOLCENGINE_SEARCH_API_KEY);在信任密钥之前应修复此不匹配问题。
✓ 持久化与权限
技能不请求持久或提升的权限(always: false,无配置路径,无系统级更改)。它导入一个可选的外部模块(multi_search_engine)作为回退,需要单独安装该模块。
安全有层次,运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/4/16
初始版本:整合四个免费搜索渠道,自动 fallback,国内不用翻墙也能稳定搜索
● Pending
安装命令
点击复制官方npx clawhub@latest install openclaw-china-search-tips
镜像加速npx clawhub@latest install openclaw-china-search-tips --registry https://cn.longxiaskill.com
技能文档
在中国大陆使用 OpenClaw 时,常常碰到网络问题、代理问题,没法正常联网搜索。这个技能整合了多种可用的免费搜索API,帮你不用翻墙也能稳定搜索。
整合渠道
| 渠道 | 免费额度 | 要求 | 特点 |
|---|---|---|---|
| volcengine-search | 500次/月 | 火山方舟套餐 | 官方支持,中文准,带AI总结 |
| tavily-search | 1000次/月 | GitHub登录 | AI原生搜索,结构化结果 |
| search-api | 1000次/月 | GitHub登录 | Google搜索结果,稳定 |
| multi-search-engine | 不限 | 免APIKey | 直接爬搜索引擎,当兜底 |
使用技巧
1. GitHub登录技巧
在中国大陆直接打开 GitHub 很卡,可以用这个办法:
1. 先打开 GitHub 中文社区 (https://www.githubs.cn/)
- 在中文社区登录你的GitHub账号
- 登录完直接打开 GitHub 官网,登录状态已经带过去了
- 再去 tavily/searchapi 官网选择 GitHub 登录,一次性成功
2. 搜索失败自动 fallback
代码已经封装好,一个渠道失败自动切下一个,不用你手动操作。
3. 不用命令行代理
只要你浏览器能上网,就能拿到 API Key,技能调用搜索API直接走域名,不需要命令行开代理。
安装要求
- 你需要手动申请各个渠道的 API Key(都是免费有额度)
- 配置环境变量即可使用
环境变量配置
export VOLC_SEARCH_API_KEY="..." # 火山引擎搜索
export TAVILY_API_KEY="..." # Tavily 搜索
export SEARCHAPI_API_KEY="..." # SearchAPI 搜索
使用示例
from china_search import search
# 自动搜索,自动 fallback results = search("你的问题") for r in results: print(r.title, r.url)
总结
核心经验:碰到问题不要一根筋走到黑,国内网络环境特殊,多准备几个渠道,一个不行就试下一个,总能搞定。
作者
整理:海绵宝宝 & 派大星 (OpenClaw 比奇堡团队)