اگر میخواهید از قدرت مدلهای هوش مصنوعی xAI در پلتفرم Hermes Agent استفاده کنید، دیگر نیازی نیست ساعتها وقت بگذارید تا یک کلید API بسازید و هزینههای سنگین پرداختی را مدیریت کنید. راهحل ساده این است که از اشتراکهای موجود خود مانند SuperGrok یا X Premium+ استفاده کنید. این روش نهتنها کار شما را آسانتر میکند، بلکه دسترسیتان را به ابزارهای رسانهای متنوع xAI مانند تولید تصویر، ویدیو و تبدیل متن به گفتار نیز باز میکند.
مکانیسم اتصال: چگونه Hermes با xAI صحبت میکند؟
در داخل سیستم Hermes، ارائهدهنده این سرویس به عنوان xAI Grok OAuth شناخته میشود که شناسه اختصاصی xai-oauth را دارد. وقتی از این روش استفاده میکنید، Hermes به جای ارسال درخواستهای مستقیم با کلید، از پروتکل OAuth2 استفاده میکند. شما یکبار از طریق مرورگر وارد میشوید، توکنها به صورت محلی ذخیره شده و در جلسات بعدی به طور خودکار بهروزرسانی میشوند. این فرآیند، مدل پیشفرض را روی grok-4.3 تنظیم میکند و ویژگیهایی مانند استدلال منطقی، فراخوانی ابزارها و پخش زنده خروجی را بدون نیاز به افزونههای اضافی فعال میسازد.
پیشنیازهای فنی برای شروع
- نصب پایتون نسخه ۳.۹ یا بالاتر
- نصب پکیج Hermes Agent روی سیستم شما
- داشتن اشتراک فعال SuperGrok یا X Premium+ برای حسابی که با آن وارد میشوید
- برای استفاده در سرورهای ریموت، راهاندازی پورت فورواردینگ SSH الزامی است
راهنمای گامبهگام ورود به سیستم
سادهترین روش، استفاده از دستور hermes model است. در لیست ارائهدهندهها، گزینه xAI Grok OAuth را انتخاب کنید. به محض تأیید، یک پنجره مرورگر باز میشود (معمولاً در آدرس accounts.x.ai). کافی است حساب خود را تأیید کنید و دسترسیها را بدهید. پس از بازگشت به ترمینال، میتوانید مدل دلخواه را انتخاب کرده و با دستور hermes شروع به چت کنید.
اگر مایلید مسیر سریعتری طی کنید و از گام انتخاب مدل سربزنید، میتوانید مستقیماً از دستور hermes auth add xai-oauth استفاده کنید. این فرمان همان فرآیند ورود مرورگری را آغاز میکند و پس از تکمیل، توکنها در فایل ~/.hermes/auth.json ذخیره میشوند.
تنظیم مدل پیشفرض به صورت دستی
برای تضمین اینکه همیشه از این روش استفاده شود، میتوانید تنظیمات را کد بزنید:
hermes config set model.default grok-4.3
hermes config set model.provider xai-oauthکار با سرورهای ریموت و چالشهای اتصال
کار با سرورهای ابری یا ریموت یک چالش کوچک دارد: مرورگر شما روی لپتاپ است، اما گوشهگیرنده (Callback) در سرور ریموت اجرا میشود. برای حل این مشکل، باید پورت ۵۶۱۲۱ را فوروارد کنید:
ssh -N -L 56121:127.0.0.1:56121 user@remote-hostسپس در ترمینال ریموت، از گزینه --no-browser استفاده کنید تا لینک ورود را چاپ کند، آن را در مرورگر لپتاپ باز کرده و فرآیند را تکمیل کنید.
اگر از محیطهای وببر پایه مانند Cloud Shell یا Codespaces استفاده میکنید که امکان SSH ندارند، از حالت چسبندنی (Paste) استفاده کنید: hermes auth add xai-oauth --manual-paste. این روش به شما اجازه میدهد لینک نهایی را کپی کرده و در همان پنجره وارد کنید.
دسترسی به ابزارهای رسانهای xAI
مزیت بزرگ این روش، یکپارچگی کامل است. همان توکن ورود به شما اجازه استفاده از ابزارهای تخصصی xAI را میدهد. با اجرای hermes tools میتوانید بکاندی را انتخاب کنید که از xAI TTS برای صدا، Grok Imagine برای تصویر و ویدیو، و X Search برای جستجو استفاده کند. توجه داشته باشید که تولید ویدیو به صورت پیشفرض غیرفعال است و باید آن را در تنظیمات ابزارها فعال کنید.
رفع مشکلات رایج
- خطای ۴۰۳ (Forbidden): اگر ورود انجام شد اما هنگام اجرا خطای ۴۰۳ گرفتید، احتمالاً سطح اشتراک شما اجازه استفاده از API OAuth را ندارد. در این حالت باید به سراغ کلید API روید.
- ایجاد ناهمزنگی (State Mismatch): معمولاً به دلیل تداخل نرمافزارهای جانبی مرورگر یا پروکسیهاست. دوباره وارد شوید.
- منقضی شدن توکن: اگر توکن جدیدی لازم است، فقط کافی است دستور
hermes auth add xai-oauthرا مجدداً اجرا کنید.
