Brave Search API

OpenClaw は Brave Search API を web_search プロバイダーとしてサポートしています。

API キーの取得

https://brave.com/search/api/ で Brave Search API アカウントを作成します。
ダッシュボードで Search プランを選択し、API キーを生成します。
設定ファイルにキーを保存するか、Gateway の環境変数に BRAVE_API_KEY を設定します。

設定例

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

ツールパラメータ

パラメータ	説明
`query`	検索クエリ（必須）
`count`	返却する結果数（1-10、デフォルト: 5）
`country`	2文字の ISO 国コード（例: “US”, “DE”）
`language`	検索結果の ISO 639-1 言語コード（例: “en”, “de”, “fr”）
`ui_lang`	UI 要素の ISO 言語コード
`freshness`	時間フィルター: `day`（24時間）、`week`、`month`、`year`
`date_after`	この日付以降に公開された結果のみ（YYYY-MM-DD）
`date_before`	この日付以前に公開された結果のみ（YYYY-MM-DD）

使用例:

// 国と言語を指定した検索
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// 最新の結果（直近1週間）
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クエリの旧 Free プラン）をお持ちの場合、そのまま使えますが、LLM Context や高レートリミットなどの新機能は含まれません。
各 Brave プランには月額 $5 分の無料クレジットが含まれています（毎月更新）。Search プランは 1,000 リクエストあたり $5 なので、無料クレジットで月1,000クエリをカバーできます。想定外の課金を防ぐため、Brave ダッシュボードで利用上限を設定してください。最新のプラン情報は Brave API ポータルをご確認ください。
Search プランには LLM Context エンドポイントと AI 推論権が含まれます。結果を保存してモデルのトレーニングやチューニングに使う場合は、明示的なストレージ権を含むプランが必要です。詳細は Brave の利用規約をご確認ください。
結果はデフォルトで15分間キャッシュされます（cacheTtlMinutes で変更可能）。

web_search の完全な設定については Web tools を参照してください。