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

或者设置环境变量：

export BRAVE_API_KEY="your_api_key"

注意事项 老版本的完全免费 Free Tier 已下线，现在是绑卡模式。务必遵守归因要求。

2. Google Gemini

免费额度

• ✅ 有长期免费层（无需绑卡）
• Gemini 2.5 Pro/Flash/Flash-Lite 提供不同的 RPM 和请求限制
• 支持 Google Search Grounding，不额外收费

获取方式 访问 Google AI Studio，用 Google 账号登录后点击'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 官方长期支持，生成的答案带有引用来源。

3. Grok (xAI)

免费额度

• ⚠️ 有促销信用（非长期 Free Tier）
• 新账号一次性送 $25 信用（30 天有效）
• 启用数据共享后，每月再送 $150 信用

获取方式 在 console.x.ai 注册账号，确认 Billing 页面是否有促销信用，并在 Settings → Data Sharing 中打开'Share API Inputs for Training'。

配置方法

{"tools":{"web":{"search":{"enabled":true,"provider":"grok","grok":{"apiKey":"xai-..."}}}}}

环境变量：

export XAI_API_KEY="your_api_key"

注意事项 这属于促销活动，规则随时可能调整，不建议作为架构必须依赖的资源。

4. Kimi (Moonshot)

免费额度

• ❌ 没有免费层
• 需先充值 ≥ $1 才能开通 API
• 累计充值到 $5，送 $5 代金券

获取方式 访问 Moonshot 平台注册账号并充值至少 $1 获取 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

免费额度

• ❌ 没有开发者免费层
• 终端用户免费层仅限网页/App 端，API 纯按量计费

获取方式 访问 Perplexity 设置页面生成 API Key。

配置方法

{"tools":{"web":{"search":{"enabled":true,"provider":"perplexity","perplexity":{"apiKey":"pplx-..."}}}}}

环境变量：

export PERPLEXITY_API_KEY="your_api_key"

免费额度对比表

推荐配置方案

方案 1：完全免费（推荐）⭐⭐⭐⭐⭐

主力：Gemini API（免费层） 适合个人开发者和小型项目，每天 500 次请求足够使用。

方案 2：免费 + 备用（推荐）⭐⭐⭐⭐

主力：Gemini API（免费层） 备用：Brave Search（每月 1000 次） 双重保障，避免单点故障，适合中型项目。

方案 3：促销信用（激进）⚠️

主力：Grok API（促销信用） 首月最高 $175 信用，但属于短期活动，仅适合测试尝鲜。

方案 4：付费（高频使用）💰

主力：Brave Search 或 Perplexity 适合企业级应用或高频搜索需求（>1000 次/月）。

Tavily Web Search 技能

除了内置工具，OpenClaw 还支持通过技能使用 Tavily 搜索服务，专为 AI 优化。

优势

• 返回干净、相关的内容片段
• 注册即送 1000 次/月，无需绑卡
• 支持深度搜索 (--deep) 和新闻搜索 (--topic news)

安装 Tavily 技能 优先使用 SkillHub（国内加速），或使用 ClawHub（兜底）：

skillhub install tavily-search
# 或使用
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

配置步骤详解

方法 1：使用 openclaw configure（推荐）

openclaw configure --section web

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

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

编辑 ~/.openclaw/openclaw.json，填入对应的 provider 和 apiKey。

方法 3：使用环境变量

编辑 ~/.openclaw/.env 或 ~/.bashrc，设置对应的大写环境变量名。

配置完成后重启 Gateway：

openclaw gateway restart

常见问题

Q: 哪个搜索提供商最好？ A: 取决于需求。完全免费选 Gemini，需要结构化结果选 Brave，AI 优化选 Tavily。

Q: 可以同时配置多个提供商吗？ A: 可以，但 OpenClaw 只会使用一个，按优先级自动检测。

Q: 如何切换搜索提供商？ A: 修改 tools.web.search.provider 配置，或删除当前 API Key 让系统自动检测下一个。

Q: 搜索结果缓存多久？ A: 默认 15 分钟，可通过 tools.web.search.cacheTtlMinutes 配置。

Q: 搜索失败怎么办？ A: 检查 API Key 是否正确、配额是否用完、网络是否正常，或查看 Gateway 日志。

总结

最佳实践

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

快速开始

1. 获取 Gemini API Key。
2. 配置 OpenClaw 环境变量。
3. 重启 Gateway。
4. 在 OpenClaw 中直接说：'搜索一下 OpenClaw'。