جستجوی Gemini

OpenClaw از مدل‌های Gemini با زمینه‌سازی داخلی Google Search پشتیبانی می‌کند که پاسخ‌های تولیدشده توسط هوش مصنوعی را، با پشتوانه نتایج زنده Google Search و همراه با ارجاع‌ها، برمی‌گرداند.

# دریافت کلید API

openclaw configure --section web

# پیکربندی

{
  plugins: {
    entries: {
      google: {
        config: {
          webSearch: {
            apiKey: "AIza...", // optional if GEMINI_API_KEY or models.providers.google.apiKey is set
            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // optional; falls back to models.providers.google.baseUrl
            model: "gemini-2.5-flash", // default
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "gemini",
      },
    },
  },
}

اولویت اعتبارنامه‌ها: جست‌وجوی وب Gemini ابتدا از plugins.entries.google.config.webSearch.apiKey، سپس از GEMINI_API_KEY، و بعد از models.providers.google.apiKey استفاده می‌کند. برای URLهای پایه، مقدار اختصاصی plugins.entries.google.config.webSearch.baseUrl پیش از models.providers.google.baseUrl اولویت دارد.

برای نصب Gateway، کلیدهای محیطی را در ~/.openclaw/.env قرار دهید.

# نحوه کارکرد

برخلاف ارائه‌دهندگان جست‌وجوی سنتی که فهرستی از پیوندها و قطعه‌متن‌ها برمی‌گردانند، Gemini از زمینه‌سازی Google Search برای تولید پاسخ‌های ساخته‌شده توسط هوش مصنوعی با ارجاع‌های درون‌خطی استفاده می‌کند. نتایج شامل هم پاسخ تولیدشده و هم URLهای منبع هستند.

• URLهای ارجاع از زمینه‌سازی Gemini به‌طور خودکار از URLهای بازهدایت Google به URLهای مستقیم تبدیل می‌شوند.
• حل بازهدایت پیش از برگرداندن URL نهایی ارجاع، از مسیر محافظ SSRF استفاده می‌کند (HEAD + بررسی‌های بازهدایت + اعتبارسنجی http/https).
• حل بازهدایت از پیش‌فرض‌های سخت‌گیرانه SSRF استفاده می‌کند، بنابراین بازهدایت به مقصدهای خصوصی/داخلی مسدود می‌شود.

# پارامترهای پشتیبانی‌شده

جست‌وجوی Gemini از query، freshness، date_after و date_before پشتیبانی می‌کند.

count برای سازگاری مشترک با web_search پذیرفته می‌شود، اما زمینه‌سازی Gemini همچنان به‌جای فهرست N نتیجه‌ای، یک پاسخ تولیدشده همراه با ارجاع‌ها برمی‌گرداند.

freshness مقادیر day، week، month، year و میان‌برهای مشترک pd، pw، pm و py را می‌پذیرد. OpenClaw این مقادیر، یا یک بازه صریح date_after/date_before، را به timeRangeFilter مربوط به زمینه‌سازی Google Search در Gemini تبدیل می‌کند. country، language و domain_filter پشتیبانی نمی‌شوند.

# انتخاب مدل

مدل پیش‌فرض gemini-2.5-flash است (سریع و مقرون‌به‌صرفه). هر مدل Gemini که از زمینه‌سازی پشتیبانی کند می‌تواند از طریق plugins.entries.google.config.webSearch.model استفاده شود.

# بازنویسی URL پایه

وقتی جست‌وجوی وب Gemini باید از طریق پراکسی اپراتور یا نقطه پایانی سفارشی سازگار با Gemini مسیریابی شود، plugins.entries.google.config.webSearch.baseUrl را تنظیم کنید. اگر این مقدار تنظیم نشده باشد، جست‌وجوی وب Gemini دوباره از models.providers.google.baseUrl استفاده می‌کند. مقدار ساده https://generativelanguage.googleapis.com به https://generativelanguage.googleapis.com/v1beta نرمال‌سازی می‌شود؛ مسیرهای پراکسی سفارشی پس از حذف اسلش‌های پایانی، همان‌طور که ارائه شده‌اند نگه داشته می‌شوند.

# مرتبط

• نمای کلی جست‌وجوی وب -- همه ارائه‌دهندگان و تشخیص خودکار
• Brave Search -- نتایج ساختاریافته همراه با قطعه‌متن‌ها
• Perplexity Search -- نتایج ساختاریافته + استخراج محتوا