Web araması

web_search, yapılandırılmış sağlayıcınızla web'de arama yapar ve sorguya göre 15 dakika boyunca önbelleğe alınan (yapılandırılabilir) normalleştirilmiş sonuçlar döndürür. OpenClaw ayrıca X (eski adıyla Twitter) gönderileri için x_search ve hafif URL getirme işlemleri için web_fetch araçlarını da içerir. web_fetch her zaman yerel olarak çalışır; sağlayıcı Grok olduğunda web_search, xAI Responses üzerinden yönlendirilir ve x_search her zaman xAI Responses kullanır.

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çimi

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

Otomatik algılama

Belgelerdeki ve kurulum akışlarındaki sağlayıcı listeleri alfabetik sıradadır. Otomatik algılama ayrı, sabit bir öncelik sırası kullanır ve yalnızca yapılandırılmış olduğunu tespit ettiği, kimlik bilgisi gerektiren (requiresCredential !== false) bir sağlayıcıyı seçer. provider ayarlanmamışsa OpenClaw, sağlayıcıları aşağıdaki sırayla denetler 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 Arama -- 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 uç noktasını 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 aracılığıyla ücretli Parallel Arama API'si; isteğe bağlı plugins.entries.parallel.config.webSearch.baseUrl, uç noktayı geçersiz kılar (sıra 75)

Bunların ardından yapılandırılmış uç nokta sağlayıcıları:

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

Parallel Arama (Ücretsiz), DuckDuckGo, Ollama Web Araması ve Codex Barındırılan Arama gibi anahtarsız sağlayıcılar, dâhilî bir sıra değerine sahip olsalar bile otomatik algılamada hiçbir zaman seçilmez. Bunlar yalnızca tools.web.search.provider ile veya openclaw configure --section web üzerinden açıkça seçtiğinizde kullanılır. OpenClaw, yalnızca API destekli bir sağlayıcı yapılandırılmadığı için 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 (aşağıya bakın). Bunları bunun yerine 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.

Yerel OpenAI web araması

