簡介

Tavily 是一個(gè) web search API，可以讓你的 OpenClaw AI 助手具備搜索功能。本文介紹如何在 OpenClaw 中安裝和使用 Tavily。

準(zhǔn)備工作

OpenClaw 環(huán)境 - 已運(yùn)行的 OpenClaw 實(shí)例

Tavily 賬號(hào) - 訪問 tavily.com 注冊賬號(hào)

獲取 API Key - 注冊后在 dashboard 中獲取 API Key

安裝步驟

方式一：命令行安裝（推薦）

使用 clawhub 安裝 Tavily skill：

npx clawhub install tavily-tool

方式二：對(duì)話安裝

直接告訴 OpenClaw 想安裝的 skill 地址：

用戶：安裝這個(gè)skill https://clawhub.ai/arun-8687/tavily-search
OpenClaw：正在安裝 tavily-tool...
安裝完成！請?zhí)峁┠愕?Tavily API Key
用戶：tvly-dev-xxxxx
OpenClaw：已配置環(huán)境變量，重啟 Gateway 中...
完成！

配置 API Key

方法一：系統(tǒng)環(huán)境變量（推薦）

將 API Key 添加到系統(tǒng)環(huán)境變量：

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

方法二：OpenClaw secrets（不推薦，明文存儲(chǔ)）

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

重啟 Gateway

配置完環(huán)境變量后，需要重啟 OpenClaw Gateway 使其加載：

openclaw gateway restart

驗(yàn)證安裝

查看 skill 狀態(tài)：

openclaw skills list | grep -i tavily

或者直接測試搜索（需要先設(shè)置環(huán)境變量）：

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

使用方法

在 OpenClaw 中執(zhí)行搜索時(shí)，會(huì)自動(dòng)使用 tavily-tool skill。

常用參數(shù)

• --query, -q - 搜索關(guān)鍵詞
• --max_results, -n - 返回結(jié)果數(shù)量（默認(rèn) 5，最大 20）
• --urls-only - 只返回 URLs

故障排除

Q: 顯示 "Missing requirements: TAVILY_API_KEY"

確保：

• 環(huán)境變量已正確設(shè)置：echo $TAVILY_API_KEY
• Gateway 已重啟：openclaw gateway restart

Q: 搜索報(bào)錯(cuò) "Cannot convert argument to a ByteString"

這是 Node.js 22 內(nèi)置 fetch 的 bug。修復(fù)方法：編輯腳本使用 curl 代替 fetch：

# 腳本已自動(dòng)修復(fù)，或手動(dòng)替換為 curl 版本

Q: 速率限制

Tavily 免費(fèi)版有速率限制。如需更高配額，可升級(jí)付費(fèi)計(jì)劃。

注意事項(xiàng)

1.全局共享 - Skills 安裝在 ~/.openclaw/workspace/skills/，所有 agent 都可以使用

2.環(huán)境變量 - 建議使用系統(tǒng)環(huán)境變量，而非 OpenClaw secrets 文件

3.TOOLS.md - 可在 workspace 的 TOOLS.md 中記錄搜索配置

4.內(nèi)置搜索 vs Skill 搜索

• OpenClaw 自帶搜索功能（在 openclaw.json 中 tools.web.search.enabled），支持 Google/Bing 搜索，需要配置對(duì)應(yīng) API
• 我們使用 Tavily skill 搜索，所以關(guān)閉了內(nèi)置搜索（tools.web.search.enabled: false）
• 區(qū)別：內(nèi)置搜索是 OpenClaw 官方功能，Skill 搜索是第三方擴(kuò)展

相關(guān)文件

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

到此這篇關(guān)于OpenClaw中Tavily網(wǎng)絡(luò)搜索Skill的安裝配置教程的文章就介紹到這了,更多相關(guān)OpenClaw安裝Tavily Skill內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論