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

或者设置环境变量：

export BRAVE_API_KEY="your_api_key"

注意事项

老的 Free tier（2k～5k 次/月）已下线，现在是绑卡模式。务必在网站上注明使用 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，不额外收费。

获取方式

去 Google AI Studio (aistudio.google.com/apikey)，用 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)

免费额度

属于促销信用，非长期承诺。新账号一次性送 $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 翻倍），之后按量计费。

获取方式

访问 platform.moonshot.cn/，注册账号，充值至少 $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

免费额度

没有开发者免费层。终端用户免费层（Standard）包含无限次基础搜索和少量 Pro Search 配额，用完后需要 Pro/Max 订阅。

获取方式

访问 perplexity.ai/settings/api，注册账号，生成 API Key，按量计费。

配置方法

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

或者设置环境变量：

export PERPLEXITY_API_KEY="your_api_key"

注意事项

API 纯按量计费，没有免费额度。网页/App 端免费用，但不适用于 OpenClaw 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

访问 tavily.com，注册账号，在 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

配置步骤详解

方法 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. 配置 OpenClaw
export 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

更新日期：2026 年 3 月 14 日 OpenClaw 版本：2026.3.12+