優(yōu)先級 1：Tavily       → 高質(zhì)量結(jié)構(gòu)化結(jié)果，1000 次/月，日常主力
優(yōu)先級 2：SearXNG + Jina → 免費無限次，兜底 / 批量搜索場景
優(yōu)先級 3：Bocha         → 600+ 次余額，應(yīng)急備用

npm_config_registry=https://registry.npmjs.org npx clawhub@latest search tavily

openclaw-tavily-search  Tavily 搜索  (3.707)
tavily-tool             Tavily       (3.603)
liang-tavily-search     Tavily Search (3.522)
tavily-web-search-for-openclaw  Tavily Web Search Skill for OpenClaw ??  (3.505)

npm_config_registry=https://registry.npmjs.org npx clawhub@latest install openclaw-tavily-search

openclaw skills list | grep -i tavily
# 預(yù)期輸出：
# ? ready │ ?? tavily-search │ Web search via Tavily API (alternative to Brave)...

mkdir -p ~/.openclaw/skills/tavily-search/scripts
# 從 GitHub 下載（如果你的服務(wù)器能訪問 GitHub）
curl -sL <https://raw.githubusercontent.com/openclaw/skills/main/skills/arun-8687/tavily-search/SKILL.md> \\
  -o ~/.openclaw/skills/tavily-search/SKILL.md
# 確認(rèn)下載成功
cat ~/.openclaw/skills/tavily-search/SKILL.md | head -20

cat > ~/.openclaw/skills/tavily-search/SKILL.md << 'EOF'
---
name: tavily
description: AI-optimized web search via Tavily API. Returns concise, relevant results for AI agents.
homepage: <https://tavily.com>
metadata: {"clawdbot":{"emoji":"??","requires":{"bins":["node"],"env":["TAVILY_API_KEY"]},"primaryEnv":"TAVILY_API_KEY"}}
---
# Tavily Search
AI-optimized web search using Tavily API. Designed for AI agents - returns clean, relevant content.
## Search
`bash
node {baseDir}/scripts/search.mjs "query"
node {baseDir}/scripts/search.mjs "query" -n 10
node {baseDir}/scripts/search.mjs "query" --deep
node {baseDir}/scripts/search.mjs "query" --topic news
`
EOF

cat > ~/.openclaw/skills/tavily-search/scripts/search.mjs << 'EOF'
#!/usr/bin/env node
import https from "https";
const API_KEY = process.env.TAVILY_API_KEY;
if (!API_KEY) {
  console.error("Error: TAVILY_API_KEY environment variable is not set.");
  process.exit(1);
}
const args = process.argv.slice(2);
let query = "";
let maxResults = 5;
let searchDepth = "basic";
let topic = "general";
for (let i = 0; i < args.length; i++) {
  if (args[i] === "-n" && args[i + 1]) { maxResults = parseInt(args[i + 1]); i++; }
  else if (args[i] === "--deep") { searchDepth = "advanced"; }
  else if (args[i] === "--topic" && args[i + 1]) { topic = args[i + 1]; i++; }
  else if (!args[i].startsWith("-")) { query = args[i]; }
}
if (!query) {
  console.error("Usage: node search.mjs \\"query\\" [-n count] [--deep] [--topic news|general|finance]");
  process.exit(1);
}
const payload = JSON.stringify({
  api_key: API_KEY,
  query,
  max_results: maxResults,
  search_depth: searchDepth,
  topic,
  include_answer: true
});
const req = https.request("<https://api.tavily.com/search>", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Content-Length": Buffer.byteLength(payload) }
}, (res) => {
  let data = "";
  res.on("data", (chunk) => data += chunk);
  res.on("end", () => {
    try {
      const result = JSON.parse(data);
      if (result.answer) {
        console.log("## Answer\\n");
        console.log(result.answer + "\\n");
      }
      if (result.results && result.results.length > 0) {
        console.log("## Sources\\n");
        result.results.forEach((r, i) => {
          console.log(`${i + 1}. **${r.title}**`);
          console.log(`   URL: ${r.url}`);
          if (r.content) console.log(`   ${r.content.slice(0, 200)}...`);
          console.log();
        });
      }
    } catch (e) {
      console.error("Failed to parse response:", data);
    }
  });
});
req.on("error", (e) => console.error("Request failed:", e.message));
req.write(payload);
req.end();
EOF