Doğrudan OpenAI Responses modelleri (api: "openai-responses", sağlayıcı openai, temel URL yok veya resmi bir OpenAI API temel URL'si), OpenClaw web araması etkinleştirildiğinde ve yönetilen bir sağlayıcı sabitlenmediğinde OpenAI'ın barındırılan web_search aracını otomatik olarak kullanır. Bu, paketle gelen OpenAI pluginindeki sağlayıcıya ait bir davranıştır ve OpenAI uyumlu proxy temel URL'leri veya Azure rotaları için geçerli değildir. OpenAI modellerinde yönetilen web_search aracını kullanmayı sürdürmek için 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 değerini ayarlayın.

Yerel Codex web araması

Codex uygulama sunucusu çalışma zamanı, web araması etkinleştirildiğinde 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 dinamik web_search aracı birbirini dışlar; dolayısıyla yönetilen arama, yerel alan adı kısıtlamalarını aşamaz. Barındırılan arama kullanılamadığında, açıkça devre dışı bırakıldığında veya seçilmiş bir yönetilen sağlayıcıyla değiştirildiğinde OpenClaw 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 (features.standalone_web_search: false).

• Yerel aramayı tools.web.search.openaiCodex altında yapılandırın
• Codex Hosted Search'ü herhangi bir üst model için yönetilen web_search sağlayıcısı olarak hazırlamak üzere tools.web.search.provider: "codex" değerini 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 üretmezse başarısız olur.
• mode: "cached" varsayılan tercihtir ancak Codex, kısıtlanmamış uygulama sunucusu turlarında bunu canlı harici erişime çözümler; canlı erişimi açıkça istemek için "live" değerini 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 aramayı kullanmamak için tools.web.search.openaiCodex.enabled: false değerini ayarlayın; diğer yönetilen sağlayıcılar kullanılabilir durumda kalır
• Codex'in yerel araç yüzeyini kısıtlamak, yönetilen web_search aracını da kullanılabilir durumda tutar
• allowedDomains ayarlandığında, yerel izin listesinin aşılamaması için barındırılan arama kullanılamıyorsa otomatik yönetilen geri dönüş güvenli biçimde başarısız olur
• Araçların devre dışı bırakıldığı, yalnızca LLM kullanılan ç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ı ve etkin Codex arama politikası değişiklikleri, önceden yüklenmiş bir uygulama sunucusu iş parçacığının eski barındırılan arama erişimini koruyamaması için yeni bir bağlı iş parçacığı başlatır. Tur başına geçici kısıtlamalar, geçici ve kısıtlı bir iş parçacığı kullanır ve daha sonra devam etmek üzere mevcut bağlantıyı korur.

Doğrudan OpenAI ChatGPT Responses trafiği de OpenAI'ın barındırılan web_search aracını kullanabilir. Bu ayrı yol, tools.web.search.openaiCodex.enabled: true aracılığıyla isteğe bağlı kalır ve yalnızca api: "openai-chatgpt-responses" kullanan uygun openai/* modelleri için geçerlidir.

{  tools: {    web: {      search: {        enabled: true,        // İsteğe bağlı: Codex Hosted Search'ü Codex olmayan üst modellerden de kullanın.        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 özgü ağ denetimlerine ihtiyaç duyduğunuzda açıkça bir yönetilen sağlayıcı kullanın.

provider: "codex" seçmek, paketle gelen codex pluginini etkinleştirir ve yukarıda gösterilen aynı tools.web.search.openaiCodex kısıtlamalarını kullanır. Önce openclaw models auth login --provider openai ile Codex uygulama sunucusunda kimlik doğrulayın. Üst aracı herhangi bir modeli veya çalışma zamanını kullanabilir; yalnızca sınırlandırılmış arama çalışanı Codex üzerinden çalışır.

Ağ güvenliği

Yönetilen HTTP web_search sağlayıcı çağrıları, geçerli sağlayıcının kendi ana makine adıyla sınırlandırılmış OpenClaw korumalı getirme yolunu kullanır. OpenClaw yalnızca bu ana makine adı için 198.18.0.0/15 ve fc00::/7 aralıklarındaki Surge, Clash ve sing-box sahte IP DNS yanıtlarına izin verir. Diğer özel, loopback, bağlantıya yerel ve meta veri hedefleri engellenmeye devam eder. Codex Hosted Search istisnadır: sınırlandırılmış çalışanı ağ erişimini Codex uygulama sunucusunun 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 yapay aralıkların sahibiyse tools.web.fetch.ssrfPolicy.allowRfc2544BenchmarkRange ve tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRange ayarlarını açıkça etkinleştirin.

Yapılandırma

{  tools: {    web: {      search: {        enabled: true, // varsayılan: true        provider: "brave", // veya otomatik algılama için belirtmeyin        maxResults: 5,        timeoutSeconds: 30,        cacheTtlMinutes: 15,      },    },  },}

Sağlayıcıya özgü yapılandırma (API anahtarları, temel URL'ler, modlar) plugins.entries.<plugin>.config.webSearch.* altında bulunur. Gemini ayrıca kendisine ayrılmış web araması yapılandırması ve GEMINI_API_KEY sonrasında daha düşük öncelikli geri dönüş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 komutundan bir xAI OAuth kimlik doğrulama profilini yeniden kullanabilir; API anahtarı yapılandırması geri dönüş seçeneği olarak kalır.

tools.web.search.provider, paketle gelen ve yüklü plugin bildirimlerinde tanımlanan web araması sağlayıcı kimliklerine göre doğrulanır. "brvae" gibi bir yazım hatası, sessizce otomatik algılamaya geri dönmek yerine yapılandırma doğrulamasının başarısız olmasına neden olur. Yapılandırılmış bir sağlayıcının yalnızca eski plugin kanıtları varsa (örneğin üçüncü taraf bir plugin kaldırıldıktan sonra geride kalan bir plugins.entries.<plugin> bloğu), OpenClaw başlangıcın dayanıklılığını korur ve plugini yeniden yükleyebilmeniz veya eski yapılandırmayı temizlemek için openclaw doctor --fix çalıştırabilmeniz amacıyla bir uyarı bildirir.

web_fetch geri dönüş sağlayıcısının seçimi ayrıdır:

• tools.web.fetch.provider ile seçin
• veya bu alanı belirtmeyin ve OpenClaw'ın yapılandırılmış kimlik bilgileri arasından hazır olan ilk web getirme sağlayıcısını otomatik olarak algılamasına izin verin
• korumalı alanda çalışmayan web_fetch, contracts.webFetchProviders tanımlayan yüklü plugin sağlayıcılarını kullanabilir; korumalı alandaki getirmeler paketle gelen sağlayıcılara ve doğrulanmış resmi plugin kurulumlarına izin verir ancak harici üçüncü taraf pluginlerini hariç tutar
• resmi Firecrawl plugini günümüzde paketle gelen tek webFetchProviders katkı sağlayıcısıdır ve plugins.entries.firecrawl.config.webFetch.* altında yapılandırılır

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.* ayarını yapılandırın. Bu, sohbetle aynı xAI kimlik doğrulama profilini veya Grok web aramasının kullandığı 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 taşınır. openclaw onboard veya openclaw configure --section web sırasında Grok'u seçtiğinizde OpenClaw, Grok kurulumu tamamlandıktan hemen sonra aynı kimlik bilgisiyle isteğe bağlı x_search kurulumunu da sunar. Bu, ayrı bir üst düzey web araması sağlayıcısı seçimi değil, Grok yolu içindeki ayrı bir devam adımıdır. 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 yapay zekâ 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ı kalıcı olarak kayıtlı tutmak yerine her istek için oluşturur; bu nedenle araç yalnızca gerçekten çağrıldığı turda etkindir.

x_search yapılandırması

enabled belirtilmediğinde x_search, yalnızca etkin modelin sağlayıcısı xai olduğunda ve xAI kimlik bilgileri çözümlenebildiğinde kullanıma sunulur. Sağlayıcısı bilinen ve xAI olmayan etkin bir model için sağlayıcılar arası kullanımı etkinleştirmek üzere plugins.entries.xai.config.xSearch.enabled değerini true olarak ayarlayın. Etkin model sağlayıcısı eksikse veya çözümlenemiyorsa araç gizli kalır. Aracı tüm sağlayıcılarda devre dışı bırakmak için enabled değerini false olarak ayarlayın. xAI kimlik bilgileri her zaman gereklidir.

{  plugins: {    entries: {      xai: {        config: {          xSearch: {            enabled: true, // required for a known non-xAI model provider            model: "grok-4.3",            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 POST isteği gönderir. Bu alan belirtilmezse sırasıyla plugins.entries.xai.config.webSearch.baseUrl, eski tools.web.search.grok.baseUrl ve son olarak genel xAI uç noktası (https://api.x.ai/v1) kullanılır.

x_search parametreleri

allowed_x_handles ve excluded_x_handles birlikte kullanılamaz.

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'yi getirir ve okunabilir içeriği çıkarır
• Web Tarayıcısı -- JavaScript ağırlıklı siteler için tam tarayıcı otomasyonu
• Grok Araması -- web_search sağlayıcısı olarak Grok
• Ollama Web Araması -- Ollama sunucunuz üzerinden anahtar gerektirmeyen web araması