OpenClaw Web Search 完全指南（2026年3月最新）

优质文章学习记录

08 Apr 2026 — 9 min read

OpenClaw Web Search 完全指南（2026年3月最新）

本文详细介绍 OpenClaw 内置 web_search 工具的 5 个官方搜索渠道，以及 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 次请求，超出开始扣费

获取方式

访问 brave.com/search/api
注册账号并绑定信用卡
在项目网站 / About 页明确标注"本项目使用 Brave Search API"
满足归因要求后，每月自动续 $5 信用

配置方法

{"tools":{"web":{"search":{"enabled":true,"provider":"brave","apiKey":"YOUR_BRAVE_API_KEY"}}}}

或设置环境变量：

exportBRAVE_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 搜索加持），不额外收费

获取方式

访问 Google AI Studio
用 Google 账号登录
点击 “Get API Key”，无需绑卡直接生成

配置方法

{"tools":{"web":{"search":{"enabled":true,"provider":"gemini","gemini":{"apiKey":"AIza...","model":"gemini-2.5-flash"}}}}}

或设置环境变量：

exportGEMINI_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-..."}}}}}

或设置环境变量：

exportXAI_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-..."}}}}}

或设置环境变量：

exportKIMI_API_KEY="your_api_key"# 或exportMOONSHOT_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-..."}}}}}

或设置环境变量：

exportPERPLEXITY_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 视为纯按量计费

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 "查询内容"-n10# 深度研究搜索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：

# BraveexportBRAVE_API_KEY="your_key"# GeminiexportGEMINI_API_KEY="your_key"# GrokexportXAI_API_KEY="your_key"# KimiexportKIMI_API_KEY="your_key"# 或exportMOONSHOT_API_KEY="your_key"# PerplexityexportPERPLEXITY_API_KEY="your_key"# TavilyexportTAVILY_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 哪个好？

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

Q5: Gemini 免费层够用吗？

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

Gemini 2.5 Flash：500 请求/天 ≈ 15000 次/月
远超 Brave 的 1000 次/月

Q6: Grok 的促销信用靠谱吗？

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

促销活动随时可能结束
规则可能调整
适合短期测试，不适合生产环境

Q7: 如何查看搜索配额使用情况？

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: 检查：

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

总结

最佳实践

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

快速开始

# 1. 获取 Gemini API Key# 访问 https://aistudio.google.com/apikey# 2. 配置 OpenClawexportGEMINI_API_KEY="AIza..."# 3. 重启 Gateway openclaw gateway restart # 4. 测试搜索# 在 OpenClaw 中说："搜索一下 OpenClaw"

参考资料

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

如果本文对你有帮助，欢迎点赞、收藏、关注！有问题欢迎评论区讨论。