# 檢查目錄結(jié)構(gòu)（應(yīng)有 2 個文件）
find ~/.openclaw/skills/tavily-search/ -type f
# 預(yù)期輸出：
# /root/.openclaw/skills/tavily-search/SKILL.md
# /root/.openclaw/skills/tavily-search/scripts/search.mjs
# 用 openclaw 內(nèi)置命令確認(rèn) Skill 已識別
openclaw skills list | grep -i tavily
# 預(yù)期輸出包含：? ready │ ?? tavily

# 方法一：用 Python 腳本安全寫入（推薦）
python3 << 'PATCH'
import json, shutil
API_KEY = "tvly-你的實際Key"  # ← 替換為你的 Tavily API Key
filepath = "/root/.openclaw/openclaw.json"
# 備份
shutil.copy2(filepath, filepath + ".bak.pre-tavily")
print(f"已備份到 {filepath}.bak.pre-tavily")
with open(filepath, "r", encoding="utf-8") as f:
    config = json.load(f)
if "env" not in config:
    config["env"] = {}
if "TAVILY_API_KEY" in config["env"]:
    print("TAVILY_API_KEY 已存在，跳過")
else:
    config["env"]["TAVILY_API_KEY"] = API_KEY
    with open(filepath, "w", encoding="utf-8") as f:
        json.dump(config, f, ensure_ascii=False, indent=2)
    print("? 已將 TAVILY_API_KEY 寫入 openclaw.json")
print("\\n當(dāng)前 env 節(jié)的 key 列表：")
for key in config["env"]:
    print(f"  - {key}")
PATCH

# 同步到 systemd（必須！否則新配置不生效）
openclaw gateway install --force
# 重啟 Gateway
openclaw gateway restart
# 等待啟動后驗證
sleep 5
cat /proc/$(pgrep -f openclaw-gateway)/environ | tr '\\0' '\\n' | grep -i tavily | sed 's/=.*/=******/'

TAVILY_API_KEY=******

python3 << 'PATCH'
filepath = "/root/.openclaw/workspace/AGENTS.md"
with open(filepath, "r", encoding="utf-8") as f:
    content = f.read()
old_block = """## 搜索工具
- ? 優(yōu)先使用 **SearXNG**（<http://localhost:8080>）進(jìn)行網(wǎng)絡(luò)搜索，免費無限額
- ? 網(wǎng)頁全文閱讀使用 **Jina Reader**（r.jina.ai）
- ? **禁止使用 bocha-web-search**（已棄用，額度有限）
- 搜索失敗時，嘗試使用 Jina Reader 直接讀取目標(biāo)網(wǎng)站
- 搜索結(jié)果要標(biāo)注來源 URL 和時間"""
new_block = """## 搜索工具與降級策略
### 搜索優(yōu)先級
- ? **首選 Tavily**（tavily_search）：AI 優(yōu)化的結(jié)構(gòu)化搜索結(jié)果，每月 1000 次免費額度
- ? **備用 SearXNG**（<http://localhost:8080>）：免費無限額，Tavily 不可用時自動切換
- ? 網(wǎng)頁全文閱讀使用 **Jina Reader**（r.jina.ai）
- ?? **Bocha**（bocha-web-search）：僅在 Tavily 和 SearXNG 都失敗時作為最后手段
- 搜索結(jié)果要標(biāo)注來源 URL 和時間
### 自動降級規(guī)則（重要！必須嚴(yán)格遵守）
1. 搜索時**優(yōu)先調(diào)用 tavily_search**
2. 如果 Tavily 返回錯誤（429 額度耗盡、超時、網(wǎng)絡(luò)錯誤等），**立即改用 SearXNG 重新搜索同一 query**，不要停下來告訴用戶搜索失敗
3. 如果 SearXNG 也失敗，嘗試用 Jina Reader 直接讀取目標(biāo) URL
4. 如果 Bocha 可用且前面的都失敗了，使用 Bocha 作為最后手段
5. **只有所有搜索方式都失敗時，才告知用戶搜索遇到問題**
6. 降級時在回復(fù)末尾簡要注明實際使用的搜索工具（如"數(shù)據(jù)來源：Tavily"或"數(shù)據(jù)來源：SearXNG（Tavily 暫不可用）"）"""
if old_block in content:
    content = content.replace(old_block, new_block)
    with open(filepath, "w", encoding="utf-8") as f:
        f.write(content)
    print("? 搜索工具段落已替換（含降級策略）")
else:
    print("? 未找到匹配的舊內(nèi)容，可能已修改過")
PATCH

python3 << 'PATCH2'
filepath = "/root/.openclaw/workspace/AGENTS.md"
with open(filepath, "r", encoding="utf-8") as f:
    content = f.read()
