如何在 OpenClaw 整合 Brave Search API

開發聯網功能最煩人的就是搜尋結果不精準，或是 API 設定流程超級複雜，光是處理格式就耗掉大半天。如果你正在找一個穩定、好上手的方案，Brave Search 是目前 OpenClaw 預設最推薦的選擇。

需要準備的東西

• Brave Search API 帳戶
• API Key（需選擇 Data for Search 方案）

快速開始

OpenClaw 預設使用 Brave Search 來處理 web_search 任務，你只需要兩個步驟就能完成設定：

1. 前往 Brave Search API 官網 註冊帳戶，並在控制面板選擇 Data for Search 方案來產生 API key。
2. 將取得的 Key 填入設定檔（推薦做法），或是直接在 Gateway 環境變數中設定 BRAVE_API_KEY。

你可以參考下方的 json5 設定範例：

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

疑難排解

• 方案選擇錯誤：請務必確認你選擇的是 Data for Search。如果你選成 Data for AI 方案，它跟 web_search 功能是不相容的。
• 額度與限制：Brave 有提供免費額度與付費方案。如果發現搜尋沒反應，建議回 Brave API 管理後台檢查目前的用量與限制。

如果你在設定過程遇到任何卡關，可以直接詢問 AI Setup Assistant。

下一步

• Web tools 完整配置說明