ウェブ検索

web_search ツールは、設定済みのプロバイダーを使用して Web を検索し、 結果を返します。結果はクエリごとに 15 分間キャッシュされます（設定可能）。

OpenClaw には、X（旧 Twitter）投稿用の x_search と、 軽量な URL フェッチ用の web_fetch も含まれています。このフェーズでは、web_fetch は ローカルのままで、web_search と x_search は内部で xAI Responses を使用できます。

クイックスタート

openclaw configure --section web

await web_search({ query: "OpenClaw plugin SDK" });

await x_search({ query: "dinner recipes" });

プロバイダーの選択

プロバイダー比較

自動検出

ネイティブ OpenAI Web 検索

OpenClaw Web 検索が有効で、管理対象プロバイダーが固定されていない場合、直接の OpenAI Responses モデルは OpenAI のホスト型 web_search ツールを自動的に使用します。これはバンドルされた OpenAI Plugin 内のプロバイダー所有の動作であり、ネイティブ OpenAI API トラフィックにのみ適用されます。OpenAI 互換プロキシのベース URL や Azure ルートには適用されません。OpenAI モデルで管理対象の web_search ツールを維持するには、tools.web.search.provider を brave などの別プロバイダーに設定します。また、管理対象検索とネイティブ OpenAI 検索の両方を無効にするには、tools.web.search.enabled: false を設定します。

ネイティブ Codex Web 検索

Codex 対応モデルは、OpenClaw の管理対象 web_search 関数の代わりに、プロバイダー ネイティブの Responses web_search ツールを任意で使用できます。

