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. 如果主題不是近期事件，嘗試從新聞模式切換到一般模式。