Web araması

web_search aracı, yapılandırdığınız sağlayıcıyı kullanarak web'de arama yapar ve sonuçları döndürür. Sonuçlar sorguya göre 15 dakika boyunca önbelleğe alınır (yapılandırılabilir).

OpenClaw ayrıca X (eski adıyla Twitter) gönderileri için x_search ve hafif URL getirme için web_fetch içerir. Bu aşamada web_fetch yerel kalırken web_search ve x_search perde arkasında xAI Responses kullanabilir.

Hızlı başlangıç

openclaw configure --section web

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

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

Sağlayıcı seçme

Sağlayıcı karşılaştırması

Otomatik algılama

Yerel OpenAI web araması

Doğrudan OpenAI Responses modelleri, OpenClaw web araması etkinleştirildiğinde ve yönetilen bir sağlayıcı sabitlenmediğinde OpenAI'in barındırılan web_search aracını otomatik olarak kullanır. Bu, paketlenmiş OpenAI Plugin içindeki sağlayıcıya ait davranıştır ve yalnızca yerel OpenAI API trafiği için geçerlidir; OpenAI uyumlu proxy temel URL'leri veya Azure rotaları için geçerli değildir. OpenAI modelleri için yönetilen web_search aracını korumak üzere tools.web.search.provider değerini brave gibi başka bir sağlayıcıya ayarlayın veya hem yönetilen aramayı hem de yerel OpenAI aramasını devre dışı bırakmak için tools.web.search.enabled: false ayarlayın.

Yerel Codex web araması

Codex uygulama sunucusu çalışma zamanı, web araması etkin olduğunda ve yönetilen bir sağlayıcı seçilmediğinde Codex'in barındırılan web_search aracını otomatik olarak kullanır. Yerel barındırılan arama ile OpenClaw'ın yönetilen web_search dinamik aracı birbirini dışlar, bu nedenle yönetilen arama yerel alan adı kısıtlamalarını atlayamaz. OpenClaw, barındırılan arama kullanılamadığında, açıkça devre dışı bırakıldığında veya seçili bir yönetilen sağlayıcıyla değiştirildiğinde yönetilen aracı kullanır. OpenClaw, üretim uygulama sunucusu trafiği kullanıcı tanımlı web ad alanını reddettiği için Codex'in bağımsız web.run uzantısını devre dışı tutar.

• Yerel aramayı tools.web.search.openaiCodex altında yapılandırın
• Herhangi bir üst model için yönetilen web_search sağlayıcısı olarak Codex Hosted Search sağlamak üzere tools.web.search.provider: "codex" ayarlayın. Her çağrı, sınırlandırılmış geçici bir Codex uygulama sunucusu turu çalıştırır ve Codex barındırılan bir webSearch öğesi yaymazsa başarısız olur.
• mode: "cached" varsayılan tercihtir, ancak Codex bunu kısıtlanmamış uygulama sunucusu turları için canlı dış erişime çözer; canlı erişimi açıkça istemek için "live" ayarlayın
• Bunun yerine OpenClaw'ın yönetilen web_search aracını kullanmak için tools.web.search.provider değerini brave gibi yönetilen bir sağlayıcıya ayarlayın
• Codex tarafından barındırılan aramadan çıkmak için tools.web.search.openaiCodex.enabled: false ayarlayın; diğer yönetilen sağlayıcılar kullanılabilir kalır
• Codex yerel araç yüzeyini kısıtlamak, yönetilen web_search aracını da kullanılabilir tutar
• allowedDomains ayarlandığında, barındırılan arama kullanılamazsa otomatik yönetilen geri dönüş kapalı başarısız olur; böylece yerel izin verilenler listesi atlanamaz
• Araçları devre dışı bırakılmış yalnızca LLM çalıştırmaları hem yerel hem de yönetilen aramayı devre dışı bırakır
• tools.web.search.enabled: false hem yönetilen hem de yerel aramayı devre dışı bırakır

Kalıcı etkili Codex arama ilkesi değişiklikleri, zaten yüklenmiş bir uygulama sunucusu iş parçacığının bayat barındırılan arama erişimini koruyamaması için yeni bir bağlı iş parçacığı başlatır. Geçici tur başına kısıtlamalar, geçici kısıtlı bir iş parçacığı kullanır ve daha sonra sürdürmek için mevcut bağlamayı korur.

Doğrudan OpenAI ChatGPT Responses trafiği de OpenAI'in barındırılan web_search aracını kullanabilir. Bu ayrı yol, tools.web.search.openaiCodex.enabled: true üzerinden tercihli kullanım olarak kalır ve yalnızca api: "openai-chatgpt-responses" kullanan uygun openai/* modellerine uygulanır.

