OpenClaw Tavily Web Search 技能指南

OpenClaw Tavily Web Search 技能概覽

Tavily Web Search 技能將 OpenClaw 連接到 Tavily Search API，這是一款專為 AI 智慧體和 LLM 應用程式打造的 AI 最佳化搜尋引擎。與傳統搜尋 API 僅回傳原始連結不同，Tavily 會分析多個來源並回傳結構化、高相關性的內容，讓你的 OpenClaw 智慧體可以立即使用。

Tavily 為超過 100 萬名開發者提供搜尋服務，每月處理超過 1 億次請求。它獲得 OpenAI、Anthropic、LangChain 及其他頂尖 AI 平台的信賴。憑藉 SOC 2 認證、零資料保留政策和內建的提示注入防護機制，它是賦予智慧體網路存取能力最安全的方式之一。

典型工作流程：

1. 向 OpenClaw 提出需要最新資訊的問題。
2. 智慧體使用最佳化的查詢呼叫 Tavily API。
3. Tavily 搜尋網路、從多個來源擷取相關內容，並在 2 秒內回傳附帶引用來源的結構化摘要。

此技能非常適合研究任務、事實查核、時事查詢，以及任何需要存取訓練資料以外資訊的工作流程。它與 Brave Search 技能（用於注重隱私的查詢）以及 DeepWiki 技能（用於儲存庫文件研究）搭配使用效果極佳。

Tavily Web Search 技能安裝前的準備

安裝 Tavily Web Search 技能之前，請確保你具備以下條件：

• OpenClaw 已安裝並執行（v1.0+）
• Tavily API 金鑰 — 前往 tavily.com 註冊（免費方案包含每月 1,000 點額度）
• clawhub CLI 已安裝用於技能管理

驗證你的環境：

# 檢查 OpenClaw 版本
openclaw --version

# 確認 Tavily API 金鑰已設定
echo $TAVILY_API_KEY

無需安裝額外軟體。該技能透過 Tavily 的雲端 API 進行通訊，除了 OpenClaw 本身之外沒有其他本地相依項目。

如何安裝 Tavily Web Search 技能

使用一條命令安裝 Tavily Web Search 技能：

npx clawhub@latest install tavily-web-search

驗證安裝：

clawhub list

你應該能在已安裝技能列表中看到 tavily-web-search。

Tavily Web Search 技能配置指南

該技能需要 Tavily API 金鑰進行身份驗證。你可以在 app.tavily.com 取得免費金鑰。

API 金鑰設定

# 將 Tavily API 金鑰設定為環境變數
export TAVILY_API_KEY=tvly-your-api-key-here

若要永久保存此設定，請將 export 行新增至你的 shell 設定檔（~/.bashrc、~/.zshrc 或同等檔案）。

搜尋模式

該技能支援兩種搜尋深度和兩種主題模式，你可以依需求自由組合：

| 模式 | 速度 | 涵蓋範圍 | 最適合用途 | |------|------|----------|-----------| | 基本 | 1-2 秒 | 良好 | 快速查詢事實、簡單查找 | | 進階 | 5-10 秒 | 優異 | 複雜研究、全面性回答 |

| 主題 | 範圍 | 最適合用途 | |------|------|-----------| | 一般 | 所有時間的網路內容 | 長青主題、文件、教學 | | 新聞 | 最近 7 天、新聞來源 | 時事、突發新聞、市場動態 |

智慧體會根據你的查詢自動選擇適當的模式，但你可以在提示中指定「進行深度搜尋」或「搜尋最新新聞」來覆寫此設定。

重要提示： 切勿將 API 金鑰硬編碼到設定檔中或提交到版本控制。請使用環境變數或如 1Password 等金鑰管理工具。

Tavily Web Search 技能使用範例

1. 快速事實查詢

你： "Next.js 最新穩定版本是什麼？"

智慧體執行基本 Tavily 搜尋，從官方來源擷取版本號碼，並回傳附帶 Next.js 發行說明連結的簡潔回答。

2. 深入研究

你： "比較伺服器端渲染與靜態網站生成在電商網站上的優缺點。"

智慧體執行進階搜尋，彙整來自多篇部落格文章、文件頁面和案例研究的見解，並回傳附帶每項要點引用來源的結構化比較。

3. 時事與新聞

你： "這週 AI 產業發生了什麼大事？"

智慧體切換至新聞模式，搜尋最近 7 天的內容，並回傳附帶原始文章連結的熱門 AI 新聞摘要。

4. 特定網域研究

你： "僅從 MDN 和 TypeScript 文件中搜尋如何使用模板字面量型別。"

智慧體使用網域篩選功能，僅納入 developer.mozilla.org 和 typescriptlang.org，確保結果完全來自權威來源。

5. 內容擷取

你： "擷取 Tavily API 定價頁面的完整內容並摘要各方案層級。"

智慧體使用原始內容擷取功能取得完整頁面內容，然後產出每個定價層級的結構化分析，包含功能與限制。

安全與最佳實踐

使用 Tavily Web Search 技能時，請遵循以下指南：

• 保護你的 API 金鑰。 將金鑰儲存在環境變數或金鑰管理工具中。切勿在聊天紀錄中分享、提交到 Git 或在客戶端程式碼中暴露金鑰。
• 將搜尋結果視為不受信任的輸入。 網路內容可能包含不準確、過時或被操控的資訊。在採取行動前，務必從多個來源驗證關鍵事實。參閱安全檢查清單了解通用指導。
• 監控你的使用量。 免費方案每月提供 1,000 點額度。每次基本搜尋消耗 1 點額度，進階搜尋消耗 2 點額度。前往 app.tavily.com 查看使用量，避免意外超額。
• 對敏感查詢使用網域篩選。 當準確性至關重要時，使用包含網域篩選器將結果限制在受信任的網域（官方文件、政府網站、知名出版物）。
• 注意速率限制。 避免在迴圈中快速連續發送查詢。該技能會優雅地處理速率限制，但過多的請求可能會暫時限制你的存取。

常見錯誤與故障排除

"Invalid API key"

你的 Tavily API 金鑰遺失、格式錯誤或已過期。

1. 驗證金鑰是否已設定：echo $TAVILY_API_KEY
2. 確保金鑰以 tvly- 開頭——Tavily 的金鑰始終使用此前綴。
3. 如果金鑰正確但仍然失敗，請前往 app.tavily.com 產生新金鑰。

"Rate limit exceeded"

你已超過方案層級的請求限制。

1. 前往 app.tavily.com 查看目前使用量。
2. 如果使用免費方案，請等到下個月 1 日的每月重置。
3. 考慮升級到付費方案以獲得更高限額，或在不需要進階模式的情況下最佳化查詢以使用基本模式。

"No results found"

查詢未回傳任何符合的結果。這種情況可能發生在非常小眾或高度特定的搜尋中。

1. 擴大搜尋範圍——移除過於特定的篩選條件。
2. 如果使用網域篩選，請確認目標網域確實包含相關內容。
3. 如果主題不是近期事件，嘗試從新聞模式切換到一般模式。