OpenClaw 内置 web_search 工具的 5 个官方渠道（Brave、Gemini、Grok、Kimi、Perplexity）及 Tavily 技能。对比免费额度与配置方式，推荐 Gemini 作为免费主力方案，并包含 Shell 环境变量与配置文件设置步骤。
本文详细介绍 OpenClaw 内置 web_search 工具的 5 个官方搜索渠道，以及 Tavily 技能的使用方法。帮助你选择最适合的免费/付费方案。
OpenClaw 提供两种搜索能力：
| 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
{"tools":{"web":{"search":{"enabled":true,"provider":"brave","apiKey":"YOUR_BRAVE_API_KEY"}}}}
或设置环境变量：
export BRAVE_API_KEY="your_api_key"
{"tools":{"web":{"search":{"enabled":true,"provider":"gemini","gemini":{"apiKey":"AIza...","model":"gemini-2.5-flash"}}}}}
或设置环境变量：
export GEMINI_API_KEY="your_api_key"
{"tools":{"web":{"search":{"enabled":true,"provider":"grok","grok":{"apiKey":"xai-..."}}}}}
或设置环境变量：
export XAI_API_KEY="your_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"
{"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 生成 API key，无需信用卡 |
| Grok API | ⚠️ 有促销信用 | 新号 $25 + 数据共享每月 $150 credit | 注册后看 Billing；启用 Data Sharing 才有 $150/月 |
| Kimi API | ❌ 没有 | 需先充值 ≥$1，累计 $5 送 $5 券 | 注册 Moonshot 平台并充值 |
| Perplexity API | ❌ 没有 | 文档中未声明开发者免费额度 | 网页/App 免费用；API 视为纯按量计费 |
主力：Gemini API（免费层）
{"tools":{"web":{"search":{"enabled":true,"provider":"gemini","gemini":{"apiKey":"AIza...","model":"gemini-2.5-flash"}}}}}
优点：
适合：个人开发者、小型项目
主力：Gemini API（免费层）
备用：Brave Search（每月 1000 次）
{"tools":{"web":{"search":{"enabled":true,"provider":"gemini","gemini":{"apiKey":"AIza..."}}}}}
优点：
适合：中型项目、需要高可用性
主力：Grok API（促销信用）
{"tools":{"web":{"search":{"enabled":true,"provider":"grok","grok":{"apiKey":"xai-..."}}}}}
优点：
缺点：
适合：短期测试、尝鲜
主力：Brave Search 或 Perplexity
适合：
除了内置的 web_search 工具，OpenClaw 还支持通过技能使用 Tavily 搜索服务。
--deep 模式，适合复杂研究--topic news，获取最新资讯# 优先使用 SkillHub（国内加速） skillhub install tavily-search # 或使用 ClawHub（兜底） clawhub install tavily-search
# 添加到环境变量 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 技能 | 内置 web_search |
|---|---|---|
| 免费额度 | 1000 次/月 | 取决于提供商 |
| 配置难度 | 简单（技能安装） | 需配置 provider |
| AI 优化 | ✅ 专为 AI 设计 | 取决于提供商 |
| 深度搜索 | ✅ 支持 --deep | 取决于提供商 |
| 新闻搜索 | ✅ 支持 --topic news | 取决于提供商 |
| 调用方式 | 技能脚本 | 内置工具 |
# 配置 web_search openclaw configure --section web
按提示选择提供商并输入 API Key。
编辑 ~/.openclaw/openclaw.json：
{"tools":{"web":{"search":{"enabled":true,"provider":"gemini","gemini":{"apiKey":"AIza..."}}}}}
编辑 ~/.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-..."
openclaw gateway restart
在 OpenClaw 中直接说：
搜索一下 OpenClaw AI assistant
或使用 web_search 工具测试。
A: 取决于你的需求：
A: 可以，但 OpenClaw 只会使用一个（按优先级自动检测）。
A: 修改 tools.web.search.provider 配置，或删除当前 API Key 让系统自动检测下一个。
A:
A: 对于个人开发者和小型项目，完全够用：
A: 不建议作为长期依赖：
A:
A: 默认 15 分钟，可通过 tools.web.search.cacheTtlMinutes 配置。
A: 设置 tools.web.search.enabled: false。
A: 检查：
tail -f ~/.openclaw/logs/gateway.log个人开发者：
主力：Gemini（免费） 备用：Tavily 技能（1000 次/月）
中型项目：
主力：Gemini（免费） 备用：Brave（1000 次/月）
企业级：
主力：Brave 或 Perplexity（付费） 备用：Gemini（免费）
# 1. 获取 Gemini API Key # 访问 https://aistudio.google.com/apikey # 2. 配置 OpenClaw export GEMINI_API_KEY="AIza..." # 3. 重启 Gateway openclaw gateway restart # 4. 测试搜索 # 在 OpenClaw 中说："搜索一下 OpenClaw"
更新日期：2026 年 3 月 14 日
OpenClaw 版本：2026.3.12+
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online