• tools.web.search.openaiCodex で設定します
• Codex 対応モデル（openai-codex/*、または api: "openai-codex-responses" を使用するプロバイダー）でのみ有効化されます
• 管理対象の web_search は Codex 以外のモデルにも引き続き適用されます
• mode: "cached" がデフォルトで推奨設定です
• tools.web.search.enabled: false は、管理対象検索とネイティブ検索の両方を無効にします

{  tools: {    web: {      search: {        enabled: true,        openaiCodex: {          enabled: true,          mode: "cached",          allowedDomains: ["example.com"],          contextSize: "high",          userLocation: {            country: "US",            city: "New York",            timezone: "America/New_York",          },        },      },    },  },}

ネイティブ Codex 検索が有効でも、現在のモデルが Codex 対応でない場合、OpenClaw は通常の管理対象 web_search 動作を維持します。

ネットワーク安全性

管理対象の web_search プロバイダー呼び出しは、OpenClaw のガード付きフェッチ経路を使用します。 信頼済みプロバイダー API ホストについては、OpenClaw は Surge、Clash、sing-box の fake-IP DNS 応答を 198.18.0.0/15 と fc00::/7 内で、そのプロバイダーのホスト名に限って許可します。 その他のプライベート、ループバック、リンクローカル、メタデータ宛先は引き続きブロックされます。

この自動許可は、任意の web_fetch URL には適用されません。 web_fetch では、信頼済みプロキシがそれらの合成範囲を所有している場合に限り、 tools.web.fetch.ssrfPolicy.allowRfc2544BenchmarkRange と tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRange を明示的に有効にしてください。

Web 検索のセットアップ

ドキュメントとセットアップフロー内のプロバイダー一覧はアルファベット順です。自動検出には 別の優先順位があります。

provider が設定されていない場合、OpenClaw は次の順序でプロバイダーを確認し、 最初に準備ができているものを使用します。

まず API ベースのプロバイダー:

1. Brave -- BRAVE_API_KEY または plugins.entries.brave.config.webSearch.apiKey（順序 10）
2. MiniMax Search -- MINIMAX_CODE_PLAN_KEY / MINIMAX_CODING_API_KEY / MINIMAX_OAUTH_TOKEN / MINIMAX_API_KEY または plugins.entries.minimax.config.webSearch.apiKey（順序 15）
3. Gemini -- plugins.entries.google.config.webSearch.apiKey、GEMINI_API_KEY、または models.providers.google.apiKey（順序 20）
4. Grok -- XAI_API_KEY または plugins.entries.xai.config.webSearch.apiKey（順序 30）
5. Kimi -- KIMI_API_KEY / MOONSHOT_API_KEY または plugins.entries.moonshot.config.webSearch.apiKey（順序 40）
6. Perplexity -- PERPLEXITY_API_KEY / OPENROUTER_API_KEY または plugins.entries.perplexity.config.webSearch.apiKey（順序 50）
7. Firecrawl -- FIRECRAWL_API_KEY または plugins.entries.firecrawl.config.webSearch.apiKey（順序 60）
8. Exa -- EXA_API_KEY または plugins.entries.exa.config.webSearch.apiKey。任意の plugins.entries.exa.config.webSearch.baseUrl は Exa エンドポイントを上書きします（順序 65）
9. Tavily -- TAVILY_API_KEY または plugins.entries.tavily.config.webSearch.apiKey（順序 70）

その後のキー不要のフォールバック:

10. DuckDuckGo -- アカウントや API キーなしで使えるキー不要の HTML フォールバック（順序 100）
11. Ollama Web Search -- 設定済みのローカル Ollama ホストに到達でき、ollama signin でサインイン済みの場合のキー不要フォールバック。ホストで必要な場合は Ollama プロバイダーのベアラー認証を再利用でき、OLLAMA_API_KEY が設定されている場合は直接 https://ollama.com 検索を呼び出せます（順序 110）
12. SearXNG -- SEARXNG_BASE_URL または plugins.entries.searxng.config.webSearch.baseUrl（順序 200）

プロバイダーが検出されない場合は Brave にフォールバックします（設定を促す キー不足エラーが表示されます）。

設定

{  tools: {    web: {      search: {        enabled: true, // default: true        provider: "brave", // or omit for auto-detection        maxResults: 5,        timeoutSeconds: 30,        cacheTtlMinutes: 15,      },    },  },}

プロバイダー固有の設定（APIキー、ベースURL、モード）は plugins.entries.<plugin>.config.webSearch.* の下にあります。Gemini は、専用のWeb検索設定と GEMINI_API_KEY の後に、低優先度のフォールバックとして models.providers.google.apiKey と models.providers.google.baseUrl も再利用できます。例については プロバイダーページを参照してください。

tools.web.search.provider は、バンドル済みおよびインストール済みのPluginマニフェストで宣言されたWeb検索プロバイダーIDに対して検証されます。 "brvae" のような入力ミスは、暗黙に自動検出へフォールバックするのではなく、設定検証で失敗します。設定されたプロバイダーに、サードパーティPluginをアンインストールした後に残った plugins.entries.<plugin> ブロックのような古いPlugin証跡しかない場合、OpenClaw は起動の回復性を保ちつつ警告を報告するため、Pluginを再インストールするか、openclaw doctor --fix を実行して古い設定をクリーンアップできます。

web_fetch のフォールバックプロバイダー選択は別です。

• tools.web.fetch.provider で選択します
• またはそのフィールドを省略し、利用可能な認証情報から最初に準備完了となるWeb取得プロバイダーをOpenClawに自動検出させます
• 非サンドボックスの web_fetch は、contracts.webFetchProviders を宣言するインストール済みPluginプロバイダーを使用できます。サンドボックス内の取得はバンドル済みのみのままです
• 現在のバンドル済みWeb取得プロバイダーはFirecrawlで、plugins.entries.firecrawl.config.webFetch.* の下で設定します

openclaw onboard または openclaw configure --section web で Kimi を選択すると、OpenClaw は次の項目も尋ねる場合があります。

• Moonshot APIリージョン（https://api.moonshot.ai/v1 または https://api.moonshot.cn/v1）
• デフォルトのKimi Web検索モデル（デフォルトは kimi-k2.6）

x_search には、plugins.entries.xai.config.xSearch.* を設定します。これはチャットと同じxAI認証プロファイル、またはGrok Web検索で使われる XAI_API_KEY / Plugin Web検索認証情報を使用します。 従来の tools.web.x_search.* 設定は、openclaw doctor --fix によって自動移行されます。 openclaw onboard または openclaw configure --section web でGrokを選択すると、OpenClaw は同じキーで任意の x_search セットアップも提示できます。 これはGrokパス内の別個のフォローアップ手順であり、別個のトップレベルWeb検索プロバイダー選択ではありません。別のプロバイダーを選んだ場合、OpenClaw は x_search プロンプトを表示しません。

APIキーの保存

{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "YOUR_KEY", // pragma: allowlist secret          },        },      },    },  },}

export BRAVE_API_KEY="YOUR_KEY"

ツールパラメーター

x_search

x_search はxAIを使用してX（旧Twitter）の投稿をクエリし、引用付きのAI合成回答を返します。自然言語クエリと任意の構造化フィルターを受け付けます。OpenClaw は、このツール呼び出しを処理するリクエストでのみ組み込みのxAI x_search ツールを有効にします。

x_search 設定

{  plugins: {    entries: {      xai: {        config: {          xSearch: {            enabled: true,            model: "grok-4-1-fast-non-reasoning",            baseUrl: "https://api.x.ai/v1", // optional, overrides webSearch.baseUrl            inlineCitations: false,            maxTurns: 2,            timeoutSeconds: 30,            cacheTtlMinutes: 15,          },          webSearch: {            apiKey: "xai-...", // optional if an xAI auth profile or XAI_API_KEY is set            baseUrl: "https://api.x.ai/v1", // optional shared xAI Responses base URL          },        },      },    },  },}

plugins.entries.xai.config.xSearch.baseUrl が設定されている場合、x_search は <baseUrl>/responses に投稿します。そのフィールドが省略されている場合は、 plugins.entries.xai.config.webSearch.baseUrl、次に従来の tools.web.search.grok.baseUrl、最後に公開xAIエンドポイントへフォールバックします。

x_search パラメーター

x_search の例

await x_search({  query: "dinner recipes",  allowed_x_handles: ["nytfood"],  from_date: "2026-03-01",});

// Per-post stats: use the exact status URL or status ID when possibleawait x_search({  query: "https://x.com/huntharo/status/1905678901234567890",});

例

// Basic searchawait web_search({ query: "OpenClaw plugin SDK" }); // German-specific searchawait web_search({ query: "TV online schauen", country: "DE", language: "de" }); // Recent results (past week)await web_search({ query: "AI developments", freshness: "week" }); // Date rangeawait web_search({  query: "climate research",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Domain filtering (Perplexity only)await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],});

ツールプロファイル

ツールプロファイルまたは許可リストを使用する場合は、web_search、x_search、または group:web を追加します。

{  tools: {    allow: ["web_search", "x_search"],    // or: allow: ["group:web"]  (includes web_search, x_search, and web_fetch)  },}

関連

• Web取得 -- URLを取得し、読みやすいコンテンツを抽出する
• Webブラウザー -- JSの多いサイト向けの完全なブラウザー自動化
• Grok検索 -- web_search プロバイダーとしてのGrok
• Ollama Web検索 -- Ollamaホスト経由のキー不要Web検索