{  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",          },        },      },    },  },}

Yerel Codex aramasını desteklemeyen çalışma zamanları ve sağlayıcılar için Codex, OpenClaw'ın dinamik araç ad alanı üzerinden yönetilen web_search geri dönüşünü kullanabilir. Codex tarafından barındırılan arama yerine OpenClaw'ın sağlayıcıya özel ağ denetimlerine ihtiyaç duyduğunuzda açık bir yönetilen sağlayıcı kullanın.

provider: "codex" seçildiğinde birlikte gelen codex Plugin'i etkinleştirilir ve yukarıda gösterilen aynı tools.web.search.openaiCodex kısıtlamaları kullanılır. Önce Codex app-server kimliğini openclaw models auth login --provider openai ile doğrulayın. Üst agent herhangi bir modeli veya runtime'ı kullanabilir; yalnızca sınırlandırılmış arama worker'ı Codex üzerinden çalışır.

Ağ güvenliği

Yönetilen HTTP web_search sağlayıcı çağrıları OpenClaw'ın korumalı fetch yolunu kullanır. Güvenilir sağlayıcı API host'ları için OpenClaw, Surge, Clash ve sing-box fake-IP DNS yanıtlarına 198.18.0.0/15 ve fc00::/7 aralıklarında yalnızca ilgili sağlayıcı hostname'i için izin verir. Diğer özel, loopback, link-local ve metadata hedefleri engellenmiş kalır. Codex Hosted Search istisnadır: sınırlandırılmış worker'ı ağ erişimini Codex app-server'ın barındırılan web_search aracına devreder.

Bu otomatik izin, rastgele web_fetch URL'leri için geçerli değildir. web_fetch için, yalnızca güvenilir proxy'niz bu sentetik aralıkların sahibiyse tools.web.fetch.ssrfPolicy.allowRfc2544BenchmarkRange ve tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRange ayarlarını açıkça etkinleştirin.

Web aramasını ayarlama

Dokümanlardaki ve kurulum akışlarındaki sağlayıcı listeleri alfabetiktir. Otomatik algılama ayrı bir öncelik sırası kullanır.

Hiçbir provider ayarlanmamışsa OpenClaw sağlayıcıları şu sırayla kontrol eder ve hazır olan ilkini kullanır:

Önce API destekli sağlayıcılar:

1. Brave -- BRAVE_API_KEY veya plugins.entries.brave.config.webSearch.apiKey (sıra 10)
2. MiniMax Search -- MINIMAX_CODE_PLAN_KEY / MINIMAX_CODING_API_KEY / MINIMAX_OAUTH_TOKEN / MINIMAX_API_KEY veya plugins.entries.minimax.config.webSearch.apiKey (sıra 15)
3. Gemini -- plugins.entries.google.config.webSearch.apiKey, GEMINI_API_KEY veya models.providers.google.apiKey (sıra 20)
4. Grok -- xAI OAuth, XAI_API_KEY veya plugins.entries.xai.config.webSearch.apiKey (sıra 30)
5. Kimi -- KIMI_API_KEY / MOONSHOT_API_KEY veya plugins.entries.moonshot.config.webSearch.apiKey (sıra 40)
6. Perplexity -- PERPLEXITY_API_KEY / OPENROUTER_API_KEY veya plugins.entries.perplexity.config.webSearch.apiKey (sıra 50)
7. Firecrawl -- FIRECRAWL_API_KEY veya plugins.entries.firecrawl.config.webSearch.apiKey (sıra 60)
8. Exa -- EXA_API_KEY veya plugins.entries.exa.config.webSearch.apiKey; isteğe bağlı plugins.entries.exa.config.webSearch.baseUrl, Exa endpoint'ini geçersiz kılar (sıra 65)
9. Tavily -- TAVILY_API_KEY veya plugins.entries.tavily.config.webSearch.apiKey (sıra 70)
10. Parallel -- PARALLEL_API_KEY veya plugins.entries.parallel.config.webSearch.apiKey üzerinden ücretli Parallel Search API; isteğe bağlı plugins.entries.parallel.config.webSearch.baseUrl endpoint'i geçersiz kılar (sıra 75)

Ardından yapılandırılmış endpoint sağlayıcıları:

11. SearXNG -- SEARXNG_BASE_URL veya plugins.entries.searxng.config.webSearch.baseUrl (sıra 200)

Parallel Search (Free), DuckDuckGo, Ollama Web Search ve Codex Hosted Search gibi anahtarsız sağlayıcılar yalnızca tools.web.search.provider ile veya openclaw configure --section web üzerinden açıkça seçtiğinizde kullanılabilir. OpenClaw, API destekli hiçbir sağlayıcı yapılandırılmadı diye yönetilen web_search sorgularını anahtarsız bir sağlayıcıya göndermez.

OpenAI Responses modelleri bir istisnadır: tools.web.search.provider ayarlanmamışken yukarıdaki yönetilen sağlayıcılar yerine OpenAI'ın yerel web aramasını kullanırlar. Bunları yönetilen yol üzerinden yönlendirmek için tools.web.search.provider değerini parallel-free (veya başka bir sağlayıcı) olarak ayarlayın.

Yapılandırma

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

Sağlayıcıya özgü yapılandırma (API anahtarları, base URL'ler, modlar) plugins.entries.<plugin>.config.webSearch.* altında yer alır. Gemini ayrıca, özel web araması yapılandırması ve GEMINI_API_KEY sonrasında daha düşük öncelikli fallback'ler olarak models.providers.google.apiKey ve models.providers.google.baseUrl değerlerini yeniden kullanabilir. Örnekler için sağlayıcı sayfalarına bakın. Grok ayrıca openclaw models auth login --provider xai --method oauth içinden bir xAI OAuth kimlik doğrulama profilini yeniden kullanabilir; API anahtarı yapılandırması fallback olarak kalır.

tools.web.search.provider, birlikte gelen ve kurulu Plugin manifest'leri tarafından bildirilen web araması sağlayıcı kimliklerine göre doğrulanır. "brvae" gibi bir yazım hatası, sessizce otomatik algılamaya dönmek yerine yapılandırma doğrulamasında başarısız olur. Yapılandırılmış bir sağlayıcının yalnızca eski Plugin kanıtı varsa, örneğin üçüncü taraf bir Plugin kaldırıldıktan sonra geride kalan plugins.entries.<plugin> bloğu gibi, OpenClaw başlangıcı dayanıklı tutar ve Plugin'i yeniden kurabilmeniz veya eski yapılandırmayı temizlemek için openclaw doctor --fix çalıştırabilmeniz adına bir uyarı bildirir.

web_fetch fallback sağlayıcı seçimi ayrıdır:

• tools.web.fetch.provider ile seçin
• veya bu alanı atlayıp OpenClaw'ın yapılandırılmış kimlik bilgilerinden hazır olan ilk web-fetch sağlayıcısını otomatik algılamasına izin verin
• sandbox dışı web_fetch, contracts.webFetchProviders bildiren kurulu Plugin sağlayıcılarını kullanabilir; sandbox içi fetch'ler birlikte gelen sağlayıcılara ve doğrulanmış resmi Plugin kurulumlarına izin verir, ancak üçüncü taraf harici Plugin'leri hariç tutar
• resmi Firecrawl Plugin'i, plugins.entries.firecrawl.config.webFetch.* altında yapılandırılan web-fetch fallback'i sağlar

openclaw onboard veya openclaw configure --section web sırasında Kimi seçtiğinizde OpenClaw ayrıca şunları sorabilir:

• Moonshot API bölgesi (https://api.moonshot.ai/v1 veya https://api.moonshot.cn/v1)
• varsayılan Kimi web araması modeli (varsayılan kimi-k2.6)

x_search için plugins.entries.xai.config.xSearch.* yapılandırın. Sohbetle aynı xAI kimlik doğrulama profilini veya Grok web araması tarafından kullanılan XAI_API_KEY / Plugin web araması kimlik bilgisini kullanır. Eski tools.web.x_search.* yapılandırması openclaw doctor --fix tarafından otomatik olarak geçirilir. openclaw onboard veya openclaw configure --section web sırasında Grok seçtiğinizde, OpenClaw aynı kimlik bilgisiyle isteğe bağlı x_search kurulumu da sunabilir. Bu, Grok yolu içinde ayrı bir takip adımıdır; ayrı bir üst düzey web araması sağlayıcı seçimi değildir. Başka bir sağlayıcı seçerseniz OpenClaw x_search istemini göstermez.

API anahtarlarını saklama

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

export BRAVE_API_KEY="YOUR_KEY"

Araç parametreleri

x_search

x_search, xAI kullanarak X (eski adıyla Twitter) gönderilerini sorgular ve alıntılarla birlikte AI tarafından sentezlenmiş yanıtlar döndürür. Doğal dil sorgularını ve isteğe bağlı yapılandırılmış filtreleri kabul eder. OpenClaw, yerleşik xAI x_search aracını yalnızca bu araç çağrısını sunan istekte etkinleştirir.

x_search yapılandırması

{  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 ayarlandığında x_search, <baseUrl>/responses adresine gönderi yapar. Bu alan atlanırsa önce plugins.entries.xai.config.webSearch.baseUrl, ardından eski tools.web.search.grok.baseUrl ve son olarak genel xAI endpoint'i fallback olarak kullanılır.

x_search parametreleri

x_search örneği

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

Örnekler

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

Araç profilleri

Araç profilleri veya izin listeleri kullanıyorsanız web_search, x_search ya da group:web ekleyin:

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

İlgili

• Web Getirme -- bir URL getirir ve okunabilir içeriği çıkarır
• Web Tarayıcısı -- JS ağırlıklı siteler için tam tarayıcı otomasyonu
• Grok Araması -- web_search sağlayıcısı olarak Grok
• Ollama Web Araması -- Ollama ana makineniz üzerinden anahtarsız web araması