📦 OpenClaw China Search Tips — 国内联网搜索整合

v1.0.0

OpenClaw 国内联网搜索整合技能,整合多种免代理免费搜索API,帮你在国内不用翻墙也能稳定联网搜索。

0· 17·0 当前·0 累计
gki38511 头像by @gki38511 (GKi38511)·MIT-0
下载技能包
License
MIT-0
最后更新
2026/4/16
0
安全扫描
VirusTotal
Pending
查看报告
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)作为回退,需要单独安装该模块。
安全有层次,运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发,无需署名。

运行时依赖

无特殊依赖

版本

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-search500次/月火山方舟套餐官方支持,中文准,带AI总结
tavily-search1000次/月GitHub登录AI原生搜索,结构化结果
search-api1000次/月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 比奇堡团队)

数据来源ClawHub ↗ · 中文优化:龙虾技能库