Tools
جستوجوی 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 همراه با نشانی دقیق پست یا شناسهٔ وضعیت استفاده کنید.
راهاندازی اولیه و پیکربندی
انتخاب 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
استفاده از OAuth xAI
اگر پیشتر هنگام راهاندازی اولیه یا احراز هویت مدل وارد xAI شدهاید،
Grok را بهعنوان ارائهدهندهٔ web_search انتخاب کنید. به کلید API جداگانهای نیاز نیست:
openclaw onboard --auth-choice xai-oauthopenclaw config set tools.web.search.provider grokاستفاده از کلید API جایگزین
هنگامی که OAuth در دسترس نیست یا عمداً میخواهید پیکربندی جستوجوی وب بر کلید متکی باشد، یک کلید API از xAI دریافت کنید.
ذخیرهکردن کلید
XAI_API_KEY را در محیط Gateway تنظیم کنید، یا از طریق دستور زیر پیکربندی کنید:
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 پشتیبانی میکند. برای سازگاری مشترک با web_search، پارامتر count پذیرفته میشود، اما Grok همیشه بهجای فهرستی با N نتیجه، یک پاسخ ترکیبشده همراه با ارجاعات برمیگرداند. پالایههای مختص ارائهدهنده پشتیبانی نمیشوند.
مهلت زمانی پیشفرض Grok برابر با ۶۰ ثانیه است، زیرا جستوجوهای Responses مبتنی بر دادههای وب xAI ممکن است بیشتر از مهلت زمانی پیشفرض مشترک web_search طول بکشند. آن را با tools.web.search.timeoutSeconds بازنویسی کنید.
بازنویسی نشانی پایه
برای هدایت جستوجوی وب Grok از طریق پراکسی اپراتور یا نقطهٔ پایانی Responses سازگار با xAI، مقدار plugins.entries.xai.config.webSearch.baseUrl را تنظیم کنید. OpenClaw پس از حذف ممیزهای انتهایی، درخواست را به <baseUrl>/responses ارسال میکند. اگر plugins.entries.xai.config.xSearch.baseUrl تنظیم نشده باشد، x_search از همان webSearch.baseUrl بهعنوان گزینهٔ جایگزین استفاده میکند.
مرتبط
- نمای کلی جستوجوی وب -- همهٔ ارائهدهندگان و تشخیص خودکار
x_searchدر جستوجوی وب -- جستوجوی درجهیک X از طریق xAI- جستوجوی Gemini -- پاسخهای ترکیبشده بهوسیلهٔ هوش مصنوعی از طریق زمینهسازی Google