OpenClaw 安装 Tavily Plugin 完整教程 — 让 AI 智能体拥有网页搜索能力

什么是 Tavily Plugin？

Tavily 是一个面向 AI Agent 的搜索 API。和 Google、Bing 这种面向人类用户的搜索不同，Tavily 直接返回结构化的、可被大模型理解的搜索结果（标题 + 摘要 + 原文片段 + 来源链接），并自动过滤广告和低质量页面。这意味着 AI 在调用 Tavily 之后，几乎不需要再额外清洗就能引用结果回答问题。

在 OpenClaw 里，Tavily 主要有两种使用方式：

• Tavily Plugin（内置 Skill） — OpenClaw 自带的 web_search 插件，把 Tavily 作为搜索 provider，开箱即用。
• Tavily MCP Server — 通过 Model Context Protocol 接入，作为独立进程运行，隔离性更好，也可以和 Claude Desktop、Cursor 共用同一份配置。

第一步：获取 Tavily API Key

1. 访问 tavily.com，使用邮箱或 Google 账号注册。
2. 登录后进入控制台（Dashboard），在「API Keys」页面会看到一个以 tvly- 开头的密钥。
3. 复制这个 Key，妥善保存 — 后面的所有配置都要用到它。
4. 免费套餐每月提供 1,000 次搜索，对个人 AI 助手来说完全够用；超出后可以按量付费或升级套餐。

如果你在国内访问 tavily.com 比较慢，可以先按 OpenClaw 代理设置教程 给容器配好代理再注册。

方式一：通过 OpenClaw Launch 一键启用（推荐）

如果你使用 OpenClaw Launch 托管版，整个过程是零配置的：

1. 登录 openclawlaunch.com/dashboard。
2. 进入实例设置，找到「Web Search」或「网页搜索」开关。
3. 把刚才的 Tavily API Key 粘贴进去，保存。
4. 几秒后配置热加载完成，无需重启实例。直接在 Telegram、WeChat、Discord 等任何已接入的频道里问 AI「帮我搜一下今天的科技新闻」即可验证。

托管版的好处是不需要碰 JSON、不需要管 npm、不需要考虑 npm 镜像和墙的问题 — 这也是 养龙虾教程 推荐新手优先选托管的原因。

方式二：自建 Docker 用户 — 配置 Tavily Plugin

如果你按 Docker 自建教程 自行部署了 OpenClaw，编辑 ~/.openclaw/openclaw.json，在 plugins.entries 里启用 web_search：

{
  "plugins": {
    "entries": {
      "web_search": {
        "enabled": true,
        "config": {
          "provider": "tavily",
          "apiKey": "tvly-你的-api-key",
          "maxResults": 5,
          "timeoutMs": 15000
        }
      }
    }
  }
}

保存后执行 docker restart openclaw，启动日志中出现 web_search ready (provider=tavily) 就说明已经生效。

Windows 用户特别说明

Windows 用户最常见的搜索是「windows openclaw 设置 tavily web search」。Windows 下 OpenClaw 通常通过 Docker Desktop 运行，配置文件实际位于 WSL2 文件系统中。可以通过：

• 在 PowerShell 里运行 docker exec -it openclaw cat /home/node/.openclaw/openclaw.json 查看当前配置；
• 通过 docker cp openclaw:/home/node/.openclaw/openclaw.json . 把配置拉到本地编辑，再 docker cp openclaw.json openclaw:/home/node/.openclaw/ 推回去；
• 或者直接用 VS Code 的 WSL 扩展打开 \\\\wsl$\\docker-desktop-data\\... 路径下的配置文件。

修改完同样需要 docker restart openclaw。Windows 下 OpenClaw 完整教程 里有更详细的目录路径说明。

方式三：MCP 免安装方式接入 Tavily

如果你已经在用 MCP 生态（Claude Desktop、Cursor、Windsurf 等），可以直接把 Tavily 作为 MCP Server 接入 OpenClaw — 不需要单独安装 Plugin，npx 会按需拉取：

