Brave 検索

​

API キーを取得する

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

​

設定例

{
  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,
      },
    },
  },
}

• web（デフォルト）：タイトル、URL、スニペットを含む通常の Brave ウェブ検索
• llm-context：グラウンディング用に事前抽出されたテキストチャンクとソースを提供する Brave LLM Context API

​

ツールパラメーター

// 国と言語を指定した検索
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 の利用規約を参照してください。
• llm-context モードでは、通常のウェブ検索スニペット形式ではなく、グラウンディングされたソースエントリが返されます。
• llm-context モードは、freshness と、範囲が限定された date_after + date_before をサポートします。ui_lang はサポートしません。Brave ではカスタム期間範囲に開始日と終了日の両方を含める必要があるため、date_after を伴わない date_before は拒否されます。
• ui_lang には、en-US のような地域サブタグを含める必要があります。
• 結果はデフォルトで 15 分間キャッシュされます（cacheTtlMinutes で設定可能）。
• カスタムの webSearch.baseUrl 値は Brave のキャッシュ識別情報に含まれるため、 プロキシ固有のレスポンスが競合することはありません。
• トラブルシューティング中に Brave のリクエスト URL／クエリパラメーター、レスポンスのステータス／所要時間、および検索キャッシュのヒット／ミス／書き込みイベントをログに記録するには、brave.http 診断フラグを有効にします。このフラグが API キーやレスポンス本文をログに記録することはありませんが、検索クエリには機密情報が含まれる可能性があります。

​

関連情報

• ウェブ検索の概要 — すべてのプロバイダーと自動検出
• Perplexity Search — ドメインフィルタリングを備えた構造化結果
• Exa Search — コンテンツ抽出を備えたニューラル検索