跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

OpenClaw Web Search 配置与渠道选择指南

综述由AI生成OpenClaw 内置 web_search 工具支持 Brave、Gemini、Grok、Kimi、Perplexity 五个官方渠道及 Tavily 技能。文章对比了各渠道的免费额度、获取方式与配置方法，推荐以 Gemini 为主力免费方案，Brave 为备用。Tavily 技能适合需要深度搜索的场景。通过环境变量或配置文件即可快速启用，注意部分渠道需绑卡或充值。

RustyLab发布于 2026/4/10更新于 2026/5/2114 浏览

OpenClaw Web Search 配置与渠道选择指南

OpenClaw 提供两种搜索能力：

  1. 内置 web_search 工具：支持 5 个官方搜索提供商
  2. Tavily 技能：第三方搜索服务，专为 AI 优化
内置 web_search 支持的提供商
Provider环境变量特点
Brave SearchBRAVE_API_KEY结构化结果 + 摘要
GeminiGEMINI_API_KEYAI 合成答案 + 引用
GrokXAI_API_KEYAI 合成答案 + 引用
KimiKIMI_API_KEY / MOONSHOT_API_KEYAI 合成答案 + 引用
PerplexityPERPLEXITY_API_KEY结构化结果 + 摘要

自动检测顺序为：Brave → Gemini → Grok → Kimi → Perplexity。

5 个官方搜索渠道详解

1. Brave Search API
免费额度
  • ✅ 有免费额度（但需绑卡）
  • 额度：每个付费计划每月送 $5 信用 ≈ 1000 次搜索
  • 计费：$5 / 1000 次请求，超出开始扣费
获取方式
  1. 访问 brave.com/search/api
  2. 注册账号并绑定信用卡
  3. 在项目网站 / About 页明确标注"本项目使用 Brave Search API"
  4. 满足归因要求后，每月自动续 $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 搜索加持），不额外收费
获取方式
  1. 访问 Google AI Studio
  2. 用 Google 账号登录
  3. 点击 "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 官方长期支持
  • AI 合成答案，带引用来源
  • 支持 Google Search Grounding
3. Grok (xAI)
免费额度
  • ⚠️ 有促销信用（非长期 Free Tier）
  • 额度（截至 2026 年 1 月）：
    • 新账号一次性送 $25 信用（30 天有效）
    • 启用数据共享，每月再送 $150 信用
    • 合计首月最高 $175 信用
获取方式
  1. 访问 console.x.ai
  2. 注册 Grok API 账号
  3. 在 Billing 页面确认是否有 "Promotional Credits: $25"
  4. 在 Settings → Data Sharing 里打开 "Share API Inputs for Training"
  5. 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 翻倍）
    • 之后按量计费
获取方式
  1. 访问 platform.moonshot.cn
  2. 注册账号
  3. 充值至少 $1
  4. 获取 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
免费额度
  • ❌ 没有开发者免费层
  • 终端用户免费层（Standard）：
    • 无限次基础搜索（带实时网页、引用）
    • 少量 Pro Search 配额
    • 用完后需要 Pro/Max 订阅
获取方式
  1. 访问 perplexity.ai/settings/api
  2. 注册账号
  3. 生成 API Key
  4. 按量计费
