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", // 選用的代理伺服器／基底 URL 覆寫          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

Brave 提供者專用的搜尋設定位於 plugins.entries.brave.config.webSearch.*；這是標準設定路徑。共用的頂層 tools.web.search.apiKey 和限定範圍的 tools.web.search.brave.* 仍會透過相容性合併載入，但新設定應使用上述外掛範圍路徑。

webSearch.mode 控制 Brave 的傳輸方式：

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

webSearch.baseUrl 可將 Brave 請求導向受信任且與 Brave 相容的代理伺服器 或閘道。OpenClaw 會將 /res/v1/web/search 或 /res/v1/llm/context 附加至 已設定的基底 URL，並將基底 URL 納入快取鍵。公開 端點必須使用 https://；只有受信任的 local loopback 或私人網路代理伺服器主機才接受 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

使用者介面元素的 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 方案。如果你使用舊版訂閱方案（例如原始的免費方案，每月可查詢 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 金鑰或回應本文，但搜尋查詢可能包含敏感資訊。

相關內容

Was this useful?
On this page

On this page