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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

البدء السريع

openclaw configure --section web

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

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

​

اختيار مزوّد

​

مقارنة المزوّدين

​

الاكتشاف التلقائي

​

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

​

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

• كوّنها ضمن 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",
          },
        },
      },
    },
  },
}

​

أمان الشبكة

​

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

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)

​

التكوين

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

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

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

​

تخزين مفاتيح API

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

export BRAVE_API_KEY="YOUR_KEY"

​

معاملات الأداة

​

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

​

مثال 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"],
});

​

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

{
  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 الخاص بك