ウェブ検索

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 の保護された fetch パスを使用します。 信頼済みプロバイダー 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 プロバイダーの bearer auth を再利用でき、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 で選択します
• またはそのフィールドを省略し、OpenClaw に利用可能な認証情報から最初に準備済みの Web 取得プロバイダーを自動検出させます
• サンドボックス化されていない 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.* を設定します。Grok Web 検索と同じ XAI_API_KEY フォールバックを使用します。 従来の 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 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 possible
await x_search({
  query: "https://x.com/huntharo/status/1905678901234567890",
});

# 例

// 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 を追加します。

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

# 関連

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