Recherche Web

​

Démarrage rapide

openclaw configure --section web

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

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

​

Choisir un fournisseur

​

Comparaison des fournisseurs

​

Détection automatique

​

Recherche Web OpenAI native

​

Recherche Web Codex native

• Configurez la recherche native sous tools.web.search.openaiCodex
• Définissez tools.web.search.provider: "codex" pour provisionner Codex Hosted Search comme fournisseur web_search géré pour n’importe quel modèle parent. Chaque appel exécute un tour éphémère borné du serveur d’application Codex et échoue si Codex n’émet pas un élément webSearch hébergé.
• mode: "cached" est la préférence par défaut, mais Codex la résout en accès externe en direct pour les tours de serveur d’application sans restriction ; définissez "live" pour demander explicitement un accès en direct
• Définissez tools.web.search.provider sur un fournisseur géré tel que brave pour utiliser le web_search géré par OpenClaw à la place
• Définissez tools.web.search.openaiCodex.enabled: false pour désactiver la recherche hébergée par Codex ; les autres fournisseurs gérés restent disponibles
• Restreindre la surface d’outil native de Codex maintient également web_search géré disponible
• Lorsque allowedDomains est défini, la solution de repli gérée automatique échoue de façon fermée si la recherche hébergée est indisponible, afin que la liste d’autorisation native ne puisse pas être contournée
• Les exécutions LLM uniquement avec outils désactivés désactivent à la fois la recherche native et gérée
• tools.web.search.enabled: false désactive à la fois la recherche gérée et native

{
  tools: {
    web: {
      search: {
        enabled: true,
        // Optional: use Codex Hosted Search from non-Codex parent models too.
        provider: "codex",
        openaiCodex: {
          enabled: true,
          mode: "cached",
          allowedDomains: ["example.com"],
          contextSize: "high",
          userLocation: {
            country: "US",
            city: "New York",
            timezone: "America/New_York",
          },
        },
      },
    },
  },
}

​

Sécurité réseau

​

Configuration de la recherche web

1. Brave — BRAVE_API_KEY ou plugins.entries.brave.config.webSearch.apiKey (ordre 10)
2. MiniMax Search — MINIMAX_CODE_PLAN_KEY / MINIMAX_CODING_API_KEY / MINIMAX_OAUTH_TOKEN / MINIMAX_API_KEY ou plugins.entries.minimax.config.webSearch.apiKey (ordre 15)
3. Gemini — plugins.entries.google.config.webSearch.apiKey, GEMINI_API_KEY ou models.providers.google.apiKey (ordre 20)
4. Grok — xAI OAuth, XAI_API_KEY ou plugins.entries.xai.config.webSearch.apiKey (ordre 30)
5. Kimi — KIMI_API_KEY / MOONSHOT_API_KEY ou plugins.entries.moonshot.config.webSearch.apiKey (ordre 40)
6. Perplexity — PERPLEXITY_API_KEY / OPENROUTER_API_KEY ou plugins.entries.perplexity.config.webSearch.apiKey (ordre 50)
7. Firecrawl — FIRECRAWL_API_KEY ou plugins.entries.firecrawl.config.webSearch.apiKey (ordre 60)
8. Exa — EXA_API_KEY ou plugins.entries.exa.config.webSearch.apiKey ; plugins.entries.exa.config.webSearch.baseUrl facultatif remplace le point de terminaison Exa (ordre 65)
9. Tavily — TAVILY_API_KEY ou plugins.entries.tavily.config.webSearch.apiKey (ordre 70)
10. Parallel — API Parallel Search payante via PARALLEL_API_KEY ou plugins.entries.parallel.config.webSearch.apiKey ; plugins.entries.parallel.config.webSearch.baseUrl facultatif remplace le point de terminaison (ordre 75)

11. SearXNG — SEARXNG_BASE_URL ou plugins.entries.searxng.config.webSearch.baseUrl (ordre 200)

​

Configuration

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

• choisissez-le avec tools.web.fetch.provider
• ou omettez ce champ et laissez OpenClaw auto-détecter le premier fournisseur web-fetch prêt à partir des identifiants configurés
• web_fetch non sandboxé peut utiliser les fournisseurs de plugins installés qui déclarent contracts.webFetchProviders ; les fetches sandboxés autorisent les fournisseurs groupés et les installations vérifiées de plugins officiels, mais excluent les plugins externes tiers
• le plugin officiel Firecrawl fournit le repli web-fetch, configuré sous plugins.entries.firecrawl.config.webFetch.*

• la région de l’API Moonshot (https://api.moonshot.ai/v1 ou https://api.moonshot.cn/v1)
• le modèle de recherche web Kimi par défaut (par défaut kimi-k2.6)

​

Stockage des clés d’API

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

export BRAVE_API_KEY="YOUR_KEY"

​

Paramètres de l’outil

​

x_search

​

Configuration de 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
          },
        },
      },
    },
  },
}

​

Paramètres de x_search

​

Exemple 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",
});

​

Exemples

// 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"],
});

​

Profils d’outils

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

​

Associés

• Récupération Web — récupérer une URL et extraire le contenu lisible
• Navigateur Web — automatisation complète du navigateur pour les sites fortement dépendants de JS
• Recherche Grok — Grok comme fournisseur de web_search
• Recherche Web Ollama — recherche Web sans clé via votre hôte Ollama