OpenClaw 升级搜索能力:轻松接入 Tavily,让你的个人 AI 助手更聪明、更精准

大家好,我是 Lyben,生活在新加坡的 AI 爱好者。最近 Brave Search API 免费额度大幅缩水或直接取消后,很多 OpenClaw 用户(包括我自己)都在寻找更好的 Web 搜索替代方案。幸运的是,社区很快推出了一个超级实用的插件:openclaw-tavily

这个插件直接把 Tavily Search API 集成进 OpenClaw,让你的 AI 助手能享受到专为 Agent/RAG 优化的搜索结果:更干净的结构化输出、AI 生成的摘要、页面提取、网站爬取,甚至深度研究报告。相比 Brave,它在减少幻觉、提升回答质量上明显更胜一筹,尤其适合日常研究、实时新闻、公司信息挖掘等场景。

下面我把接入过程完整整理成一篇实用指南(基于 2026 年 2 月最新社区实践和官方讨论),一步步教你搞定。

为什么选择 Tavily 替换 Brave?

  • Brave 的痛点:免费 tier 没了,付费门槛高,结果有时噪音多。
  • Tavily 的优势
    • 专为 LLM/Agent 设计,返回预处理的 snippet + 摘要,直接塞进 prompt 就行。
    • 提供 5 个强大工具:tavily_search(核心搜索)、tavily_extract(干净提取页面)、tavily_crawl(批量爬取)、tavily_map(发现站点所有链接)、tavily_research(多步深度研究)。
    • 免费每月 1000 credits 左右,日常够用。
    • 插件安装后,Agent 会自动优先调用 tavily_search,替换默认 Brave 搜索。

来源:OpenClaw GitHub Discussion #16248(插件作者亲述)。

前置准备

  1. 确保 OpenClaw 已安装并正常运行(官网:https://openclaw.ai/,GitHub:https://github.com/openclaw/openclaw)。
  2. 去 Tavily 官网注册免费 API Key:
    • 地址:https://app.tavily.com/
    • 登录后在 Dashboard 生成 key,格式类似 tvly-dev-xxx...tvly-xxx...

步骤一:安装 openclaw-tavily 插件(最推荐方式)

在终端运行一行命令:

openclaw plugins install openclaw-tavily
  • 如果 npm 源问题或想从源安装:
    git clone https://github.com/framix-team/openclaw-tavily.git ~/.openclaw/extensions/openclaw-tavily
    cd ~/.openclaw/extensions/openclaw-tavily
    npm install --omit=dev
    

插件地址:

  • GitHub:https://github.com/framix-team/openclaw-tavily
  • npm:https://www.npmjs.com/package/openclaw-tavily

步骤二:配置 Tavily API Key(两种方式,任选其一)

方式 1:环境变量(最简单、全局生效,强烈推荐)

# 临时设置(当前会话)
export TAVILY_API_KEY="tvly-dev-KKg9GqPfymlm5iJmfuPOsjRa6AxxxxmI"

# 永久设置(加到 shell 配置文件)
# bash 用户:
echo 'export TAVILY_API_KEY="你的key"' >> ~/.bashrc
source ~/.bashrc

# zsh 用户(macOS 常见):
echo 'export TAVILY_API_KEY="你的key"' >> ~/.zshrc
source ~/.zshrc

方式 2:手动编辑配置文件(如果环境变量不生效)

nano ~/.openclaw/openclaw.json

添加或修改 plugins 部分(结构参考插件 README):

{
  "plugins": {
    "entries": {
      "openclaw-tavily": {
        "enabled": true,
        "config": {
          "apiKey": "tvly-dev-KKg9GqPfymlm5iJmfuPOsjRa6AxxxxmI"
        }
      }
    }
  }
}

保存退出。

步骤三:重启并验证

openclaw restart

验证方法:

  • 在 OpenClaw 聊天界面问:“用 tavily 搜索新加坡今天的天气” 或 “用 tavily_search 查 Lyben 所在地的最新 AI 新闻”。
  • 如果返回带标题、URL、摘要的结构化结果,且提到 “Tavily” 或结果质量明显更干净 → 成功!

额外检查:

openclaw plugins list   # 确认 openclaw-tavily 在列表中
openclaw logs | grep -i tavily   # 查看日志是否有 key 加载成功

备选方式:通过 MCP 接入(适合想用 Tavily 官方 MCP)

openclaw mcp add --transport http --scope user tavily https://mcp.tavily.com/mcp/?tavilyApiKey=你的key

重启后 Agent 也能发现 Tavily 工具。

小结 & 建议

接入 Tavily 后,你的 OpenClaw 瞬间从“普通搜索”升级到“Agent 级智能搜索”。新加坡本地用延迟极低,结合 Telegram/WhatsApp 通道,随时随地让 AI 帮你查资料、写报告、挖信息,生产力直接拉满。

遇到问题?常见坑就是 key 没加载或没重启。可以去 OpenClaw GitHub Discussion #16248 留言,或贴日志出来大家一起 debug。

欢迎大家试用后分享体验!如果这篇文章帮到你,记得 star 下插件仓库支持作者~ 🦞

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