搜索配置
OpenClaw 联网搜索完整指南 — AI智能体搜索配置教程
本指南详细对比 Tavily、Brave Search、SearXNG、Perplexity 等搜索引擎方案, 手把手教你为 OpenClaw AI 智能体配置联网搜索能力,包括 API Key 获取、搜索技能安装、参数优化和常见问题排查。
为什么AI智能体需要联网搜索?
大语言模型(LLM)的训练数据有截止日期,无法获取最新信息。为 AI 智能体配置联网搜索能力后,它可以实时获取网络上的最新内容,大幅提升回答的准确性和实用性。联网搜索在以下场景中尤为重要:
- 实时信息查询 — 今日新闻、股票价格、天气预报、体育赛事比分等实时变化的数据,模型自身无法给出准确答案。联网搜索让 AI 可以即时获取最新信息。
- 事实核查与验证 — AI 模型有时会产生"幻觉"(Hallucination),编造不存在的事实。联网搜索可以帮助 AI 交叉验证信息,减少错误输出。
- 深度研究与调研 — 学术论文搜索、产品调研、竞品分析、技术文档查找等需要广泛信息检索的场景,联网搜索让 AI 成为高效的研究助手。
- 本地化信息 — 本地餐厅、附近活动、交通路况等基于地理位置的信息查询,只有联网搜索才能满足。
- 技术开发辅助 — 查找最新的 API 文档、第三方库版本、已知 Bug 和解决方案,帮助开发者快速定位问题。
搜索方案对比
OpenClaw 支持多种搜索引擎方案,每种都有各自的优势和适用场景。以下是主流方案的全面对比:
| 方案 | 费用 | 需要 API Key | 搜索质量 | 隐私保护 | 可自建 | 最适合 |
|---|---|---|---|---|---|---|
| 内置浏览器 | 免费 | 否 | 中等 | 一般 | 不适用 | 快速上手、零配置 |
| Tavily | 免费额度 + 付费 | 是 | 高(AI 优化) | 一般 | 否 | AI 智能体首选 |
| Brave Search | 免费额度 + 付费 | 是 | 高 | 强(隐私优先) | 否 | 注重隐私的用户 |
| SearXNG | 完全免费 | 否 | 高(聚合多引擎) | 极强(完全自控) | 是 | 自建部署、完全掌控 |
| Perplexity | 付费 | 是 | 极高(AI 原生) | 一般 | 否 | 追求最佳搜索质量 |
内置浏览器搜索(无需配置)
OpenClaw 内置了基础的网页浏览和搜索能力,无需任何额外配置即可使用。这是最简单的联网搜索方案,适合快速上手和轻度使用。
工作原理
内置浏览器搜索使用 OpenClaw 自带的 Web 浏览技能(Built-in Browser),AI 会通过搜索引擎查询关键词,获取搜索结果,并访问相关网页提取内容。整个过程对用户透明,AI 会自动判断何时需要搜索。
如何使用
内置浏览器搜索默认启用,无需修改任何配置。只需在对话中让 AI 搜索即可:
- 「帮我搜一下今天的科技新闻」
- 「查一下 Next.js 15 有哪些新特性」
- 「搜索一下特斯拉最新的股价」
优势与局限
- 优势:零配置、免费、开箱即用,适合日常简单搜索
- 局限:搜索深度有限、速度较慢(需要实际加载网页)、无法精确控制搜索参数、可能被搜索引擎限流
如果你需要更快速、更高质量的搜索结果,推荐配置专用的搜索 API(如 Tavily 或 Brave Search)。
Tavily 搜索配置
Tavily 是专为 AI 智能体设计的搜索 API,返回结果经过 AI 优化处理,直接提供与查询最相关的结构化内容。它是目前 AI Agent 生态中最受欢迎的搜索引擎之一。
第一步:注册 Tavily 账号并获取 API Key
- 访问 app.tavily.com,点击「Sign Up」注册账号
- 支持 Google 账号或邮箱注册
- 注册完成后进入 Dashboard,找到「API Key」区域
- 复制你的 API Key(格式如
tvly-xxxxxxxxxxxxxxxx) - 免费套餐每月提供 1,000 次搜索请求,个人使用足够
提示:Tavily 免费额度为每月 1,000 次请求。超出后需要升级到付费套餐($20/月起),或等到下月重置。
第二步:在 OpenClaw 中安装 Tavily 搜索技能
OpenClaw 通过技能(Skills)系统集成外部搜索引擎。安装 Tavily 搜索技能的方法如下:
- 打开 OpenClaw 配置文件
~/.openclaw/openclaw.json - 在
tools或skills区域添加 Tavily 搜索配置 - 配置示例如下:
{
"tools": {
"tavily_search": {
"enabled": true,
"apiKey": "tvly-xxxxxxxxxxxxxxxx"
}
}
}第三步:验证搜索是否生效
- 重启 OpenClaw 容器使配置生效:
docker restart your-openclaw-container
- 在对话中测试搜索功能:发送「帮我搜索一下今天的科技新闻」
- 如果 AI 返回了最新的搜索结果并标注了来源,说明 Tavily 搜索已成功配置
- 检查 OpenClaw 日志确认搜索调用正常:
docker logs your-openclaw-container | grep -i tavily
Tavily 搜索参数优化
Tavily 支持多种搜索参数,可以根据场景进行优化:
- search_depth —
"basic"(快速)或"advanced"(深度搜索,消耗 2 倍额度)。高质量需求建议用"advanced" - include_domains — 限制搜索范围到特定网站,例如
["github.com", "stackoverflow.com"] - exclude_domains — 排除特定网站的结果
- max_results — 返回结果数量(默认 5,最大 10)。更多结果 = 更全面但更慢
Brave Search 配置
Brave Search 是一个注重隐私的搜索引擎,拥有独立的搜索索引(不依赖 Google 或 Bing),API 响应速度快且结果质量高。
第一步:获取 Brave Search API Key
- 访问 brave.com/search/api
- 点击「Get Started」,注册 Brave Search API 账号
- 选择免费套餐(Free Plan)— 每月 2,000 次免费查询
- 在 Dashboard 中获取你的 API Key
- API Key 格式如
BSA-xxxxxxxxxxxxxxxx
第二步:配置 OpenClaw
在 OpenClaw 配置文件中添加 Brave Search:
{
"tools": {
"brave_search": {
"enabled": true,
"apiKey": "BSA-xxxxxxxxxxxxxxxx"
}
}
}- 将 API Key 替换为你从 Brave Dashboard 获取的实际密钥
- 保存配置文件,重启 OpenClaw 容器
- 发送测试消息验证搜索功能
Brave Search 的独特优势
- 独立索引 — Brave 有自己的搜索索引,不依赖 Google 或 Bing,搜索结果具有差异性
- 隐私保护 — 不追踪用户搜索行为,不收集个人数据,符合隐私优先原则
- 高免费额度 — 每月 2,000 次免费查询,比 Tavily 的 1,000 次更多
- 响应速度快 — API 延迟低,适合需要快速返回结果的场景
SearXNG 配置
SearXNG 是一个开源的元搜索引擎,可以聚合来自 Google、Bing、DuckDuckGo 等多个搜索引擎的结果。最大的优势是可以自建部署,完全掌控数据隐私。
第一步:部署 SearXNG 实例
SearXNG 需要自行部署,推荐使用 Docker 方式:
# 创建配置目录 mkdir -p /opt/searxng # 使用 Docker Compose 部署 docker run -d \ --name searxng \ -p 8080:8080 \ -v /opt/searxng:/etc/searxng \ -e SEARXNG_BASE_URL=http://localhost:8080/ \ searxng/searxng:latest
- 确认 SearXNG 已启动:访问
http://localhost:8080应看到搜索页面 - 在 SearXNG 配置中启用 JSON API 格式输出
- 如需外网访问,配置反向代理(如 Caddy 或 Nginx)并添加 HTTPS
第二步:在 OpenClaw 中配置 SearXNG
{
"tools": {
"searxng": {
"enabled": true,
"baseUrl": "http://localhost:8080"
}
}
}- 将
baseUrl替换为你的 SearXNG 实例地址 - 如果 SearXNG 和 OpenClaw 在同一台服务器,可以使用
http://localhost:8080 - 如果在不同服务器,使用 SearXNG 的公网地址(建议配置 HTTPS)
- 保存配置,重启 OpenClaw
SearXNG 的核心优势
- 完全免费 — 开源软件,不需要任何 API Key 或付费订阅
- 聚合搜索 — 同时从多个搜索引擎获取结果,覆盖面更广
- 完全隐私 — 自建部署意味着搜索数据不经过任何第三方,适合对隐私要求极高的场景
- 高度可定制 — 可以选择启用哪些搜索引擎、设置搜索类别、调整结果权重等
注意:SearXNG 需要自行维护服务器,且搜索质量依赖于上游搜索引擎。如果被上游引擎限流,搜索结果可能不稳定。适合有运维经验的用户。
如何选择搜索方案
根据你的需求和使用场景,以下是推荐的搜索方案选择指南:
按使用场景推荐
- 个人轻度使用 — 推荐内置浏览器搜索。零配置、免费,日常简单搜索完全够用。如果感觉搜索质量不够,再考虑升级到 Tavily。
- AI 智能体/Agent 开发 — 推荐 Tavily。专为 AI 优化的搜索结果,返回结构化数据,减少 Token 消耗。免费额度适合开发测试。
- 注重隐私 — 推荐 Brave Search 或 SearXNG。Brave 不追踪用户,SearXNG 完全自建,数据不经过第三方。
- 企业内部部署 — 推荐 SearXNG。完全自建、完全掌控,不依赖外部 API,适合对数据安全要求高的企业。
- 追求最佳搜索质量 — 推荐 Perplexity 或 Tavily Advanced。搜索结果经过深度 AI 处理,信息提取更精准。
按预算推荐
- 完全免费 — 内置浏览器搜索 或 SearXNG(需自建服务器)
- 小预算($0-20/月) — Tavily Free(1,000 次/月)或 Brave Free(2,000 次/月)
- 专业使用 — Tavily Pro($20/月起)或 Brave Paid(按量付费)
可以同时配置多个搜索引擎吗?
可以。OpenClaw 支持同时启用多个搜索工具。AI 会根据查询内容自动选择最合适的搜索引擎,或者你可以在提示词(System Prompt)中指定偏好的搜索引擎。例如:
{
"tools": {
"tavily_search": {
"enabled": true,
"apiKey": "tvly-xxx"
},
"brave_search": {
"enabled": true,
"apiKey": "BSA-xxx"
}
}
}常见问题(FAQ)
OpenClaw 需要搜索 API 吗?
不是必需的。OpenClaw 内置了基础的浏览器搜索能力,无需任何 API Key 即可进行网页搜索。 但如果你需要更快速、更高质量的搜索结果,推荐配置专用的搜索 API(如 Tavily 或 Brave Search)。 内置搜索适合轻度使用,专用 API 适合频繁搜索或对搜索质量有较高要求的场景。
哪个搜索引擎最好?
没有绝对最好的搜索引擎,取决于你的使用场景:
- 综合推荐:Tavily — 专为 AI 优化,搜索结果质量高,免费额度够用
- 隐私优先:Brave Search — 不追踪用户,独立索引
- 完全自控:SearXNG — 开源自建,数据完全私有
- 极致质量:Perplexity — AI 原生搜索,结果最精准
对于大多数用户,推荐从 Tavily 免费套餐开始,根据实际体验再决定是否需要切换或升级。
可以同时用多个搜索吗?
可以。OpenClaw 支持同时启用多个搜索引擎。配置多个搜索工具后,AI 会根据查询内容自动选择最合适的引擎, 也可以在提示词中设置搜索偏好和优先级。同时配置多个搜索引擎不会产生冲突,只有在实际执行搜索时才会消耗对应引擎的 API 额度。
内置搜索够用吗?
对于日常轻度搜索(偶尔查新闻、查天气、查简单信息),内置浏览器搜索完全够用,而且免费无需配置。 但如果你有以下需求,建议升级到专用搜索 API:
- 频繁搜索(每天数十次以上)
- 需要高质量的结构化搜索结果
- 对搜索速度有要求(内置搜索较慢)
- 需要精确控制搜索范围和参数
- 搜索结果需要包含来源引用