跳到主要内容
OpenClaw Web Search 工具配置与渠道详解 | 极客日志
Shell / Bash Node.js AI
OpenClaw Web Search 工具配置与渠道详解 OpenClaw Web Search 支持五种官方搜索渠道及 Tavily 技能。涵盖 Brave、Gemini、Grok、Kimi、Perplexity 的免费额度对比与配置方法。提供完全免费、备用组合及付费方案建议。包含环境变量设置、配置文件修改及常见问题解答，帮助用户快速搭建 AI 搜索能力。
OpenClaw Web Search 工具配置与渠道详解
OpenClaw 搜索功能概述
OpenClaw 提供两种搜索能力：
内置 web_search 工具 ：支持 5 个官方搜索提供商Tavily 技能 ：第三方搜索服务，专为 AI 优化
内置 web_search 支持的提供商
Provider 环境变量 特点 Brave Search BRAVE_API_KEY结构化结果 + 摘要 Gemini GEMINI_API_KEYAI 合成答案 + 引用 Grok XAI_API_KEYAI 合成答案 + 引用 Kimi KIMI_API_KEY / MOONSHOT_API_KEYAI 合成答案 + 引用 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 万 TPMGemini 2.5 Flash ：10 RPM、500 请求/天、25 万 TPMGemini 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"
注意事项
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 SearchAI 优化 ：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
随机西班牙地址生成器 随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online
Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
Markdown转HTML 将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
