OpenClaw网络搜索Tavily Search Skill 安装教程

简介

Tavily 是一个 web search API，可以让你的 OpenClaw AI 助手具备搜索功能。本文介绍如何在 OpenClaw 中安装和使用 Tavily。

准备工作

1. OpenClaw 环境 - 已运行的 OpenClaw 实例
2. Tavily 账号 - 访问 tavily.com 注册账号
3. 获取 API Key - 注册后在 dashboard 中获取 API Key

安装步骤

方式一：命令行安装（推荐）

使用 clawhub 安装 Tavily skill：

npx clawhub install tavily-tool

方式二：对话安装

直接告诉 OpenClaw 想安装的 skill 地址：

用户：安装这个skill https://clawhub.ai/arun-8687/tavily-search
OpenClaw：正在安装 tavily-tool...
安装完成！请提供你的 Tavily API Key
用户：tvly-dev-xxxxx
OpenClaw：已配置环境变量，重启 Gateway 中...
完成！

2. 配置 API Key

方法一：系统环境变量（推荐）

将 API Key 添加到系统环境变量：

# 添加到 ~/.bashrc
echo 'export TAVILY_API_KEY="你的APIKey"' >> ~/.bashrc
source ~/.bashrc

方法二：OpenClaw secrets（不推荐，明文存储）

mkdir -p ~/.openclaw/secrets
echo '你的APIKey' > ~/.openclaw/secrets/TAVILY_API_KEY.txt
openclaw secrets reload

3. 重启 Gateway

配置完环境变量后，需要重启 OpenClaw Gateway 使其加载：

openclaw gateway restart

4. 验证安装

查看 skill 状态：

openclaw skills list | grep -i tavily

或者直接测试搜索（需要先设置环境变量）：

source ~/.bashrc
node ~/.openclaw/workspace/skills/tavily-tool/scripts/tavily_search.js -q "测试搜索" --max_results 3

使用方法

在 OpenClaw 中执行搜索时，会自动使用 tavily-tool skill。

常用参数

• --query, -q - 搜索关键词
• --max_results, -n - 返回结果数量（默认 5，最大 20）
• --urls-only - 只返回 URLs

故障排除

Q: 显示 "Missing requirements: TAVILY_API_KEY"

确保：

1. 环境变量已正确设置：echo $TAVILY_API_KEY
2. Gateway 已重启：openclaw gateway restart

Q: 搜索报错 "Cannot convert argument to a ByteString"

这是 Node.js 22 内置 fetch 的 bug。修复方法：编辑脚本使用 curl 代替 fetch：

# 脚本已自动修复，或手动替换为 curl 版本

Q: 速率限制

Tavily 免费版有速率限制。如需更高配额，可升级付费计划。

注意事项

1. 全局共享 - Skills 安装在 ~/.openclaw/workspace/skills/，所有 agent 都可以使用
2. 环境变量 - 建议使用系统环境变量，而非 OpenClaw secrets 文件
3. TOOLS.md - 可在 workspace 的 TOOLS.md 中记录搜索配置
4. 内置搜索 vs Skill 搜索
   • OpenClaw 自带搜索功能（在 openclaw.json 中 tools.web.search.enabled），支持 Google/Bing 搜索，需要配置对应 API
   • 我们使用 Tavily skill 搜索，所以关闭了内置搜索（tools.web.search.enabled: false）
   • 区别：内置搜索是 OpenClaw 官方功能，Skill 搜索是第三方扩展

相关文件

• Skill 位置：~/.openclaw/workspace/skills/tavily-tool/
• Skill 文档：~/.openclaw/workspace/skills/tavily-tool/SKILL.md
• OpenClaw 配置：~/.openclaw/openclaw.json