جست‌وجوی Grok

OpenClaw از Grok به‌عنوان ارائه‌دهندهٔ web_search پشتیبانی می‌کند و با استفاده از پاسخ‌های xAI مبتنی بر وب، پاسخ‌های ترکیب‌شده با هوش مصنوعی را تولید می‌کند که با نتایج جست‌وجوی زنده و ارجاعات پشتیبانی می‌شوند.

جست‌وجوی وب Grok در صورت وجود، ورود OAuth فعلی xAI را ترجیح می‌دهد. اگر پروفایل OAuth وجود نداشته باشد، همان کلید API ‏xAI ابزار داخلی x_search را برای جست‌وجوی پست‌های X (توییتر سابق) و ابزار code_execution نیز راه‌اندازی می‌کند. ذخیره‌کردن کلید در plugins.entries.xai.config.webSearch.apiKey همچنین به OpenClaw اجازه می‌دهد آن را به‌عنوان گزینهٔ پشتیبان برای ارائه‌دهندهٔ مدل xAI همراه برنامه دوباره استفاده کند.

برای معیارهای X در سطح پست (بازنشرها، پاسخ‌ها، نشانک‌ها، بازدیدها)، به‌جای یک عبارت جست‌وجوی گسترده، از x_search با URL دقیق پست یا شناسهٔ وضعیت استفاده کنید.

راه‌اندازی اولیه و پیکربندی

انتخاب Grok هنگام openclaw onboard یا openclaw configure --section web به OpenClaw اجازه می‌دهد بدون درخواست کلید جداگانه برای جست‌وجوی وب، از پروفایل OAuth فعلی xAI دوباره استفاده کند. در نبود OAuth، به راه‌اندازی کلید API ‏xAI بازمی‌گردد.

سپس OpenClaw مرحله‌ای تکمیلی برای فعال‌کردن x_search با همان اعتبارنامهٔ xAI ارائه می‌دهد. این مرحلهٔ تکمیلی:

• فقط پس از انتخاب Grok برای web_search نمایش داده می‌شود
• یک گزینهٔ جداگانه و سطح‌بالا برای ارائه‌دهندهٔ جست‌وجوی وب نیست
• می‌تواند به‌صورت اختیاری مدل x_search را در همان فرایند تنظیم کند

برای فعال‌کردن یا تغییر x_search در آینده از طریق پیکربندی، از آن صرف‌نظر کنید.

ورود به حساب یا دریافت کلید API

openclaw onboard --auth-choice xai-oauthopenclaw config set tools.web.search.provider grok

openclaw configure --section web

پیکربندی

{  plugins: {    entries: {      xai: {        config: {          webSearch: {            apiKey: "xai-...", // در صورت وجود OAuth ‏xAI یا XAI_API_KEY اختیاری است            baseUrl: "https://api.x.ai/v1", // بازنویسی اختیاری نشانی پراکسی/پایهٔ Responses API          },        },      },    },  },  tools: {    web: {      search: {        provider: "grok",      },    },  },}

گزینه‌های جایگزین اعتبارنامه: openclaw models auth login --provider xai --method oauth،‏ XAI_API_KEY در محیط Gateway، یا plugins.entries.xai.config.webSearch.apiKey. برای نصب Gateway، متغیرهای محیطی را در ~/.openclaw/.env قرار دهید.

نحوهٔ کار

Grok از پاسخ‌های xAI مبتنی بر وب برای ترکیب پاسخ‌ها همراه با ارجاعات درون‌خطی استفاده می‌کند؛ مشابه رویکرد مبتنی‌سازی Google Search در Gemini.

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

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

مهلت زمانی پیش‌فرض Grok برابر با 60 ثانیه است، زیرا جست‌وجوهای مبتنی بر وب Responses ‏xAI ممکن است بیشتر از مقدار پیش‌فرض مشترک web_search طول بکشند. آن را با tools.web.search.timeoutSeconds بازنویسی کنید.

بازنویسی نشانی پایه

برای هدایت جست‌وجوی وب Grok از طریق پراکسی اپراتور یا نقطهٔ پایانی Responses سازگار با xAI، مقدار plugins.entries.xai.config.webSearch.baseUrl را تنظیم کنید. OpenClaw پس از حذف اسلش‌های انتهایی، درخواست را به <baseUrl>/responses ارسال می‌کند. x_search به همان webSearch.baseUrl بازمی‌گردد، مگر اینکه plugins.entries.xai.config.xSearch.baseUrl تنظیم شده باشد.

مرتبط

• نمای کلی جست‌وجوی وب -- همهٔ ارائه‌دهندگان و تشخیص خودکار
• x_search در جست‌وجوی وب -- جست‌وجوی درجه‌یک X از طریق xAI
• جست‌وجوی Gemini -- پاسخ‌های ترکیب‌شده با هوش مصنوعی از طریق مبتنی‌سازی Google