Brave 搜尋

​

取得 API 金鑰

1. 在 https://brave.com/search/api/ 建立 Brave Search API 帳戶
2. 在儀表板中，選擇 Search 方案並產生 API 金鑰。
3. 將金鑰儲存在設定中，或在閘道環境中設定 BRAVE_API_KEY。

​

設定範例

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // or "llm-context"
            baseUrl: "https://api.search.brave.com", // optional proxy/base URL override
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

• web（預設）：一般 Brave 網頁搜尋，包含標題、URL 和摘要片段
• llm-context：Brave LLM Context API，提供預先擷取的文字區塊和來源以作為依據

​

工具參數

// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

​

注意事項

• OpenClaw 使用 Brave Search 方案。如果你有舊版訂閱（例如原始的 Free 方案，每月 2,000 次查詢），它仍然有效，但不包含較新的功能，例如 LLM Context 或更高的速率限制。
• 每個 Brave 方案都包含每月 $5 免費額度（會續期）。Search 方案費用為每 1,000 次請求 $5，因此此額度可涵蓋每月 1,000 次查詢。請在 Brave 儀表板中設定你的使用量上限，以避免非預期費用。請參閱 Brave API 入口網站 以取得目前方案。
• Search 方案包含 LLM Context 端點和 AI 推論權利。儲存結果以訓練或調校模型，需要具備明確儲存權利的方案。請參閱 Brave 服務條款。
• llm-context 模式會傳回有依據的來源項目，而不是一般網頁搜尋摘要片段格式。
• llm-context 模式支援 freshness 和有界的 date_after + date_before 範圍。它不支援 ui_lang；沒有 date_after 的 date_before 會被拒絕，因為 Brave 要求自訂新鮮度範圍必須同時包含開始和結束日期。
• ui_lang 必須包含區域子標籤，例如 en-US。
• 結果預設會快取 15 分鐘（可透過 cacheTtlMinutes 設定）。
• 自訂 webSearch.baseUrl 值會包含在 Brave 快取識別中，因此 代理專屬回應不會互相衝突。
• 啟用 brave.http 診斷旗標，以在疑難排解時記錄 Brave 請求 URL/查詢參數、回應狀態/時間，以及搜尋快取命中/未命中/寫入事件。此旗標絕不會記錄 API 金鑰或回應本文，但搜尋查詢可能是敏感資訊。

​

相關

• 網頁搜尋概觀 — 所有提供者和自動偵測
• Perplexity Search — 具備網域篩選的結構化結果
• Exa Search — 具備內容擷取的神經搜尋