OpenClaw中Tavily网络搜索Skill的安装配置教程

目录

• 简介
• 准备工作
• 安装步骤
• 方式一：命令行安装（推荐）
• 方式二：对话安装
• 配置 API Key
• 重启 Gateway
• 验证安装
• 使用方法
• 故障排除
• 注意事项
• 相关文件

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

OpenClaw 环境 – 已运行的 OpenClaw 实例

Tavily 账号 – 访问 tavily.com 注册账号

获取 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 中…
完成！

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

将 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

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

openclaw gateway restart

查看 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"

确保：

• 环境变量已正确设置：echo $TAVILY_API_KEY
• 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

到此这篇关于OpenClaw中Tavily网络搜索Skill的安装配置教程的文章就介绍到这了,更多相关OpenClaw安装Tavily Skill内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！