--- read_when: - web_search を有効化または設定したい場合 - x_search を有効化または設定したい場合 - 検索プロバイダーを選択する必要があります - 自動検出とプロバイダーのフォールバックについて理解したい場合 sidebarTitle: Web Search summary: web_search、x_search、web_fetch -- ウェブを検索、Xの投稿を検索、またはページ内容を取得 title: ウェブ検索 x-i18n: generated_at: "2026-05-10T19:57:41Z" model: gpt-5.5 provider: openai source_hash: 0c2806730f8c9cb33a3c142d5283de0f1231502e052c6da796c31125834a94e6 source_path: tools/web.md workflow: 16 --- `web_search` ツールは、設定済みのプロバイダーを使用して Web を検索し、 結果を返します。結果はクエリごとに 15 分間キャッシュされます（設定可能）。 OpenClaw には、X（旧 Twitter）投稿用の `x_search` と、 軽量な URL フェッチ用の `web_fetch` も含まれています。このフェーズでは、`web_fetch` は ローカルのままで、`web_search` と `x_search` は内部で xAI Responses を使用できます。 `web_search` は軽量な HTTP ツールであり、ブラウザー自動化ではありません。 JS が多いサイトやログインには、[Web Browser](/ja-JP/tools/browser) を使用してください。 特定の URL をフェッチするには、[Web Fetch](/ja-JP/tools/web-fetch) を使用してください。 ## クイックスタート プロバイダーを選び、必要なセットアップを完了します。一部のプロバイダーは キー不要ですが、API キーを使用するものもあります。詳細は下記のプロバイダーページを 参照してください。 ```bash openclaw configure --section web ``` これにより、プロバイダーと必要な認証情報が保存されます。環境変数 （例: `BRAVE_API_KEY`）を設定して、API ベースのプロバイダーでは この手順を省略することもできます。 これでエージェントは `web_search` を呼び出せます。 ```javascript await web_search({ query: "OpenClaw plugin SDK" }); ``` X 投稿には、次を使用します。 ```javascript await x_search({ query: "dinner recipes" }); ``` ## プロバイダーの選択 スニペット付きの構造化された結果。`llm-context` モード、国/言語フィルターをサポートします。無料枠があります。 キー不要のフォールバック。API キーは不要です。非公式の HTML ベースの統合です。 コンテンツ抽出（ハイライト、テキスト、要約）に対応したニューラル + キーワード検索。 構造化された結果。深い抽出には `firecrawl_search` と `firecrawl_scrape` を組み合わせるのが最適です。 Google Search グラウンディングによる引用付きの AI 合成回答。 xAI Web グラウンディングによる引用付きの AI 合成回答。 Moonshot Web 検索による引用付きの AI 合成回答。グラウンディングされていないチャットへのフォールバックは明示的に失敗します。 MiniMax Token Plan 検索 API による構造化された結果。 サインイン済みのローカル Ollama ホスト、またはホスト型 Ollama API による検索。 コンテンツ抽出制御とドメインフィルタリングを備えた構造化された結果。 セルフホスト型のメタ検索。API キーは不要です。Google、Bing、DuckDuckGo などを集約します。 検索深度、トピックフィルタリング、URL 抽出用の `tavily_extract` を備えた構造化された結果。 ### プロバイダー比較 | プロバイダー | 結果の形式 | フィルター | API キー | | ----------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------- | | [Brave](/ja-JP/tools/brave-search) | 構造化されたスニペット | 国、言語、時間、`llm-context` モード | `BRAVE_API_KEY` | | [DuckDuckGo](/ja-JP/tools/duckduckgo-search) | 構造化されたスニペット | -- | なし（キー不要） | | [Exa](/ja-JP/tools/exa-search) | 構造化 + 抽出済み | ニューラル/キーワードモード、日付、コンテンツ抽出 | `EXA_API_KEY` | | [Firecrawl](/ja-JP/tools/firecrawl) | 構造化されたスニペット | `firecrawl_search` ツール経由 | `FIRECRAWL_API_KEY` | | [Gemini](/ja-JP/tools/gemini-search) | AI 合成 + 引用 | -- | `GEMINI_API_KEY` | | [Grok](/ja-JP/tools/grok-search) | AI 合成 + 引用 | -- | `XAI_API_KEY` | | [Kimi](/ja-JP/tools/kimi-search) | AI 合成 + 引用。グラウンディングされていないチャットへのフォールバックでは失敗 | -- | `KIMI_API_KEY` / `MOONSHOT_API_KEY` | | [MiniMax Search](/ja-JP/tools/minimax-search) | 構造化されたスニペット | リージョン（`global` / `cn`） | `MINIMAX_CODE_PLAN_KEY` / `MINIMAX_CODING_API_KEY` / `MINIMAX_OAUTH_TOKEN` | | [Ollama Web Search](/ja-JP/tools/ollama-search) | 構造化されたスニペット | -- | サインイン済みローカルホストではなし。直接の `https://ollama.com` 検索には `OLLAMA_API_KEY` | | [Perplexity](/ja-JP/tools/perplexity-search) | 構造化されたスニペット | 国、言語、時間、ドメイン、コンテンツ制限 | `PERPLEXITY_API_KEY` / `OPENROUTER_API_KEY` | | [SearXNG](/ja-JP/tools/searxng-search) | 構造化されたスニペット | カテゴリ、言語 | なし（セルフホスト） | | [Tavily](/ja-JP/tools/tavily) | 構造化されたスニペット | `tavily_search` ツール経由 | `TAVILY_API_KEY` | ## 自動検出 ## ネイティブ 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` は、管理対象検索とネイティブ検索の両方を無効にします ```json5 { 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 にフォールバックします（設定を促す キー不足エラーが表示されます）。 すべてのプロバイダーキー項目は SecretRef オブジェクトをサポートします。 `plugins.entries..config.webSearch.apiKey` 配下の Plugin スコープ SecretRef は、 Brave、Exa、Firecrawl、Gemini、Grok、Kimi、MiniMax、Perplexity、Tavily を含む バンドル済み API ベース Web 検索プロバイダーで解決されます。 これは、プロバイダーが `tools.web.search.provider` で明示的に選択されている場合も、 自動検出で選択されている場合も同じです。自動検出モードでは、OpenClaw は 選択されたプロバイダーキーのみを解決します。選択されていない SecretRef は非アクティブのままなので、 使用していないプロバイダーの解決コストを払わずに、複数のプロバイダーを設定しておけます。 ## 設定 ```json5 { tools: { web: { search: { enabled: true, // default: true provider: "brave", // or omit for auto-detection maxResults: 5, timeoutSeconds: 30, cacheTtlMinutes: 15, }, }, }, } ``` プロバイダー固有の設定（APIキー、ベースURL、モード）は `plugins.entries..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証跡しかない場合、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キーの保存 `openclaw configure --section web` を実行するか、キーを直接設定します。 ```json5 { plugins: { entries: { brave: { config: { webSearch: { apiKey: "YOUR_KEY", // pragma: allowlist secret }, }, }, }, }, } ``` Gatewayプロセス環境でプロバイダーの環境変数を設定します。 ```bash export BRAVE_API_KEY="YOUR_KEY" ``` Gatewayインストールの場合は、`~/.openclaw/.env` に入れます。 [環境変数](/ja-JP/help/faq#env-vars-and-env-loading)を参照してください。 ## ツールパラメーター | パラメーター | 説明 | | --------------------- | ----------------------------------------------------- | | `query` | 検索クエリ（必須） | | `count` | 返す結果数（1-10、デフォルト: 5） | | `country` | 2文字のISO国コード（例: "US", "DE"） | | `language` | ISO 639-1言語コード（例: "en", "de"） | | `search_lang` | 検索言語コード（Braveのみ） | | `freshness` | 時間フィルター: `day`、`week`、`month`、または `year` | | `date_after` | この日付以降の結果（YYYY-MM-DD） | | `date_before` | この日付以前の結果（YYYY-MM-DD） | | `ui_lang` | UI言語コード（Braveのみ） | | `domain_filter` | ドメインの許可リスト/拒否リスト配列（Perplexityのみ） | | `max_tokens` | 総コンテンツ予算、デフォルト25000（Perplexityのみ） | | `max_tokens_per_page` | ページごとのトークン制限、デフォルト2048（Perplexityのみ） | すべてのパラメーターがすべてのプロバイダーで機能するわけではありません。Braveの `llm-context` モードは `ui_lang` を拒否します。Braveのカスタム鮮度範囲には開始日と終了日の両方が必要なため、`date_before` には `date_after` も必要です。 Gemini、Grok、Kimi は、引用付きで合成された1つの回答を返します。共有ツール互換性のために `count` を受け付けますが、根拠付き回答の形は変わりません。Gemini は、Google Searchグラウンディング時間範囲に変換することで、`freshness`、`date_after`、`date_before` をサポートします。 Perplexity は、Sonar/OpenRouter互換パス（`plugins.entries.perplexity.config.webSearch.baseUrl` / `model` または `OPENROUTER_API_KEY`）を使用する場合に同じように動作します。 SearXNG は、信頼できるプライベートネットワークまたはループバックホストに対してのみ `http://` を受け付けます。 公開SearXNGエンドポイントでは `https://` を使用する必要があります。 Firecrawl と Tavily は、`web_search` を通じて `query` と `count` のみをサポートします。 高度なオプションには、それぞれの専用ツールを使用してください。 ## x_search `x_search` はxAIを使用してX（旧Twitter）の投稿をクエリし、引用付きのAI合成回答を返します。自然言語クエリと任意の構造化フィルターを受け付けます。OpenClaw は、このツール呼び出しを処理するリクエストでのみ組み込みのxAI `x_search` ツールを有効にします。 xAI は `x_search` がキーワード検索、セマンティック検索、ユーザー検索、スレッド取得をサポートすると文書化しています。再投稿、返信、ブックマーク、表示回数など投稿ごとのエンゲージメント統計については、正確な投稿URLまたはステータスIDを対象にしたルックアップを優先してください。 広範なキーワード検索では正しい投稿が見つかる場合がありますが、投稿ごとのメタデータが不完全になることがあります。良いパターンは、まず投稿を特定し、次にその正確な投稿に絞った2回目の `x_search` クエリを実行することです。 ### x_search 設定 ```json5 { 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` は `/responses` に投稿します。そのフィールドが省略されている場合は、 `plugins.entries.xai.config.webSearch.baseUrl`、次に従来の `tools.web.search.grok.baseUrl`、最後に公開xAIエンドポイントへフォールバックします。 ### x_search パラメーター | パラメーター | 説明 | | ---------------------------- | ------------------------------------------------------ | | `query` | 検索クエリ（必須） | | `allowed_x_handles` | 結果を特定のXハンドルに制限する | | `excluded_x_handles` | 特定のXハンドルを除外する | | `from_date` | この日付以降の投稿のみを含める（YYYY-MM-DD） | | `to_date` | この日付以前の投稿のみを含める（YYYY-MM-DD） | | `enable_image_understanding` | 一致する投稿に添付された画像をxAIに検査させる | | `enable_video_understanding` | 一致する投稿に添付された動画をxAIに検査させる | ### x_search の例 ```javascript await x_search({ query: "dinner recipes", allowed_x_handles: ["nytfood"], from_date: "2026-03-01", }); ``` ```javascript // Per-post stats: use the exact status URL or status ID when possible await x_search({ query: "https://x.com/huntharo/status/1905678901234567890", }); ``` ## 例 ```javascript // Basic search await web_search({ query: "OpenClaw plugin SDK" }); // German-specific search await web_search({ query: "TV online schauen", country: "DE", language: "de" }); // Recent results (past week) await web_search({ query: "AI developments", freshness: "week" }); // Date range await 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` を追加します。 ```json5 { tools: { allow: ["web_search", "x_search"], // or: allow: ["group:web"] (includes web_search, x_search, and web_fetch) }, } ``` ## 関連 - [Web取得](/ja-JP/tools/web-fetch) -- URLを取得し、読みやすいコンテンツを抽出する - [Webブラウザー](/ja-JP/tools/browser) -- JSの多いサイト向けの完全なブラウザー自動化 - [Grok検索](/ja-JP/tools/grok-search) -- `web_search` プロバイダーとしてのGrok - [Ollama Web検索](/ja-JP/tools/ollama-search) -- Ollamaホスト経由のキー不要Web検索