跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Brave Search API

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

​
取得 API 金鑰

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

​
設定範例

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // or "llm-context"
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}
Brave 專屬的搜尋設定現在位於 plugins.entries.brave.config.webSearch.* 下。 舊版 tools.web.search.apiKey 仍會透過相容層載入，但它不再是標準設定路徑。 webSearch.mode 控制 Brave 傳輸方式：
  • web（預設）：一般 Brave 網頁搜尋，包含標題、URL 和摘要
  • llm-context：Brave LLM Context API，包含預先擷取的文字區塊和來源，用於基礎依據

​
工具參數

​
query
string
必填
搜尋查詢。
​
count
number
預設值:"5"
要傳回的結果數量（1–10）。
​
country
string
2 字母 ISO 國家/地區代碼（例如 US、DE）。
​
language
string
搜尋結果的 ISO 639-1 語言代碼（例如 en、de、fr）。
​
search_lang
string
Brave 搜尋語言代碼（例如 en、en-gb、zh-hans）。
​
ui_lang
string
UI 元素的 ISO 語言代碼。
​
freshness
'day' | 'week' | 'month' | 'year'
時間篩選器 — day 為 24 小時。
​
date_after
string
僅包含此日期之後發布的結果（YYYY-MM-DD）。
​
date_before
string
僅包含此日期之前發布的結果（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",
});

​
注意事項

  • 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 模式不支援 ui_lang、freshness、date_after 或 date_before。
  • ui_lang 必須包含區域子標籤，例如 en-US。
  • 結果預設快取 15 分鐘（可透過 cacheTtlMinutes 設定）。

​
相關