​

Brave Search API

​

取得 API 金鑰

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

​

設定範例

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

​

工具參數

// 依國家和語言搜尋
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 設定）。