跳到主要内容OpenClaw Web Search 工具配置与渠道选择指南 | 极客日志JavaScriptNode.jsAI
OpenClaw Web Search 工具配置与渠道选择指南
OpenClaw 内置 web_search 支持 Brave、Gemini、Grok、Kimi、Perplexity 五家渠道,另提供 Tavily 技能。Gemini 免费层稳定且无需绑卡,适合个人开发者;Brave 需绑卡但额度充足;Grok 促销信用不稳定。配置可通过环境变量或 openclaw configure 命令完成,建议优先选用 Gemini 作为主力搜索源,配合 Tavily 技能增强 AI 优化能力。
ArchDesign0 浏览 OpenClaw Web Search 工具配置与渠道选择指南
本文详细介绍 OpenClaw 内置 web_search 工具的 5 个官方搜索渠道,以及 Tavily 技能的使用方法。帮助你选择最适合的免费或付费方案。
OpenClaw 搜索功能概述
OpenClaw 提供两种搜索能力:
- 内置 web_search 工具:支持 5 个官方搜索提供商
- Tavily 技能:第三方搜索服务,专为 AI 优化
内置 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 次搜索
- 计费:$5 / 1000 次请求,超出开始扣费
获取方式
- 访问 brave.com/search/api
- 注册账号并绑定信用卡
- 在项目网站 / About 页明确标注'本项目使用 Brave Search API'
- 满足归因要求后,每月自动续 $5 信用
配置方法
{"tools":{"web":{"search":{
"enabled"
:
true
,
"provider"
:
"brave"
,
"apiKey"
:
"YOUR_BRAVE_API_KEY"
}
}
}
}
export BRAVE_API_KEY="your_api_key"
- 老的'2k~5k 次/月完全免费'Free tier 已下线
- 现在是'绑卡 + 每月 $5 ≈ 1000 次免费'模式
- 需要在网站上注明使用 Brave API(归因要求)
2. Google Gemini
- ✅ 有长期免费层(无需绑卡)
- 额度(2026 年 2 月最新):
- Gemini 2.5 Pro:5 RPM、100 请求/天、25 万 TPM
- Gemini 2.5 Flash:10 RPM、500 请求/天、25 万 TPM
- Gemini 2.5 Flash-Lite:15 RPM、1000 请求/天、25 万 TPM
- 支持:Google Search Grounding(web 搜索加持),不额外收费
{"tools":{"web":{"search":{"enabled":true,"provider":"gemini","gemini":{"apiKey":"AIza...","model":"gemini-2.5-flash"}}}}}
export GEMINI_API_KEY="your_api_key"
- 完全免费,无需绑卡
- 稳定可靠,Google 官方长期支持
- AI 合成答案,带引用来源
- 支持 Google Search Grounding
3. Grok (xAI)
- ⚠️ 有促销信用(非长期 Free Tier)
- 额度(截至 2026 年 1 月):
- 新账号一次性送 $25 信用(30 天有效)
- 启用数据共享,每月再送 $150 信用
- 合计首月最高 $175 信用
- 访问 console.x.ai
- 注册 Grok API 账号
- 在 Billing 页面确认是否有'Promotional Credits: $25'
- 在 Settings → Data Sharing 里打开'Share API Inputs for Training'
- 24 小时内到账每月 $150 credit
{"tools":{"web":{"search":{"enabled":true,"provider":"grok","grok":{"apiKey":"xai-..."}}}}}
export XAI_API_KEY="your_api_key"
- 不是长期承诺的 Free Tier,属于促销活动
- 规则随时可能调整
- 建议当成'能拿到算赚到',不要作为架构必须依赖的资源
4. Kimi (Moonshot)
- ❌ 没有免费层
- 计费:
- 需先充值 ≥ $1 才能开通 API
- 累计充值到 $5,送 $5 代金券(首 $5 翻倍)
- 之后按量计费
{"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
- ❌ 没有开发者免费层
- 终端用户免费层(Standard):
- 无限次基础搜索(带实时网页、引用)
- 少量 Pro Search 配额
- 用完后需要 Pro/Max 订阅
{"tools":{"web":{"search":{"enabled":true,"provider":"perplexity","perplexity":{"apiKey":"pplx-..."}}}}}
export PERPLEXITY_API_KEY="your_api_key"
- API 纯按量计费,没有免费额度
- 网页/App 端免费用,但不适用于 OpenClaw API
免费额度对比表
| 渠道 | 稳定 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 生成 API key,无需信用卡 |
| Grok API | ⚠️ 有促销信用 | 新号 $25 + 数据共享每月 $150 credit | 注册后看 Billing;启用 Data Sharing 才有 $150/月 |
| Kimi API | ❌ 没有 | 需先充值 ≥$1,累计 $5 送 $5 券 | 注册 Moonshot 平台并充值 |
| Perplexity API | ❌ 没有 | 文档中未声明开发者免费额度 | 网页/App 免费用;API 视为纯按量计费 |
推荐配置方案
方案 1:完全免费(推荐)⭐⭐⭐⭐⭐
{"tools":{"web":{"search":{"enabled":true,"provider":"gemini","gemini":{"apiKey":"AIza...","model":"gemini-2.5-flash"}}}}}
- 完全免费,无需绑卡
- 稳定可靠,Google 官方支持
- AI 合成答案,带引用来源
- 每天 500 次请求(Flash 模型)
方案 2:免费 + 备用(推荐)⭐⭐⭐⭐
主力:Gemini API(免费层)
备用:Brave Search(每月 1000 次)
{"tools":{"web":{"search":{"enabled":true,"provider":"gemini","gemini":{"apiKey":"AIza..."}}}}}
- Gemini 作为主力,完全免费
- Brave 作为备用,每月 1000 次
- 双重保障,避免单点故障
方案 3:促销信用(激进)⚠️
{"tools":{"web":{"search":{"enabled":true,"provider":"grok","grok":{"apiKey":"xai-..."}}}}}
- 首月最高 $175 信用
- 数据共享每月 $150 credit
- 促销活动,随时可能结束
- 不稳定,不建议作为长期依赖
方案 4:付费(高频使用)💰
主力:Brave Search 或 Perplexity
- 企业级应用
- 高频搜索需求(>1000 次/月)
- 需要稳定 SLA
Tavily Web Search 技能
除了内置的 web_search 工具,OpenClaw 还支持通过技能使用 Tavily 搜索服务。
Tavily 优势
- 专为 AI 优化:返回干净、相关的内容片段
- 免费额度:注册即送 1000 次/月
- 深度搜索:支持
--deep 模式,适合复杂研究
- 新闻搜索:支持
--topic news,获取最新资讯
免费额度
获取 API Key
安装 Tavily 技能
skillhub install tavily-search
clawhub install tavily-search
配置 API Key
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
node ~/.openclaw/skills/tavily-search/scripts/search.mjs "查询内容" --topic news
node ~/.openclaw/skills/tavily-search/scripts/extract.mjs "https://example.com/article"
Tavily vs 内置 web_search
| 维度 | Tavily 技能 | 内置 web_search |
|---|
| 免费额度 | 1000 次/月 | 取决于提供商 |
| 配置难度 | 简单(技能安装) | 需配置 provider |
| AI 优化 | ✅ 专为 AI 设计 | 取决于提供商 |
| 深度搜索 | ✅ 支持 --deep | 取决于提供商 |
| 新闻搜索 | ✅ 支持 --topic news | 取决于提供商 |
| 调用方式 | 技能脚本 | 内置工具 |
配置步骤详解
方法 1:使用 openclaw configure(推荐)
openclaw configure --section web
方法 2:手动编辑配置文件
编辑 ~/.openclaw/openclaw.json:
{"tools":{"web":{"search":{"enabled":true,"provider":"gemini","gemini":{"apiKey":"AIza..."}}}}}
方法 3:使用环境变量
编辑 ~/.openclaw/.env 或 ~/.bashrc:
export BRAVE_API_KEY="your_key"
export GEMINI_API_KEY="your_key"
export XAI_API_KEY="your_key"
export KIMI_API_KEY="your_key"
export MOONSHOT_API_KEY="your_key"
export PERPLEXITY_API_KEY="your_key"
export TAVILY_API_KEY="tvly-..."
重启 Gateway
测试搜索
搜索一下 OpenClaw AI assistant
常见问题
Q1: 哪个搜索提供商最好?
- 完全免费 + 稳定:Gemini(推荐)
- 结构化结果:Brave Search
- AI 优化:Tavily 技能
- 促销信用:Grok(不稳定)
Q2: 可以同时配置多个提供商吗?
A: 可以,但 OpenClaw 只会使用一个(按优先级自动检测)。
Q3: 如何切换搜索提供商?
A: 修改 tools.web.search.provider 配置,或删除当前 API Key 让系统自动检测下一个。
Q4: Tavily 和内置 web_search 哪个好?
- Tavily:专为 AI 优化,免费 1000 次/月,适合大多数场景
- 内置 web_search:集成度更高,但需要配置提供商
Q5: Gemini 免费层够用吗?
- Gemini 2.5 Flash:500 请求/天 ≈ 15000 次/月
- 远超 Brave 的 1000 次/月
Q6: Grok 的促销信用靠谱吗?
- 促销活动随时可能结束
- 规则可能调整
- 适合短期测试,不适合生产环境
Q7: 如何查看搜索配额使用情况?
Q8: 搜索结果缓存多久?
A: 默认 15 分钟,可通过 tools.web.search.cacheTtlMinutes 配置。
Q9: 如何禁用搜索功能?
A: 设置 tools.web.search.enabled: false。
Q10: 搜索失败怎么办?
- API Key 是否正确
- 配额是否用完
- 网络是否正常
- Gateway 日志:
tail -f ~/.openclaw/logs/gateway.log
总结
最佳实践
- 首选 Gemini:完全免费,稳定可靠,无需绑卡
- 备用 Brave:每月 1000 次,需要绑卡
- 尝鲜 Grok:促销信用,不稳定
- 避免 Kimi/Perplexity:API 不免费
推荐配置
个人开发者:
主力:Gemini(免费) 备用:Tavily 技能(1000 次/月)
中型项目:
主力:Gemini(免费) 备用:Brave(1000 次/月)
企业级:
主力:Brave 或 Perplexity(付费) 备用:Gemini(免费)
快速开始
export GEMINI_API_KEY="AIza..."
openclaw gateway restart
参考资料
相关免费在线工具
- RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
- Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
- Keycode 信息
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
- Escape 与 Native 编解码
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
- JavaScript / HTML 格式化
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
- JavaScript 压缩与混淆
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online