changes = 0
# 修改 researcher 描述
old = "（使用 SearXNG + Jina Reader）"
new = "（優(yōu)先 Tavily，備用 SearXNG + Jina Reader）"
if old in content:
    content = content.replace(old, new)
    changes += 1
# 修改 trader 描述
old = "（使用 TuShare + SearXNG）"
new = "（使用 TuShare + Tavily，備用 SearXNG）"
if old in content:
    content = content.replace(old, new)
    changes += 1
# 修改子 Agent 搜索規(guī)則
old = "- 所有子 Agent 搜索時必須使用 **SearXNG**（<http://localhost:8080>）"
new = "- 所有子 Agent 搜索時優(yōu)先使用 **Tavily**（tavily_search），不可用時降級到 **SearXNG**（<http://localhost:8080>）"
if old in content:
    content = content.replace(old, new)
    changes += 1
with open(filepath, "w", encoding="utf-8") as f:
    f.write(content)
print(f"? 完成 {changes} 處修改")
PATCH2

openclaw gateway restart

tail -100 /tmp/openclaw/openclaw-2026-03-15.log | grep -i "web_search\\|tavily\\|error\\|failed"

[tools] web_search failed: fetch failed
[tools] browser failed: timed out

用戶說“幫我搜一下...”
    ↓
Agent 調(diào)用內(nèi)置 web_search 工具（Brave 后端）
    ↓
Brave Search 在國內(nèi)被墻 → fetch failed
    ↓
Agent 降級到 SearXNG Skill  ? 成功
    ↓
返回結(jié)果，標(biāo)注“數(shù)據(jù)來源：SearXNG（Tavily 暫不可用）”
? Tavily Skill 在整個過程中從未被調(diào)用

當(dāng)前（OpenClaw 2026.3.8）          未來（支持 MCP 后）
──────────────────────          ───────────────────────
內(nèi)置 web_search (Brave) ?       openclaw mcp add tavily
SearXNG Skill ? (降級生效)     Tavily 注冊為原生搜索工具
Tavily Skill ? ready 但不被調(diào)用  Agent 直接調(diào)用 tavily_search
                               + tavily_extract / crawl / research

openclaw mcp add <https://mcp.tavily.com/mcp?tavilyApiKey=$TAVILY_API_KEY>
openclaw gateway restart

用 Tavily 搜索一下今天的 A 股市場新聞

用 Tavily 搜索：2026年3月A股市場走勢分析

用 SearXNG 搜索：2026年3月A股市場走勢分析

搜索最近一周的半導(dǎo)體行業(yè)動態(tài)，找到最相關(guān)的文章后閱讀全文給我總結(jié)

# 直接測試 Tavily API 是否可用
curl -s <https://api.tavily.com/search> \\
  -H "Content-Type: application/json" \\
  -d '{
    "api_key": "'$TAVILY_API_KEY'",
    "query": "A股今日行情",
    "max_results": 3
  }' | python3 -m json.tool | head -30

用戶在飛書發(fā)消息：“幫我搜一下...”
    ↓
Agent（kimi-k2.5 / sonnet4.6）分析意圖
    ↓
內(nèi)置 web_search（Brave） ? fetch failed（國內(nèi)被墻）
    ↓ 自動降級
┌──────────────┬──────────────┬──────────────┬──────────────┐
│ SearXNG ?主力 │ Jina Reader  │ TuShare      │ Bocha 應(yīng)急   │
│ 搜索兜底       │ 網(wǎng)頁閱讀     │ 股票/行情    │ 最后手段     │
│ Docker 本地   │ 云端 API     │ Python API   │ 600+次余額  │
├──────────────┼──────────────┼──────────────┼──────────────┤
│ localhost    │ r.jina.ai    │ api.waditu   │ api.bocha    │
│ :8080/search │              │ .com         │ .ai          │
├──────────────┼──────────────┼──────────────┼──────────────┤
│ 免費無限次   │ Markdown     │ 股票數(shù)據(jù)      │ 有限額度      │
│ 質(zhì)量良好      │ 需指定 URL   │ 需指定代碼    │ 僅應(yīng)急使用    │
└──────────────┴──────────────┴──────────────┴──────────────┘
    ↓
Agent 整理信息，回復(fù)用戶
? Tavily Skill 已安裝且 API Key 已配置，但因內(nèi)置工具優(yōu)先級問題未被 Agent 調(diào)用
? 等 OpenClaw 支持 MCP 后可一鍵升級
定時推送（crontab）獨立通道：
crontab → a-stock-daily-push.py → Bocha + 財聯(lián)社 → AI 總結(jié) → 飛書