البحث في الويب

تبحث أداة web_search في الويب باستخدام المزوّد الذي قمت بتكوينه وتُرجع النتائج. تُخزَّن النتائج مؤقتًا حسب الاستعلام لمدة 15 دقيقة (قابلة للتكوين).

يتضمن OpenClaw أيضًا x_search لمنشورات X (المعروفة سابقًا باسم Twitter) وweb_fetch لجلب عناوين URL بصورة خفيفة. في هذه المرحلة، يبقى 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

تستخدم نماذج OpenAI Responses المباشرة أداة web_search المستضافة من OpenAI تلقائيًا عند تمكين بحث الويب في OpenClaw وعدم تثبيت مزوّد مُدار. هذا سلوك يملكه المزوّد في Plugin OpenAI المضمّن، وينطبق فقط على حركة API الأصلية لـ OpenAI، وليس على عناوين URL الأساسية للوكلاء المتوافقين مع OpenAI أو مسارات Azure. عيّن tools.web.search.provider إلى مزوّد آخر مثل brave للإبقاء على أداة web_search المُدارة لنماذج OpenAI، أو عيّن tools.web.search.enabled: false لتعطيل كل من البحث المُدار وبحث OpenAI الأصلي.

بحث الويب الأصلي من Codex

يمكن للنماذج القادرة على Codex اختياريًا استخدام أداة Responses الأصلية لدى المزوّد web_search بدلًا من دالة web_search المُدارة في OpenClaw.

• كوّنها ضمن 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. بالنسبة إلى مضيفي API الموثوقين للمزوّدين، يسمح OpenClaw بإجابات DNS المزيفة من Surge وClash وsing-box ضمن 198.18.0.0/15 وfc00::/7 فقط لاسم مضيف ذلك المزوّد. وتبقى الوجهات الخاصة الأخرى، وlocal loopback، والمحلية للرابط، ووجهات البيانات الوصفية محظورة.

لا ينطبق هذا السماح التلقائي على عناوين URL عشوائية في web_fetch. بالنسبة إلى web_fetch، فعّل tools.web.fetch.ssrfPolicy.allowRfc2544BenchmarkRange و tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRange صراحةً فقط عندما يملك وكيلك الموثوق تلك النطاقات الاصطناعية.

إعداد بحث الويب

تكون قوائم المزوّدين في التوثيق وتدفقات الإعداد مرتبة أبجديًا. يحتفظ الاكتشاف التلقائي بترتيب أسبقية منفصل.

إذا لم يتم تعيين 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 -- خيار HTML احتياطي بلا مفتاح ولا يحتاج إلى حساب أو مفتاح API (الترتيب 100)
11. Ollama Web Search -- خيار احتياطي بلا مفتاح عبر مضيف Ollama المحلي المكوّن لديك عندما يكون قابلًا للوصول ومسجل الدخول باستخدام ollama signin؛ يمكنه إعادة استخدام مصادقة bearer لمزوّد Ollama عندما يحتاجها المضيف، ويمكنه استدعاء البحث المباشر عبر https://ollama.com عند تكوينه باستخدام OLLAMA_API_KEY (الترتيب 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 أيضًا إعادة استخدام models.providers.google.apiKey وmodels.providers.google.baseUrl كبدائل ذات أولوية أدنى بعد إعداد بحث الويب المخصص له وGEMINI_API_KEY. راجع صفحات الموفّرين للاطلاع على أمثلة.

يتم التحقق من tools.web.search.provider مقابل معرّفات موفّري بحث الويب المعلنة في بيانات Plugin المضمنة والمثبتة. خطأ مطبعي مثل "brvae" يفشل تحقق الإعداد بدلًا من الرجوع بصمت إلى الاكتشاف التلقائي. إذا كان الموفّر المكوّن لا يملك إلا دليل Plugin قديمًا، مثل كتلة plugins.entries.<plugin> متبقية بعد إلغاء تثبيت Plugin تابع لجهة خارجية، يحافظ OpenClaw على مرونة بدء التشغيل ويبلغ عن تحذير لتتمكن من إعادة تثبيت Plugin أو تشغيل openclaw doctor --fix لتنظيف الإعداد القديم.

اختيار موفّر الرجوع الاحتياطي لـ web_fetch منفصل:

• اختره باستخدام tools.web.fetch.provider
• أو احذف هذا الحقل ودع OpenClaw يكتشف تلقائيًا أول موفّر web-fetch جاهز من بيانات الاعتماد المتاحة
• يمكن لـ web_fetch غير المعزول استخدام موفّري Plugin المثبتين الذين يعلنون contracts.webFetchProviders؛ تبقى عمليات الجلب المعزولة مقتصرة على المضمنة فقط
• اليوم موفّر web-fetch المضمن هو Firecrawl، ويُعدّ ضمن plugins.entries.firecrawl.config.webFetch.*

عندما تختار Kimi أثناء openclaw onboard أو openclaw configure --section web، يمكن لـ OpenClaw أيضًا طلب:

• منطقة Moonshot API (https://api.moonshot.ai/v1 أو https://api.moonshot.cn/v1)
• نموذج بحث الويب الافتراضي لـ Kimi (الافتراضي هو kimi-k2.6)

بالنسبة إلى x_search، اضبط plugins.entries.xai.config.xSearch.*. يستخدم ملف تعريف مصادقة xAI نفسه المستخدم للدردشة، أو بيانات اعتماد XAI_API_KEY / بحث الويب الخاصة بـ Plugin والمستخدمة بواسطة بحث الويب في Grok. يتم ترحيل إعداد tools.web.x_search.* القديم تلقائيًا بواسطة openclaw doctor --fix. عندما تختار Grok أثناء openclaw onboard أو openclaw configure --section web، يمكن لـ OpenClaw أيضًا تقديم إعداد اختياري لـ x_search بالمفتاح نفسه. هذه خطوة متابعة منفصلة داخل مسار Grok، وليست اختيارًا منفصلًا على المستوى الأعلى لموفّر بحث الويب. إذا اخترت موفّرًا آخر، فلن يعرض 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 منشورات X (تويتر سابقًا) باستخدام xAI ويعيد إجابات مركبة بالذكاء الاصطناعي مع استشهادات. يقبل استعلامات باللغة الطبيعية ومرشحات مهيكلة اختيارية. يفعّل 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 an xAI auth profile or XAI_API_KEY is set            baseUrl: "https://api.x.ai/v1", // optional shared xAI Responses base URL          },        },      },    },  },}

ينشر x_search إلى <baseUrl>/responses عندما يكون plugins.entries.xai.config.xSearch.baseUrl مضبوطًا. إذا حُذف ذلك الحقل، فإنه يرجع إلى 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 possibleawait x_search({  query: "https://x.com/huntharo/status/1905678901234567890",});

أمثلة

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

ملفات تعريف الأدوات

إذا كنت تستخدم ملفات تعريف الأدوات أو قوائم السماح، فأضف 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 -- أتمتة متصفح كاملة للمواقع كثيفة JavaScript
• Grok Search -- Grok كموفّر web_search
• Ollama Web Search -- بحث ويب بلا مفتاح عبر مضيف Ollama الخاص بك