跳到主要内容OpenClaw Web Search 配置与渠道选择指南 | 极客日志编程语言Node.jsAI
OpenClaw Web Search 配置与渠道选择指南
OpenClaw Web Search 集成多种官方搜索渠道及第三方技能。涵盖 Brave、Gemini、Grok、Kimi、Perplexity 五大提供商的免费额度对比与配置方法。重点解析 Gemini 长期免费层优势及 Tavily 技能安装使用。提供从环境变量到配置文件的多套实施方案,帮助开发者快速搭建稳定可靠的 AI 搜索能力。
OpenClaw Web Search 配置与渠道选择指南
OpenClaw 提供了两种主要的搜索能力:内置的 web_search 工具支持 5 个官方搜索提供商,以及通过技能集成的第三方服务 Tavily。本文将详细介绍这些渠道的免费额度、配置方法及推荐方案,帮助你搭建最适合的搜索能力。
内置 web_search 支持的提供商
| Provider | 环境变量 | 特点 |
|---|
| Brave Search | BRAVE_API_KEY | 结构化结果 + 摘要 |
| Gemini | GEMINI_API_KEY | AI 合成答案 + 引用 |
| Grok | XAI_API_KEY | AI 合成答案 + 引用 |
| Kimi | KIMI_API_KEY / MOONSHOT_API_KEY | AI 合成答案 + 引用 |
| Perplexity | PERPLEXITY_API_KEY | 结构化结果 + 摘要 |
系统默认按 Brave → Gemini → Grok → Kimi → Perplexity 顺序自动检测可用渠道。
5 个官方搜索渠道详解
1. Brave Search API
免费额度
- ✅ 有免费额度(需绑卡)
- 每月赠送 $5 信用,约等于 1000 次搜索
- 超出部分开始扣费
获取方式
访问 Brave Search API 官网注册账号并绑定信用卡。注意需要在项目网站或 About 页明确标注'本项目使用 Brave Search API',满足归因要求后每月自动续期。
配置方法
{"tools":{"web":{"search":{"enabled":true,"provider":"brave","apiKey"
:
"YOUR_BRAVE_API_KEY"
}
}
}
}
export BRAVE_API_KEY="your_api_key"
注意事项
老版本的完全免费 Free Tier 已下线,现在是绑卡模式。务必遵守归因要求。
2. Google Gemini
- ✅ 有长期免费层(无需绑卡)
- Gemini 2.5 Pro/Flash/Flash-Lite 提供不同的 RPM 和请求限制
- 支持 Google Search Grounding,不额外收费
获取方式
访问 Google AI Studio,用 Google 账号登录后点击'Get API Key'即可生成,无需信用卡。
{"tools":{"web":{"search":{"enabled":true,"provider":"gemini","gemini":{"apiKey":"AIza...","model":"gemini-2.5-flash"}}}}}
export GEMINI_API_KEY="your_api_key"
优点
完全免费且稳定可靠,Google 官方长期支持,生成的答案带有引用来源。
3. Grok (xAI)
- ⚠️ 有促销信用(非长期 Free Tier)
- 新账号一次性送 $25 信用(30 天有效)
- 启用数据共享后,每月再送 $150 信用
获取方式
在 console.x.ai 注册账号,确认 Billing 页面是否有促销信用,并在 Settings → Data Sharing 中打开'Share API Inputs for Training'。
{"tools":{"web":{"search":{"enabled":true,"provider":"grok","grok":{"apiKey":"xai-..."}}}}}
export XAI_API_KEY="your_api_key"
注意事项
这属于促销活动,规则随时可能调整,不建议作为架构必须依赖的资源。
4. Kimi (Moonshot)
- ❌ 没有免费层
- 需先充值 ≥ $1 才能开通 API
- 累计充值到 $5,送 $5 代金券
获取方式
访问 Moonshot 平台注册账号并充值至少 $1 获取 API Key。
{"tools":{"web":{"search":{"enabled":true,"provider":"kimi","kimi":{"apiKey":"sk-..."}}}}}
export KIMI_API_KEY="your_api_key"
export MOONSHOT_API_KEY="your_api_key"
注意事项
API 不免费,Web/App 端的 Kimi 聊天免费但不适用于 OpenClaw API。
5. Perplexity
- ❌ 没有开发者免费层
- 终端用户免费层仅限网页/App 端,API 纯按量计费
获取方式
访问 Perplexity 设置页面生成 API Key。
{"tools":{"web":{"search":{"enabled":true,"provider":"perplexity","perplexity":{"apiKey":"pplx-..."}}}}}
export PERPLEXITY_API_KEY="your_api_key"
免费额度对比表
| 渠道 | 稳定 Free Tier? | 免费额度(开发者/API) | 获取方式 / 限制 |
|---|
| Brave Search | ✅ 有,但绑卡 | 每月 $5 credit ≈ 1000 次搜索 | 绑卡 + 站点注明使用 Brave API |
| Gemini API | ✅ 有,不绑卡 | 2.5 Pro/Flash/Flash-Lite,5–15 RPM + 100–1000 请求/天 | Google AI Studio 生成,无需信用卡 |
| Grok API | ⚠️ 有促销信用 | 新号 $25 + 数据共享每月 $150 credit | 注册后看 Billing;启用 Data Sharing |
| Kimi API | ❌ 没有 | 需先充值 ≥$1,累计 $5 送 $5 券 | 注册 Moonshot 平台并充值 |
| Perplexity API | ❌ 没有 | 文档中未声明开发者免费额度 | 网页/App 免费用;API 视为纯按量计费 |
推荐配置方案
方案 1:完全免费(推荐)⭐⭐⭐⭐⭐
主力:Gemini API(免费层)
适合个人开发者和小型项目,每天 500 次请求足够使用。
方案 2:免费 + 备用(推荐)⭐⭐⭐⭐
主力:Gemini API(免费层)
备用:Brave Search(每月 1000 次)
双重保障,避免单点故障,适合中型项目。
方案 3:促销信用(激进)⚠️
主力:Grok API(促销信用)
首月最高 $175 信用,但属于短期活动,仅适合测试尝鲜。
方案 4:付费(高频使用)💰
主力:Brave Search 或 Perplexity
适合企业级应用或高频搜索需求(>1000 次/月)。
Tavily Web Search 技能
除了内置工具,OpenClaw 还支持通过技能使用 Tavily 搜索服务,专为 AI 优化。
- 返回干净、相关的内容片段
- 注册即送 1000 次/月,无需绑卡
- 支持深度搜索 (
--deep) 和新闻搜索 (--topic news)
安装 Tavily 技能
优先使用 SkillHub(国内加速),或使用 ClawHub(兜底):
skillhub install tavily-search
clawhub install tavily-search
echo 'export TAVILY_API_KEY="tvly-..."' >> ~/.bashrc
source ~/.bashrc
node ~/.openclaw/skills/tavily-search/scripts/search.mjs "查询内容"
node ~/.openclaw/skills/tavily-search/scripts/search.mjs "查询内容" -n 10
node ~/.openclaw/skills/tavily-search/scripts/search.mjs "查询内容" --deep
配置步骤详解
方法 1:使用 openclaw configure(推荐)
openclaw configure --section web
方法 2:手动编辑配置文件
编辑 ~/.openclaw/openclaw.json,填入对应的 provider 和 apiKey。
方法 3:使用环境变量
编辑 ~/.openclaw/.env 或 ~/.bashrc,设置对应的大写环境变量名。
常见问题
Q: 哪个搜索提供商最好?
A: 取决于需求。完全免费选 Gemini,需要结构化结果选 Brave,AI 优化选 Tavily。
Q: 可以同时配置多个提供商吗?
A: 可以,但 OpenClaw 只会使用一个,按优先级自动检测。
Q: 如何切换搜索提供商?
A: 修改 tools.web.search.provider 配置,或删除当前 API Key 让系统自动检测下一个。
Q: 搜索结果缓存多久?
A: 默认 15 分钟,可通过 tools.web.search.cacheTtlMinutes 配置。
Q: 搜索失败怎么办?
A: 检查 API Key 是否正确、配额是否用完、网络是否正常,或查看 Gateway 日志。
总结
- 首选 Gemini:完全免费,稳定可靠,无需绑卡。
- 备用 Brave:每月 1000 次,需要绑卡。
- 尝鲜 Grok:促销信用,不稳定。
- 避免 Kimi/Perplexity:API 不免费。
- 获取 Gemini API Key。
- 配置 OpenClaw 环境变量。
- 重启 Gateway。
- 在 OpenClaw 中直接说:'搜索一下 OpenClaw'。
相关免费在线工具
- RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
- Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
- Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
- Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
- Markdown转HTML
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
- HTML转Markdown
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online