{
  "tools": {
    "mcp": [
      {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@anthropic/mcp-server-tavily"],
        "env": {
          "TAVILY_API_KEY": "tvly-你的-api-key"
        }
      }
    ]
  }
}

这种方式的好处是：

• 免安装 — npx 会在第一次启动时自动下载 @anthropic/mcp-server-tavily，后续缓存复用；
• 独立进程 — Tavily 工具崩溃不会影响 OpenClaw 主进程；
• 跨平台复用 — 同一份 MCP 配置可以同时被 OpenClaw、Claude Desktop、Cursor 使用，API Key 只配一份。

更多 MCP 用法见 OpenClaw MCP 配置指南。

超时与重试设置

「openclaw tavily 超时」「openclaw 为什么开了代理连接 gemini 也超时」是两个常见痛点。Tavily 默认请求超时是 10 秒，对于挂代理或网络较差的场景可能不够，建议显式调大：

{
  "plugins": {
    "entries": {
      "web_search": {
        "enabled": true,
        "config": {
          "provider": "tavily",
          "apiKey": "tvly-...",
          "timeoutMs": 30000,
          "retries": 2,
          "retryDelayMs": 1500
        }
      }
    }
  }
}

如果你是通过代理访问 tavily.com，记得给容器同时设置 HTTPS_PROXY 环境变量；或者按 OpenClaw 代理设置教程 在配置文件里统一设置 network.proxy，让 Tavily 调用走代理。

验证 Tavily 是否生效

配置完成后，用以下任一方法验证：

• 在任何已接入的频道里问：「帮我搜一下今天关于 OpenClaw 的最新新闻」 — AI 应该会调用 web_search 并在回答里给出带链接的来源。
• 查看容器日志：docker logs openclaw --tail 200 | grep tavily — 应该能看到搜索请求和耗时。
• 在 OpenClaw Launch 实例详情页查看 Skills 调用记录，可以直接看到每次 Tavily 调用的输入、输出和耗时。

常见报错排查

报错：401 Unauthorized / Invalid API key

99% 的概率是 API Key 复制错了，或者前后多了空格 / 引号。请重新到 tavily.com 控制台复制一次，确认是 tvly- 开头的纯字符串。

报错：ECONNRESET / ETIMEDOUT

容器无法访问 tavily.com。如果在国内或公司内网，需要给 OpenClaw 配代理。详见 OpenClaw 代理设置教程 中的「让插件走代理」一节 — 注意必须设置 HTTPS_PROXY，单独设 HTTP_PROXY 对 https 请求是无效的。

报错：429 Too Many Requests

Tavily 免费套餐月度配额（1,000 次）用完了。可以登录 Tavily 控制台查看本月用量，要么等下个月重置，要么升级到付费套餐。

AI 不主动调用 Tavily

这通常是模型问题，不是 Tavily 问题。Claude / GPT / DeepSeek 这类大模型会主动调用 web_search；但部分小模型（如 Gemma、本地 7B 模型）不擅长工具调用，需要在 prompt 里明确写「需要联网信息时请使用 web_search 工具」。

插件已启用，但 AI 说自己不能联网

检查 plugins.entries.web_search.enabled 是不是 true，并确保 OpenClaw 已经重启过一次（Plugin 启用属于需要重启的配置项，不会热加载）。

Tavily vs 其他搜索方案

• Tavily — 结构化结果、AI 友好，免费 1000 次/月。综合最推荐。
• Brave Search — 注重隐私，免费额度大，但摘要质量略逊于 Tavily。
• SerpAPI / Serper — 直接代理 Google 结果，灵活但需要自己处理结构化。
• OpenClaw 内置 web_search（默认 provider） — 不配 API Key 时使用的 fallback，速度和质量都一般，仅适合临时测试。

下一步

装好 Tavily 之后，建议继续阅读：

• OpenClaw MCP 配置指南 — 给 AI 加上文件、数据库、浏览器等更多工具
• Skills 使用指南 — 了解 OpenClaw 自带的 3,200+ 内置 Skills
• 代理设置教程 — 让所有插件包括 Tavily 都能稳定走代理