配置方法
{"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：完全免费（推荐）⭐⭐⭐⭐⭐

主力：Gemini API（免费层）

{"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：促销信用（激进）⚠️

主力：Grok API（促销信用）

{"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，获取最新资讯
免费额度
  • 注册即送：1000 次/月
  • 无需绑卡
  • 长期有效
获取 API Key
  1. 访问 tavily.com
  2. 注册账号
  3. 在 Dashboard 生成 API Key
安装 Tavily 技能
# 优先使用 SkillHub（国内加速） skillhub install tavily-search # 或使用 ClawHub（兜底） clawhub install tavily-search
配置 API Key
# 添加到环境变量 echo 'export TAVILY_API_KEY="tvly-..."' >> ~/.bashrc source ~/.bashrc
使用方法
# 基本搜索（默认 5 条结果）node ~/.openclaw/skills/tavily-search/scripts/search.mjs "查询内容"
# 指定结果数量（最多 20 条）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（推荐）
# 配置 web_search openclaw configure --section web

按提示选择提供商并输入 API Key。

方法 2：手动编辑配置文件

编辑 ~/.openclaw/openclaw.json：

{"tools":{"web":{"search":{"enabled":true,"provider":"gemini","gemini":{"apiKey":"AIza..."}}}}}
方法 3：使用环境变量

编辑 ~/.openclaw/.env 或 ~/.bashrc：

# Brave export BRAVE_API_KEY="your_key"
# Gemini export GEMINI_API_KEY="your_key"
# Grok export XAI_API_KEY="your_key"
# Kimi export KIMI_API_KEY="your_key" # 或 export MOONSHOT_API_KEY="your_key"
# Perplexity export PERPLEXITY_API_KEY="your_key"
# Tavily export TAVILY_API_KEY="tvly-..."
重启 Gateway
openclaw gateway restart
测试搜索

在 OpenClaw 中直接说：

搜索一下 OpenClaw AI assistant

或使用 web_search 工具测试。

常见问题

Q1: 哪个搜索提供商最好？

A: 取决于你的需求：

  • 完全免费 + 稳定：Gemini（推荐）
  • 结构化结果：Brave Search
  • AI 优化：Tavily 技能
  • 促销信用：Grok（不稳定）
Q2: 可以同时配置多个提供商吗？

A: 可以，但 OpenClaw 只会使用一个（按优先级自动检测）。

Q3: 如何切换搜索提供商？

A: 修改 tools.web.search.provider 配置，或删除当前 API Key 让系统自动检测下一个。

Q4: Tavily 和内置 web_search 哪个好？

A:

  • Tavily：专为 AI 优化，免费 1000 次/月，适合大多数场景
  • 内置 web_search：集成度更高，但需要配置提供商
Q5: Gemini 免费层够用吗？

A: 对于个人开发者和小型项目，完全够用：

  • Gemini 2.5 Flash：500 请求/天 ≈ 15000 次/月
  • 远超 Brave 的 1000 次/月
Q6: Grok 的促销信用靠谱吗？

A: 不建议作为长期依赖：

  • 促销活动随时可能结束
  • 规则可能调整
  • 适合短期测试，不适合生产环境
Q7: 如何查看搜索配额使用情况？

A:

  • Brave：登录 brave.com/search/api 查看
  • Gemini：Google AI Studio 查看配额
  • Tavily：登录 tavily.com Dashboard
Q8: 搜索结果缓存多久？

A: 默认 15 分钟，可通过 tools.web.search.cacheTtlMinutes 配置。

Q9: 如何禁用搜索功能？

A: 设置 tools.web.search.enabled: false。

Q10: 搜索失败怎么办？

A: 检查：

  1. API Key 是否正确
  2. 配额是否用完
  3. 网络是否正常
  4. Gateway 日志：tail -f ~/.openclaw/logs/gateway.log

总结

最佳实践
  1. 首选 Gemini：完全免费，稳定可靠，无需绑卡
  2. 备用 Brave：每月 1000 次，需要绑卡
  3. 尝鲜 Grok：促销信用，不稳定
  4. 避免 Kimi/Perplexity：API 不免费
推荐配置

个人开发者：

主力：Gemini（免费） 备用：Tavily 技能（1000 次/月）

中型项目：

主力：Gemini（免费） 备用：Brave（1000 次/月）

企业级：

主力：Brave 或 Perplexity（付费） 备用：Gemini（免费）
快速开始
# 1. 获取 Gemini API Key# 访问 https://aistudio.google.com/apikey# 2. 配置 OpenClawexport GEMINI_API_KEY="AIza..."# 3. 重启 Gateway openclaw gateway restart # 4. 测试搜索# 在 OpenClaw 中说："搜索一下 OpenClaw"

参考资料

  • OpenClaw 官方文档 - Web Tools
  • Brave Search API
  • Google AI Studio
  • Grok API
  • Moonshot AI
  • Perplexity API
  • Tavily

目录

  1. OpenClaw Web Search 配置与渠道选择指南
  2. 内置 web_search 支持的提供商
  3. 5 个官方搜索渠道详解
  4. 1. Brave Search API
  5. 免费额度
  6. 获取方式
  7. 配置方法
  8. 注意事项
  9. 2. Google Gemini
  10. 免费额度
  11. 获取方式
  12. 配置方法
  13. 优点
  14. 3. Grok (xAI)
  15. 免费额度
  16. 获取方式
  17. 配置方法
  18. 注意事项
  19. 4. Kimi (Moonshot)
  20. 免费额度
  21. 获取方式
  22. 配置方法
  23. 注意事项
  24. 5. Perplexity
  25. 免费额度
  26. 获取方式
  27. 配置方法
  28. 注意事项
  29. 免费额度对比表
  30. 推荐配置方案
  31. 方案 1：完全免费（推荐）⭐⭐⭐⭐⭐
  32. 方案 2：免费 + 备用（推荐）⭐⭐⭐⭐
  33. 方案 3：促销信用（激进）⚠️
  34. 方案 4：付费（高频使用）💰
  35. Tavily Web Search 技能
  36. Tavily 优势
  37. 免费额度
  38. 获取 API Key
  39. 安装 Tavily 技能
  40. 优先使用 SkillHub（国内加速） skillhub install tavily-search # 或使用 ClawHub（兜底） clawhub install tavily-search
  41. 配置 API Key
  42. 添加到环境变量 echo 'export TAVILYAPIKEY="tvly-..."' >> ~/.bashrc source ~/.bashrc
  43. 使用方法
  44. 基本搜索（默认 5 条结果）node ~/.openclaw/skills/tavily-search/scripts/search.mjs "查询内容"
  45. 指定结果数量（最多 20 条）node ~/.openclaw/skills/tavily-search/scripts/search.mjs "查询内容" -n 10
  46. 深度研究搜索 node ~/.openclaw/skills/tavily-search/scripts/search.mjs "查询内容" --deep
  47. 新闻搜索 node ~/.openclaw/skills/tavily-search/scripts/search.mjs "查询内容" --topic news # 提取网页内容 node ~/.openclaw/skills/tavily-search/scripts/extract.mjs "https://example.com/article"
  48. Tavily vs 内置 web_search
  49. 配置步骤详解
  50. 方法 1：使用 openclaw configure（推荐）
  51. 配置 web_search openclaw configure --section web
  52. 方法 2：手动编辑配置文件
  53. 方法 3：使用环境变量
  54. Brave export BRAVEAPIKEY="your_key"
  55. Gemini export GEMINIAPIKEY="your_key"
  56. Grok export XAIAPIKEY="your_key"
  57. Kimi export KIMIAPIKEY="yourkey" # 或 export MOONSHOTAPIKEY="yourkey"
  58. Perplexity export PERPLEXITYAPIKEY="your_key"
  59. Tavily export TAVILYAPIKEY="tvly-..."
  60. 重启 Gateway
  61. 测试搜索
  62. 常见问题
  63. Q1: 哪个搜索提供商最好？
  64. Q2: 可以同时配置多个提供商吗？
  65. Q3: 如何切换搜索提供商？
  66. Q4: Tavily 和内置 web_search 哪个好？
  67. Q5: Gemini 免费层够用吗？
  68. Q6: Grok 的促销信用靠谱吗？
  69. Q7: 如何查看搜索配额使用情况？
  70. Q8: 搜索结果缓存多久？
  71. Q9: 如何禁用搜索功能？
  72. Q10: 搜索失败怎么办？
  73. 总结
  74. 最佳实践
  75. 推荐配置
  76. 快速开始
  77. 1. 获取 Gemini API Key# 访问 https://aistudio.google.com/apikey# 2. 配置 OpenClawexport GEMINIAPIKEY="AIza..."# 3. 重启 Gateway openclaw gateway restart # 4. 测试搜索# 在 OpenClaw 中说："搜索一下 OpenClaw"
  78. 参考资料
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • Python 属性描述符：原理与 ORM 实战
  • 鸿蒙 6.0 降级至 4.2 版本操作指南
  • C++ 内存布局、编译流程与关键字链接性
  • Python 中不易察觉的有趣事实与底层机制解析
  • 使用U盘离线部署GLM-4.6V-Flash-WEB视觉模型
  • JDK21虚拟线程（Virtual Threads）：轻量级并发的底层实现深度解析
  • SkyWalking Kafka 与 RabbitMQ 消息链路追踪实战
  • C++ 基础入门：开发环境配置与第一个程序
  • DeepSeek 深度使用指南：提示词技巧与本地知识库搭建
  • Java 中间件：RabbitMQ 消费端限流实战（basicQos 配置）
  • 前端异常捕获与统一格式化：从 console.log 到服务端上报
  • Scala 流程控制：分支与循环
  • C++ 核心语法解析：引用、内联函数与 nullptr
  • 2024 AI 大模型面试核心知识点与实战技巧
  • 在 Cursor 中配置 MCP 服务实现自动化开发
  • 使用 C++ 实现 2048 小游戏
  • Flutter 三方库 arcade 的鸿蒙化适配指南
  • 前端流式输出实现详解：从原理到实践
  • FPGA 板上基于 Simulink 与 ModelSim 联合仿真验证的 Buck 闭环设计及调试
  • FaceFusion 人脸融合算法详解：从对齐到渲染全过程

相关免费在线工具

  • 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