Brave Search API

OpenClaw 支援以 Brave Search API 作為 web_search 供應商。

取得 API 金鑰

前往 https://brave.com/search/api/ 建立 Brave Search API 帳號
在控制台選擇 Search 方案，產生 API 金鑰。
將金鑰存入設定檔，或在 Gateway 環境中設定 BRAVE_API_KEY。

設定範例

{
  tools: {
    web: {
      search: {
        provider: "brave",
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

工具參數

參數	說明
`query`	搜尋查詢（必填）
`count`	回傳結果數量（1-10，預設：5）
`country`	兩碼 ISO 國家代碼（例如 “US”、“DE”）
`language`	ISO 639-1 語言代碼，用於搜尋結果（例如 “en”、“de”、“fr”）
`ui_lang`	ISO 語言代碼，用於 UI 元素
`freshness`	時間篩選：`day`（24 小時）、`week`、`month` 或 `year`
`date_after`	只回傳在此日期之後發佈的結果（YYYY-MM-DD）
`date_before`	只回傳在此日期之前發佈的結果（YYYY-MM-DD）

範例：

// 指定國家與語言的搜尋
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// 近期結果（過去一週）
await web_search({
  query: "AI news",
  freshness: "week",
});

// 日期範圍搜尋
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

備註

OpenClaw 使用 Brave 的 Search 方案。如果你持有舊版訂閱（例如原本每月 2,000 次查詢的免費方案），仍然有效，但不含 LLM Context 等較新功能或更高的速率限制。
每個 Brave 方案都包含每月 $5 的免費額度（按月更新）。Search 方案每 1,000 次請求收費 $5，因此額度足夠 1,000 次查詢／月。建議在 Brave 控制台設定用量上限以避免意外收費。詳情見 Brave API 入口。
Search 方案包含 LLM Context 端點和 AI 推論權限。若要將結果用於訓練或微調模型，需使用具有明確儲存權限的方案。詳見 Brave 服務條款。
搜尋結果預設快取 15 分鐘（可透過 cacheTtlMinutes 設定）。

完整的 web_search 設定請參閱 Web 工具。