OpenClaw 聯網搜尋設定：用 BazaarLink 取代直連 Tavily

OpenClaw 的 web_search 可以用 Tavily 當搜尋來源，也提供 tavily_search、tavily_extract 兩個獨立工具。官方支援把 Tavily 的網址改掉，所以你可以讓 OpenClaw 改走 BazaarLink：同一組 BazaarLink API key 同時付模型與搜尋、以新台幣計價、可開統一發票。

你需要準備

• 一組 BazaarLink API key（註冊即可，不用海外信用卡）
• 已安裝的 OpenClaw

步驟 1：安裝 Tavily 外掛

openclaw plugins install @openclaw/tavily-plugin

或在初次設定時用 openclaw configure --section web 一併安裝。

步驟 2：設定 API key 與網址（二選一）

方式 A：環境變數

export TAVILY_API_KEY="你的 BazaarLink API key"
export TAVILY_BASE_URL="https://api.bazaarlink.ai/v1"

方式 B：設定檔（JSON5）

{
  plugins: {
    entries: {
      tavily: {
        config: {
          webSearch: {
            apiKey: "你的 BazaarLink API key",
            baseUrl: "https://api.bazaarlink.ai/v1",
          },
        },
      },
    },
  },
}

步驟 3：把 Tavily 設為搜尋來源

{
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}

OpenClaw 會依序自動偵測 Brave、Gemini、Grok、Perplexity、Firecrawl、Tavily；如果你同時設了其他搜尋 key，請明確寫 provider: "tavily"，避免被其他來源優先使用。

步驟 4：驗證

在 OpenClaw 裡請 agent 搜尋一件有時效的事，例如「今天 Node.js LTS 最新版本是多少？」，回覆應附來源連結。到 BazaarLink 後台看用量，應該會多一筆搜尋。

可用工具與參數

• tavily_search：query（必填）、search_depth（basic／advanced）、topic（general／news／finance）、max_results（1–20）、include_answer、time_range、include_domains、exclude_domains。
• tavily_extract：urls（必填，1–20 個）、query、extract_depth（basic／advanced）、chunks_per_source（1–5，需搭配 query）、include_images。 完整欄位請看 BazaarLink 文件的 API 參考。

費用

• 搜尋按次計費，advanced 深度較貴，實際價格見價格表，會依後台設定自動更新。
• 搜尋失敗不收費。

常見問題

• 還是連到 api.tavily.com？ 確認環境變數或設定檔真的生效，並重新啟動 OpenClaw。兩個地方都設時，以你實際載入的為準。
• 回 401？ API key 需要用 BazaarLink 的 key，不是 Tavily 的。
• 這是 Tavily 官方服務嗎？ 不是。BazaarLink 是獨立服務，提供 Tavily 格式的 API。

四個工具的用法與價格，見〈Tavily 風格 AI 搜尋 API：Search、Extract、Crawl、Map〉。

台幣計費・統一發票・主流 AI 模型・OpenAI 相容 API