> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Brave 検索

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

## API キーを取得する

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

## 設定例

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // or "llm-context"
            baseUrl: "https://api.search.brave.com", // optional proxy/base URL override
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}
```

プロバイダー固有の Brave 検索設定は `plugins.entries.brave.config.webSearch.*` にあります。これが正規の設定パスです。共有トップレベルの `tools.web.search.apiKey` とスコープ付きの `tools.web.search.brave.*` は互換性マージを通じて引き続き読み込まれますが、新しい設定では上記の Plugin スコープのパスを使用してください。

`webSearch.mode` は Brave トランスポートを制御します。

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

`webSearch.baseUrl` は、Brave リクエストを信頼済みの Brave 互換プロキシ
またはゲートウェイに向けるために使用できます。OpenClaw は設定されたベース URL に
`/res/v1/web/search` または `/res/v1/llm/context` を追加し、ベース URL をキャッシュキーに保持します。公開
エンドポイントでは `https://` を使用する必要があります。`http://` は、信頼済みの loopback
またはプライベートネットワークのプロキシホストでのみ受け入れられます。

## ツールパラメーター

<ParamField path="query" type="string" required>
  検索クエリ。
</ParamField>

<ParamField path="count" type="number" default="5">
  返す結果の数 (1–10)。
</ParamField>

<ParamField path="country" type="string">
  2文字の ISO 国コード (例: `US`, `DE`)。
</ParamField>

<ParamField path="language" type="string">
  検索結果の ISO 639-1 言語コード (例: `en`, `de`, `fr`)。
</ParamField>

<ParamField path="search_lang" type="string">
  Brave 検索言語コード (例: `en`, `en-gb`, `zh-hans`)。
</ParamField>

<ParamField path="ui_lang" type="string">
  UI 要素の ISO 言語コード。
</ParamField>

<ParamField path="freshness" type="'day' | 'week' | 'month' | 'year'">
  時間フィルター — `day` は24時間です。
</ParamField>

<ParamField path="date_after" type="string">
  この日付 (`YYYY-MM-DD`) より後に公開された結果のみ。
</ParamField>

<ParamField path="date_before" type="string">
  この日付 (`YYYY-MM-DD`) より前に公開された結果のみ。
</ParamField>

**例:**

```javascript theme={"theme":{"light":"min-light","dark":"min-dark"}}
// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
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 ポータル](https://brave.com/search/api/) を参照してください。
* Search プランには LLM Context エンドポイントと AI 推論権限が含まれます。モデルのトレーニングまたはチューニングのために結果を保存するには、明示的な保存権限を含むプランが必要です。Brave の [利用規約](https://api-dashboard.search.brave.com/terms-of-service) を参照してください。
* `llm-context` モードは、通常のウェブ検索スニペット形式の代わりに、グラウンディングされたソースエントリを返します。
* `llm-context` モードは `freshness` と、範囲指定された `date_after` + `date_before` をサポートします。`ui_lang` はサポートしません。`date_after` なしの `date_before` は拒否されます。Brave ではカスタムの freshness 範囲に開始日と終了日の両方が必要なためです。
* `ui_lang` には `en-US` のような地域サブタグを含める必要があります。
* 結果はデフォルトで15分間キャッシュされます (`cacheTtlMinutes` で設定可能)。
* カスタム `webSearch.baseUrl` 値は Brave キャッシュ ID に含まれるため、
  プロキシ固有のレスポンスが衝突しません。
* トラブルシューティング中に Brave リクエスト URL/クエリパラメーター、レスポンスのステータス/タイミング、検索キャッシュのヒット/ミス/書き込みイベントをログに記録するには、`brave.http` 診断フラグを有効にします。このフラグは API キーやレスポンス本文をログに記録することはありませんが、検索クエリには機微な情報が含まれる場合があります。

## 関連

* [Web Search 概要](/ja-JP/tools/web) -- すべてのプロバイダーと自動検出
* [Perplexity Search](/ja-JP/tools/perplexity-search) -- ドメインフィルタリング付きの構造化結果
* [Exa Search](/ja-JP/tools/exa-search) -- コンテンツ抽出付きのニューラル検索