OpenClaw 接入 Tavily 搜索：从踩坑到跑通

今晚在跟 AI 搭档讨论网站方案时，让它去搜市面上前五名的 AI Agent 实战指南网站，结果返回一句 web_search is disabled or no provider is available.。

原来 OpenClaw 装完默认没配搜索 API，搜不了。刚好借这次机会把 Tavily 接进来。

为什么选 Tavily 不选 Kimi

OpenClaw 官方推荐两个搜索 provider：

对比维度	Tavily	Kimi
免费额度	每月 1000 次基础搜索	无免费额度
计费	失败不收费	0.03 元/次 + Token 费
国际内容	强	一般
中文内容	良好	优秀

我要调研的是国际站点为主（Anthropic、LangChain、Latent.Space 这些），Tavily 更合适。而且 1000 次免费额度对个人开发者一个月够用了。

结论：国际内容为主选 Tavily，纯中文场景选 Kimi。

完整配置流程

去 https://app.tavily.com 注册拿一个 API Key（tvly- 前缀）。

然后在终端跑：

# 1. 安装 Tavily 插件（重要，先装再配）
openclaw plugins install @openclaw/tavily-plugin

# 2. 启用插件
openclaw config set plugins.entries.tavily.enabled true

# 3. 写入 API Key
openclaw config set plugins.entries.tavily.config.webSearch.apiKey tvly-你的key

# 4. 重启 gateway 让配置生效
openclaw gateway restart

验证：

openclaw config get plugins.entries.tavily.config.webSearch.apiKey
# 输出 __OPENCLAW_REDACTED__ 就说明存进去了（Key 加密显示）

我踩到的两个坑

坑 1：配置顺序反了会警告

我第一次是先跑 config set 再装插件，结果一直报：

plugins.entries.tavily: plugin not installed: tavily

虽然配置能保存，但插件没装，重启也没用。正确顺序是先装插件再配 Key，反过来虽然不致命但看着糟心。

坑 2：重启 gateway 会杀掉当前会话

openclaw gateway restart 会 SIGTERM 当前的 agent 进程。如果你在网页/客户端等 Agent 回复，重启完之后要主动发一条消息（比如“继续”）唤醒会话。

这是设计如此，不是 bug。

验证搜索能力

配好后跑一下：

# 在 Agent 里直接触发搜索
"帮我搜一下 AI Agent 前五名实战指南网站"

Tavily 会返回 title / url / snippet 结构化数据，比 Kimi 更适合让 LLM 二次处理。

一点感受

搜索能力这种东西以前觉得是“背景服务”，配好就行。但当你实际在给 AI 搭档配的时候会发现：搜索质量直接决定 Agent 输出的天花板。

用 Google 搜出来的第一屏和用 Tavily 搜出来的第一屏，给 LLM 看到的信息可能完全不同。Tavily 会做一层 rerank，让相关的内容排前面，token 效率更高。

这个洞察值得单独写一篇《Agent 时代的搜索选型》。先记一笔，改天再展开。

---

📖 想看更多 AI Agent 实战干货？

访问「小曹的智能体手册」官网：www.cn-aiagent.com

OpenClaw + CodeX + Claude Code，手把手教你玩转 AI Agent