跳到主要内容OpenClaw Web Search 配置与渠道全解析 | 极客日志JavaScriptNode.jsAI
OpenClaw Web Search 配置与渠道全解析
综述由AI生成OpenClaw Web Search 工具支持多种官方渠道及第三方技能，涵盖 Brave、Gemini、Grok 等五类提供商。文章对比了各方案的免费额度、配置步骤与适用场景，重点推荐 Gemini 作为主力免费方案，并详解 Tavily 技能安装方法，为个人及企业开发者提供清晰的选型建议与实操指引。
DebugKing8 浏览 OpenClaw Web Search 配置与渠道全解析
本文详细介绍 OpenClaw 内置 web_search 工具的官方搜索渠道，以及 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 次请求，超出开始扣费
获取方式
配置方法
{
"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"
注意事项
- 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
参考资料
更新日期：2026 年 3 月 14 日
OpenClaw 版本：2026.3.12+
相关免费在线工具
- RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
- Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
- 随机西班牙地址生成器
随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online
- Keycode 信息
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
- Escape 与 Native 编解码
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
- JavaScript / HTML 格式化
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
