OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Brave 搜尋

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

取得 API 金鑰

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

設定範例

json5
{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "BRAVE_API_KEY_HERE",            mode: "web", // 或 "llm-context"            baseUrl: "https://api.search.brave.com", // 選用的 Proxy／基底 URL 覆寫          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

Brave 專用的搜尋設定位於 plugins.entries.brave.config.webSearch.*；這是標準設定路徑。

webSearch.mode 控制 Brave 傳輸方式：

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

webSearch.baseUrl 可將 Brave 請求導向受信任且相容於 Brave 的 Proxy 或閘道。OpenClaw 會將 /res/v1/web/search 或 /res/v1/llm/context 附加至 已設定的基底 URL，並將基底 URL 納入快取鍵。公開 端點必須使用 https://；只有受信任的回送介面 或私人網路 Proxy 主機才接受 http://。

工具參數

querystringrequired

搜尋查詢。

countnumberdefault: 5

要傳回的結果數量（1–10）。

countrystring

2 個字母的 ISO 國家代碼（例如 US、DE）。

languagestring

搜尋結果的 ISO 639-1 語言代碼（例如 en、de、fr）。

search_langstring

Brave 搜尋語言代碼（例如 en、en-gb、zh-hans）。

ui_langstring

UI 元素的 ISO 語言代碼。

freshness'day' | 'week' | 'month' | 'year'

時間篩選條件 — day 代表 24 小時。

date_afterstring

只傳回在此日期之後發布的結果（YYYY-MM-DD）。

date_beforestring

只傳回在此日期之前發布的結果（YYYY-MM-DD）。

範例：

javascript
// 依國家與語言搜尋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 方案。如果你使用舊版訂閱方案（例如原始的 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 快取識別資訊，因此 不同 Proxy 的回應不會發生衝突。
  • 啟用 brave.http 診斷旗標，可在疑難排解時記錄 Brave 請求 URL／查詢參數、回應狀態／耗時，以及搜尋快取的命中／未命中／寫入事件。此旗標絕不會記錄 API 金鑰或回應本文，但搜尋查詢可能包含敏感資訊。

相關內容

Was this useful?
On this page

On this page