メインコンテンツへスキップ

​
Brave Search API

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

​
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"
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}
Brave 検索固有の設定は、現在 plugins.entries.brave.config.webSearch.* 配下にあります。 従来の tools.web.search.apiKey も互換性 shim を通じて引き続き読み込まれますが、正規の設定パスではなくなりました。 webSearch.mode は Brave の転送方式を制御します。
  • web（デフォルト）: タイトル、URL、スニペットを含む通常の Brave web search
  • llm-context: グラウンディング用に事前抽出されたテキストチャンクとソースを返す Brave LLM Context API

​
ツールパラメーター

Parameter説明
query検索クエリ（必須）
count返す結果数（1〜10、デフォルト: 5）
country2 文字の ISO 国コード（例: “US”, “DE”）
language検索結果用の ISO 639-1 言語コード（例: “en”, “de”, “fr”）
search_langBrave の検索言語コード（例: en, en-gb, zh-hans）
ui_langUI 要素用の ISO 言語コード
freshness時間フィルター: day（24h）、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 portal を参照してください。
  • Search プランには、LLM Context エンドポイントと AI 推論権が含まれます。モデルの学習や調整のために結果を保存するには、明示的な保存権を含むプランが必要です。Brave の Terms of Service を参照してください。
  • llm-context モードは、通常の web-search スニペット形式ではなく、グラウンディングされたソースエントリを返します。
  • llm-context モードは、ui_lang、freshness、date_after、date_before をサポートしません。
  • ui_lang には、en-US のようなリージョンサブタグを含める必要があります。
  • 結果はデフォルトで 15 分間キャッシュされます（cacheTtlMinutes で設定可能）。

​
関連