Skip to content
OpenClaw Docs

Brave Search

Brave Search API

Section titled “Brave Search API”

OpenClaw 支援 Brave Search API 作為 web_search 提供者。

取得 API 金鑰

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

設定範例

Section titled “設定範例”
{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

特定提供者的 Brave 搜尋設定現已位於 plugins.entries.brave.config.webSearch.* 之下。 舊版的 tools.web.search.apiKey 仍透過相容性 shim 載入，但它不再是標準的設定路徑。

工具參數

Section titled “工具參數”
參數描述
query搜尋查詢（必填）
count要傳回的結果數量 (1-10，預設：5)
country兩字母 ISO 國家/地區代碼（例如 “US”、“DE”）
language搜尋結果的 ISO 639-1 語言代碼（例如 “en”、“de”、“fr”）
ui_langUI 元素的 ISO 語言代碼
freshness時間篩選：day (24h)、week、month 或 year
date_after僅此日期之後發布的結果 (YYYY-MM-DD)
date_before僅此日期之前發布的結果 (YYYY-MM-DD)

範例：

// 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",
});

備註

Section titled “備註”
  • OpenClaw 使用 Brave Search 方案。如果您有舊版訂閱（例如每月 2,000 次查詢的原始 Free 方案），它仍然有效，但不包括較新的功能，如 LLM Context 或更高的速率限制。
  • 每個 Brave 方案都包含 每月 $5 的免費額度（自動續期）。Search 方案每 1,000 次請求費用為 $5，因此額度涵蓋每月 1,000 次查詢。在 Brave 儀表板中設定您的使用限制，以避免意外收費。有關當前方案，請參閱 Brave API portal。
  • Search 方案包含 LLM Context 端點和 AI 推理權限。儲存結果以訓練或調整模型需要具有明確儲存權限的方案。請參閱 Brave 服務條款。
  • 結果預設快取 15 分鐘（可透過 cacheTtlMinutes 設定）。

相關

Section titled “相關”