← 首页

搜索配置

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

  1. 访问 app.tavily.com,点击「Sign Up」注册账号
  2. 支持 Google 账号或邮箱注册
  3. 注册完成后进入 Dashboard,找到「API Key」区域
  4. 复制你的 API Key(格式如 tvly-xxxxxxxxxxxxxxxx
  5. 免费套餐每月提供 1,000 次搜索请求,个人使用足够

提示:Tavily 免费额度为每月 1,000 次请求。超出后需要升级到付费套餐($20/月起),或等到下月重置。

第二步:在 OpenClaw 中安装 Tavily 搜索技能

OpenClaw 通过技能(Skills)系统集成外部搜索引擎。安装 Tavily 搜索技能的方法如下:

  1. 打开 OpenClaw 配置文件 ~/.openclaw/openclaw.json
  2. toolsskills 区域添加 Tavily 搜索配置
  3. 配置示例如下:
{
  "tools": {
    "tavily_search": {
      "enabled": true,
      "apiKey": "tvly-xxxxxxxxxxxxxxxx"
    }
  }
}

第三步:验证搜索是否生效

  1. 重启 OpenClaw 容器使配置生效:
    docker restart your-openclaw-container
  2. 在对话中测试搜索功能:发送「帮我搜索一下今天的科技新闻」
  3. 如果 AI 返回了最新的搜索结果并标注了来源,说明 Tavily 搜索已成功配置
  4. 检查 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

  1. 访问 brave.com/search/api
  2. 点击「Get Started」,注册 Brave Search API 账号
  3. 选择免费套餐(Free Plan)— 每月 2,000 次免费查询
  4. 在 Dashboard 中获取你的 API Key
  5. API Key 格式如 BSA-xxxxxxxxxxxxxxxx

第二步:配置 OpenClaw

在 OpenClaw 配置文件中添加 Brave Search:

{
  "tools": {
    "brave_search": {
      "enabled": true,
      "apiKey": "BSA-xxxxxxxxxxxxxxxx"
    }
  }
}
  1. 将 API Key 替换为你从 Brave Dashboard 获取的实际密钥
  2. 保存配置文件,重启 OpenClaw 容器
  3. 发送测试消息验证搜索功能

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
  1. 确认 SearXNG 已启动:访问 http://localhost:8080 应看到搜索页面
  2. 在 SearXNG 配置中启用 JSON API 格式输出
  3. 如需外网访问,配置反向代理(如 Caddy 或 Nginx)并添加 HTTPS

第二步:在 OpenClaw 中配置 SearXNG

{
  "tools": {
    "searxng": {
      "enabled": true,
      "baseUrl": "http://localhost:8080"
    }
  }
}
  1. baseUrl 替换为你的 SearXNG 实例地址
  2. 如果 SearXNG 和 OpenClaw 在同一台服务器,可以使用 http://localhost:8080
  3. 如果在不同服务器,使用 SearXNG 的公网地址(建议配置 HTTPS)
  4. 保存配置,重启 OpenClaw

SearXNG 的核心优势

  • 完全免费 — 开源软件,不需要任何 API Key 或付费订阅
  • 聚合搜索 — 同时从多个搜索引擎获取结果,覆盖面更广
  • 完全隐私 — 自建部署意味着搜索数据不经过任何第三方,适合对隐私要求极高的场景
  • 高度可定制 — 可以选择启用哪些搜索引擎、设置搜索类别、调整结果权重等

注意:SearXNG 需要自行维护服务器,且搜索质量依赖于上游搜索引擎。如果被上游引擎限流,搜索结果可能不稳定。适合有运维经验的用户。

如何选择搜索方案

根据你的需求和使用场景,以下是推荐的搜索方案选择指南:

按使用场景推荐

  • 个人轻度使用 — 推荐内置浏览器搜索。零配置、免费,日常简单搜索完全够用。如果感觉搜索质量不够,再考虑升级到 Tavily。
  • AI 智能体/Agent 开发 — 推荐 Tavily。专为 AI 优化的搜索结果,返回结构化数据,减少 Token 消耗。免费额度适合开发测试。
  • 注重隐私 — 推荐 Brave SearchSearXNG。Brave 不追踪用户,SearXNG 完全自建,数据不经过第三方。
  • 企业内部部署 — 推荐 SearXNG。完全自建、完全掌控,不依赖外部 API,适合对数据安全要求高的企业。
  • 追求最佳搜索质量 — 推荐 PerplexityTavily 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:

  • 频繁搜索(每天数十次以上)
  • 需要高质量的结构化搜索结果
  • 对搜索速度有要求(内置搜索较慢)
  • 需要精确控制搜索范围和参数
  • 搜索结果需要包含来源引用

为你的AI智能体开启联网搜索

通过 OpenClaw Launch 可视化配置,一键部署带联网搜索能力的 AI 智能体。支持 Telegram / Discord / Web Chat 多平台。

开始部署