Tavily Search API 在 Agent 框架中的跨層配置

Tavily 是什麼？

Tavily 是專為 AI Agent 設計的搜索 API，返回結構化結果而非 HTML 頁面列表。適合 Agent 直接消費。

• 🔗 tavily.com
• API Key 獲取：註冊後在 Dashboard 生成

在各框架中的角色

Hermes Agent 配置

背景搜集腳本

# ~/hermes/scripts/daily_briefing.py
from tavily import TavilyClient

tavily = TavilyClient(api_key="tvly-xxx")

topics = [
    "AI agent framework 2026",
    "LLM release this week",
    "open source AI trending",
    "DeepSeek latest update",
    "Qwen 3 new features"
]

for topic in topics:
    result = tavily.search(topic, max_results=5)
    print(f"## {topic}")
    for r in result['results']:
        print(f"- [{r['title']}]({r['url']})")

Hermes 定時任務

# ~/.hermes/config.yaml
cron:
  - schedule: "0 7 * * *"
    task: "python ~/hermes/scripts/daily_briefing.py"
    save_to: "~/.hermes/briefings/"

OpenClaw 配置

Skill 定義

OpenClaw 可將 Tavily 包裝為一個 Skill：

# ~/.openclaw/skills/tavily-search/SKILL.md
---
name: tavily-search
description: 用 Tavily API 搜索網路資訊
---

## 觸發
- "搜索" "查一下" "幫我找" "search for"
- 斜槓指令：/tavily

## 執行
調用 Tavily API 搜索指定關鍵詞，返回結構化結果。

API Key 配置

// ~/.openclaw/openclaw.json
{
  "skills": {
    "tavily-search": {
      "api_key": "tvly-xxx",
      "max_results": 5,
      "search_depth": "advanced"
    }
  }
}

Claude Code 配置

通過 OpenClaw 調用

Claude Code 不直接調用 Tavily，而是由 OpenClaw 的 Claude Code Bridge 傳遞搜索結果：

你 → OpenClaw：「搜索最新的 DeepSeek V4 benchmark」
OpenClaw → Tavily API → 拿到結果
OpenClaw → Claude Code Bridge → 「基於以下搜索結果生成分析...」
Claude Code → 生成報告 → 回傳 OpenClaw

Tavily API 參數說明

成本控制

Tavily 免費層每月 1000 次調用。建議：

• Hermes 每日搜集：用 basic 模式（30次/天）
• OpenClaw 即時搜索：用 advanced 模式（按需）
• 每月控制在 900 次以內

相關文章

• Brave Search API 配置
• Agent 框架能力矩陣