جست‌وجوی Grok

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

جست‌وجوی وب Grok، در صورت موجود بودن، ورود OAuth فعلی xAI شما را ترجیح می‌دهد. اگر هیچ نمایه‌ی OAuth وجود نداشته باشد، همان کلید API xAI می‌تواند ابزار داخلی x_search را برای جست‌وجوی پست‌های X (که قبلاً Twitter بود) و ابزار 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-...", // optional if xAI OAuth or XAI_API_KEY is available            baseUrl: "https://api.x.ai/v1", // optional Responses API proxy/base URL override          },        },      },    },  },  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 مبتنی بر وب برای سنتز پاسخ‌ها با استنادهای درون‌خطی استفاده می‌کند؛ مشابه رویکرد مبتنی‌سازی Gemini با Google Search.

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

جست‌وجوی Grok از query پشتیبانی می‌کند.

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

فیلترهای ویژه‌ی ارائه‌دهنده در حال حاضر پشتیبانی نمی‌شوند.

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

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

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

مرتبط

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