جست‌وجوی 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های مستقیم تبدیل می‌شوند؛ این کار با یک درخواست HEAD از مسیر واکشی محافظت‌شده در برابر SSRF در OpenClaw انجام می‌شود (دنبال‌کردن تغییرمسیرها و اعتبارسنجی http/https).
• تبدیل تغییرمسیرها از پیش‌فرض‌های سخت‌گیرانهٔ SSRF استفاده می‌کند؛ بنابراین تغییرمسیر به مقصدهای خصوصی یا داخلی مسدود می‌شود.

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

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

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

freshness مقادیر day، week، month، year و میان‌برهای مشترک pd، pw، pm و py را می‌پذیرد. day/pd به‌جای تعیین یک بازهٔ سخت‌گیرانهٔ ۲۴ ساعته، یک دستور تازگی به پرس‌وجوی Gemini اضافه می‌کند. week، month، year و بازه‌های صریح date_after/date_before، مقدار timeRangeFilter قابلیت اتکای Gemini به Google Search را تنظیم می‌کنند. 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 -- نتایج ساخت‌یافته به‌همراه استخراج محتوا