میزبانی ایجنت و irouter

Hermes یا OpenClaw روی سرور ما در ایران یا خارج، یا روی سرور خودتان؛ و ابزار خط فرمان irouter.

Hermes و OpenClaw دو ایجنت متن‌باز شناخته‌شده‌اند، ساختهٔ توسعه‌دهنده‌های دیگر، نه ایران‌روتر. ما آن‌ها را برایتان نصب و آماده می‌کنیم: روی سروری که از طرف شما در ایران یا خارج راه می‌اندازیم، یا روی سرور خودتان. ایجنت کلید API اختصاصی خودش را دارد و هزینه‌ها به ریال از کیف پول کم می‌شود.

از کجا شروع کنم

  • ساختن ایجنت: ویزارد ساخت ایجنت (به‌زودی). هر انتخاب همان‌جا به ریال قیمت می‌خورد. بدون ورود هم می‌شود گشت و قیمت دید؛ برای سفارش وارد می‌شوید.
  • بعد از سفارش: در پنل، «ایجنت‌های من». وضعیت، هزینه و تمدید، پیام‌رسان‌ها، نشانی‌ها، دسترسی، کلید API و رویدادهای هر ایجنت همان‌جاست.
  • اندازه‌ها، قیمت‌ها و ترافیک همراه هر سرور: صفحهٔ میزبانی ایجنت (به‌زودی). این عددها را ما تعیین می‌کنیم و همان‌جا به‌روز نشان داده می‌شوند.

کجا اجرا می‌شود

سرورچه چیزی را باید بدانید
سرور ما در ایرانوقتی اینترنت بین‌الملل قطع است هم به ایران‌روتر وصل می‌ماند. تلگرام در ایران فیلتر است و از مسیر جایگزین می‌رود، پس راه اصلی گفتگو صفحهٔ وب یا بله است.
سرور ما در خارجاینترنت آزاد دارد و تلگرام مستقیم کار می‌کند. اگر ارتباط خارج با ایران قطع شود، تا وقتی برقرار نشده به ایران‌روتر نمی‌رسد.
سرور خودتانسروری نمی‌خرید؛ یک خط را در ترمینال سرور خودتان اجرا می‌کنید. اگر برای نصب روی سرور شما هزینه‌ای تعیین شده باشد، ویزارد آن را نشان می‌دهد.
  • شهر یا دیتاسنتر انتخاب نمی‌شود؛ فقط ایران یا خارج.
  • روی هر سرور فقط یک ایجنت نصب می‌شود.
  • روی سرور ما فعلاً کلید مدل خودتان پذیرفته نمی‌شود؛ آنجا کلید ایران‌روتر را انتخاب کنید.

نصب

روی سرور ما

کاری لازم نیست. ما سرور را راه می‌اندازیم و ایجنت با یک توکن یک‌بارمصرف نصب و به ایران‌روتر وصل می‌شود. پیشرفت کار را زنده در صفحهٔ همان ایجنت در پنل می‌بینید و لازم نیست صفحه را باز نگه دارید.

مبلغ دورهٔ اول هنگام سفارش روی کیف پول رزرو می‌شود و وقتی ایجنت آماده شد کسر می‌شود. اگر ایجنت هرگز آماده نشود، کامل برمی‌گردد.

روی سرور خودتان، با یک دستور

  1. بعد از سفارش، در صفحهٔ ایجنت در پنل «گرفتن دستور نصب» را بزنید.
  2. دستور را در ترمینال سرور اجرا کنید. نصب به دسترسی root نیاز دارد و sudo داخل خود دستور است:
Shell
curl -fsSL https://iranrouter.com/v1/agent/install.sh | sudo sh -s -- ire-...

پیشرفت نصب را زنده در همان صفحهٔ ایجنت می‌بینید.

  • توکن ire-… داخل دستور یک‌بارمصرف است و زود منقضی می‌شود؛ زمان انقضا کنار دستور نوشته شده. دستور فقط یک بار نشان داده می‌شود و فقط آخرین دستوری که گرفته‌اید کار می‌کند. اگر وقتش گذشت، دستور تازه بگیرید.
  • سرور باید Ubuntu 22.04، 24.04 یا 26.04، یا Debian 12 یا 13 باشد، با systemd، روی x86-64 یا arm64. با IR_FORCE=1 روی سیستم دیگری هم امتحان می‌کند، بدون اینکه آزموده باشیم.
  • نصب‌کننده فقط از خود ایران‌روتر دانلود می‌کند و sha256 هر فایل را با فهرست ما می‌سنجد؛ چیزی از GitHub، npm یا PyPI نمی‌گیرد.
  • نشانی‌های ایجنت به همان IP عمومی‌ای اشاره می‌کنند که سرور از آن نصب شده، و صفحهٔ وب ایجنت روی پورت ۴۴۳ همین سرور سرو می‌شود (پورت ۸۰ فقط به https می‌فرستد). پس این دو پورت باید آزاد و از بیرون باز باشند.

روی سرور خودتان، با SSH و به‌دست ما

اگر ما این راه را روشن کرده باشیم، در صفحهٔ ایجنت در پنل بخش «نصب با SSH، به‌دست ما» دیده می‌شود. نشانی سرور (IP عمومی یا نام دامنه) و کاربر را می‌دهید و ما یک بار با SSH وصل می‌شویم، همان نصب دستور بالا را اجرا می‌کنیم و بیرون می‌آییم. پیشرفت کار را زنده در همان صفحه و در رویدادهای ایجنت می‌بینید.

  • راه اول، کلید: بعد از ثبت، یک خط کلید عمومی می‌گیرید که در ‎~/.ssh/authorized_keys همان کاربر می‌گذارید. تا چند دقیقه هر ۳۰ ثانیه یک بار برای وصل شدن تلاش می‌کنیم.
  • راه دوم، رمز: رمز SSH همان کاربر را می‌دهید. فقط برای همان یک اتصال به کار می‌رود و بعد از آن جایی نگه داشته نمی‌شود. ورود با رمز فقط با روش password در sshd کار می‌کند؛ سروری که فقط keyboard-interactive می‌پذیرد باید راه کلید را برود.
  • بعد از نصب، کلید ما را خودمان پاک می‌کنیم و ثابتش می‌کنیم: دوباره با همان کلید وصل می‌شویم و سرور باید ما را رد کند. اثر انگشت کلیدهایی که در authorized_keys می‌ماند در رویدادهای ایجنت ثبت می‌شود. اگر پاک شدن ثابت نشود، رویدادها می‌گویند و از شما می‌خواهیم خط کلید ما را خودتان پاک کنید؛ کلید خصوصی‌اش همان لحظه پیش ما پاک شده است.
  • فقط پورت ۲۲. کاربر پیش‌فرض root است؛ کاربر دیگر باید sudo بدون رمز (sudo -n) داشته باشد.
  • اولین بار که وصل می‌شویم، اثر انگشت کلید خود سرور را نگه می‌داریم و اگر بعداً عوض شده باشد وصل نمی‌شویم. اگر سیستم‌عامل سرور را از نو نصب کرده‌اید، «سرورم را از نو نصب کرده‌ام» را بزنید.

کلید API ایجنت

  • هر ایجنت یک کلید API اختصاصی دارد که موقع نصب ساخته می‌شود. مصرفش مثل بقیهٔ کلیدهاست: از پلن یا کیف پول، همان که در ویزارد انتخاب کرده‌اید، و با سقف خرج روزانه اگر گذاشته باشید. با رسیدن به آن سقف، کلید ایجنت تا روز بعد جواب نمی‌گیرد.
  • روی سرور، کلید فقط در فایل تنظیمات ایجنت است که root و کاربر خود ایجنت می‌خوانند، و هیچ‌جا کامل نشان داده نمی‌شود.
  • باطل کردن: در صفحهٔ ایجنت «باطل کردن کلید»، یا روی خود سرور sudo irouter revoke. ایجنت همان لحظه دیگر به ایران‌روتر نمی‌رسد تا کلید تازه بگیرد (با نصب دوباره، یا در حالت مدیریت با چرخاندن کلید).
  • با حذف ایجنت، کلیدش هم باطل می‌شود.
  • روی سرور خودتان می‌توانید به‌جای کلید ایران‌روتر، کلید مدل خودتان را انتخاب کنید؛ آن‌وقت برای ایجنت کلید ایران‌روتر ساخته نمی‌شود. irouter هنوز راهی برای گذاشتن کلید خودتان ندارد، پس آن را خودتان در تنظیمات خود ایجنت می‌گذارید.

دسترسی ما بعد از نصب

حالتمعنی
تنظیم کن و بروبعد از نصب هیچ کلید SSH یا دسترسی مدیریتی از ما روی سرور نمی‌ماند؛ فقط کلید API ایجنت، که هر وقت بخواهید باطلش می‌کنید. به‌روزرسانی با خودتان است: sudo irouter update.
مدیریت با ایران‌روترسرویس کوچک irouter-agentd روی سرور می‌ماند. فقط خودش با HTTPS به ما وصل می‌شود و هیچ پورتی باز نمی‌کند. فقط یک فهرست بسته را اجرا می‌کند: ری‌استارت، به‌روزرسانی ایجنت، چرخاندن کلید، گرفتن لاگ، اعمال تنظیمات و باطل کردن کلید. فرمان دلخواه shell اجرا نمی‌کند. یک افزودنی ماهانه است و فقط وقتی ارائه شود در ویزارد و پنل دیده می‌شود.
  • فرمان‌های پنل (ری‌استارت، به‌روزرسانی، لاگ و بقیه) فقط در حالت مدیریت کار می‌کنند. هر فرمان منتظر سرور می‌ماند و با گزارش بعدی آن اجرا می‌شود.
  • متن لاگی که از سرور گرفته می‌شود فقط یک ساعت نگه داشته می‌شود.
  • برگشتن به «تنظیم کن و برو» همان لحظه انجام می‌شود: سرویس مدیریت از سرور می‌رود و فرمان‌های در صف لغو می‌شوند. پولی برنمی‌گردد.

دسترسی اضطراری

  • فقط اگر خودتان در صفحهٔ ایجنت اجازه داده باشید. پشتیبانی آن را با ذکر دلیل و برای مدت کوتاهی باز می‌کند و فقط همان فهرست بستهٔ فرمان‌ها را دارد. هر باز شدنش در رویدادهای ایجنت ثبت می‌شود و به شما خبر می‌دهیم.
  • هر وقت اجازه را پس بگیرید، پنجرهٔ باز همان لحظه بسته و فرمان‌های در صفش لغو می‌شوند.
  • اگر خودتان کمک بخواهید، روی سرور بزنید sudo irouter grant-access <minutes> تا پشتیبانی همان چند دقیقه‌ای که می‌گویید بتواند روی ایجنت کار کند (برای این مدت هم سقفی داریم). پنجره خودش سر وقت بسته می‌شود؛ زودتر از صفحهٔ ایجنت می‌بندیدش.

گفتگو با ایجنت

صفحهٔ وب

  • هر ایجنت صفحهٔ وب خودش را روی نشانی خودش دارد، همیشه پشت رمز. مرورگر نام کاربری و رمز می‌خواهد: هر نام کاربری‌ای قبول است و رمز همان «رمز صفحهٔ وب» است. بعد از ورود، مرورگر تا ۱۲ ساعت وارد می‌ماند.
  • رمز را در صفحهٔ ایجنت در پنل بگذارید یا عوض کنید (دست‌کم ۱۲ نویسه، با دست‌کم ۶ نویسهٔ متفاوت)، یا روی سرور با sudo irouter web-password. تا رمزی گذاشته نشود، صفحه بسته می‌ماند. رمز یک بار به سرور می‌رسد و ما بعد از آن نگهش نمی‌داریم.

تلگرام و بله

  • بعد از پرداخت، در صفحهٔ ایجنت «وصل کردن ربات» را بزنید و توکن ربات خودتان را از BotFather بیاورید. یک کد می‌گیرید که باید از حساب خودتان به ربات بفرستید؛ از آن به بعد ربات فقط به همان حساب جواب می‌دهد.
  • توکن یک بار و رمزشده به سرور ایجنت می‌رسد؛ ما نگهش نمی‌داریم و دیگر نشانش نمی‌دهیم.
  • در تلگرام، اگر صفحهٔ ایجنت گزینهٔ «ربات را برایم بساز» را نشان بدهد، کافی است لینک یا QR را با گوشی باز کنید و «ساختن» را بزنید؛ ربات به نام خودتان ساخته می‌شود.
  • اگر سرور خودتان بدون proxy به تلگرام نمی‌رسد، هنگام وصل کردن ربات یک proxy بدهید.
  • ویزارد پیش از پرداخت برای هر ترکیب سرور و پیام‌رسان هشدار خودش را نشان می‌دهد. صفحهٔ وب همیشه هست.

نشانی‌های ایجنت

  • هر ایجنت زیر دامنهٔ ایجنت‌های ما دو نشانی می‌گیرد: یکی برای صفحهٔ وب و یکی برای webhookها. نام را در ویزارد انتخاب می‌کنید (حروف کوچک لاتین، رقم و خط تیره) یا خالی می‌گذارید تا ما بسازیم.
  • گواهی HTTPS نشانی‌ها بعد از وصل شدن سرور خودکار گرفته و تمدید می‌شود.
  • نشانی اضافه زیر نام اصلی ایجنت خریدنی است و قیمتش در پنل آمده. خریدش وسط دوره به نسبت زمان باقی‌ماندهٔ همان دوره حساب می‌شود و بعد با سرور تمدید می‌شود. آزاد کردنش از تمدید بعدی اثر دارد و برای باقی دوره پولی برنمی‌گردد.
  • نامی که آزاد می‌شود تا مدتی به کس دیگری داده نمی‌شود.

هزینه، تمدید و ترافیک

  • ماهانه: یک ماه پیش‌پرداخت، و تا وقتی موجودی برسد خودکار تمدید می‌شود. ساعتی: قیمت ساعتی، که هر بار چند ساعت از پیش از کیف پول پرداخت می‌شود. افزودنی‌های ماهانه روی سرور ساعتی هر ساعت یک‌هفتصدوبیستم قیمت ماه‌اند.
  • تمدید با قیمت روز سفارش است؛ تغییر قیمت‌ها بعداً روی این ایجنت اثر ندارد.
  • مصرف API ایجنت جداست و مثل هر کلید دیگری از پلن یا کیف پول حساب می‌شود.
  • روی سرور خودتان هزینهٔ سرور نیست؛ فقط افزودنی‌ها (مثل حالت مدیریت یا نشانی اضافه) ماهانه حساب می‌شوند. اگر کیف پول تمدیدشان را نپوشاند، افزودنی‌ها قطع می‌شوند و به چیزی از سرور شما دست زده نمی‌شود.
  • ترافیک ماهانه‌ای که هر اندازهٔ سرور دارد، داخلی و بین‌الملل جدا، در جدول قیمت آمده. وقتی مصرف به درصدهای مشخصی از آن برسد خبر می‌دهیم. اگر بیشتر لازم دارید، در صفحهٔ ایجنت «بستهٔ ترافیک» بخرید؛ از کیف پول و برای همین دورهٔ ترافیک است.
  • وقتی ترافیک تمام شود، بسته به جای سرور یکی از این دو است و ویزارد پیش از پرداخت می‌گوید کدام: هر گیگ اضافه از کیف پول کم می‌شود، یا بعد از هشدار و مهلت، سرور تا خرید بسته خاموش می‌شود. در هر دو حالت، اگر پولی برای ادامه نباشد، همان مسیر «تمام شدن موجودی» در پایین طی می‌شود. دادهٔ ایجنت روی سرور می‌ماند.

اگر موجودی تمام شود

  1. پیش از موعد، با اعلان پنل و بسته به تنظیمات ما با پیامک یا ایمیل، خبر می‌دهیم.
  2. اگر تمدید پرداخت نشود، ایجنت یک مهلت روشن می‌ماند. با شارژ کیف پول در این مهلت، دوره پرداخت می‌شود و چیزی قطع نمی‌شود.
  3. بعد از مهلت، سرور خاموش می‌شود. داده‌اش می‌ماند و برای ساعت‌هایی که خاموش است پولی از شما گرفته نمی‌شود. با شارژ کیف پول، یک دورهٔ تازه از همان لحظه پرداخت می‌شود و سرور دوباره روشن می‌شود.
  4. اگر باز هم شارژ نشود، سرور و همهٔ داده‌هایش پس از فاصله‌ای که ما تعیین می‌کنیم، با هشدار قبلی، حذف می‌شود.
ما از سرور ایجنت‌ها نسخهٔ پشتیبان نگه نمی‌داریم. از هر چیزی که برایتان مهم است، مثل حافظه، فایل‌ها و تنظیمات ایجنت، خودتان نسخه نگه دارید.

حذف ایجنت

  • با «حذف ایجنت» در پنل، سرور همان لحظه خاموش می‌شود و پس از فاصله‌ای که تاریخش در صفحهٔ ایجنت می‌آید، با همهٔ داده‌هایش پاک می‌شود. تا آن روز می‌توانید حذف را لغو کنید و سرور دوباره روشن می‌شود. در این فاصله پولی از شما گرفته نمی‌شود.
  • زمان پرداخت‌شده و استفاده‌نشده با حذف برنمی‌گردد.
  • ایجنتی که هرگز آماده نشده، همان لحظه حذف می‌شود و مبلغ رزروشده‌اش کامل برمی‌گردد.
  • با حذف، کلید API ایجنت باطل و نشانی‌هایش آزاد می‌شوند.
  • روی سرور خودتان چیزی خاموش نمی‌شود: تا روز حذف، ایجنت با کلیدش کار می‌کند. اگر می‌خواهید همین حالا قطع شود، کلیدش را باطل کنید. در روز حذف، کلید باطل و نشانی‌ها آزاد می‌شوند.
  • روی سرور خودتان، نرم‌افزار روی سرور می‌ماند؛ با sudo irouter uninstall برش دارید.

ابزار خط فرمان irouter

irouter یک فایل اجرایی تنهاست و متن‌هایش در ترمینال انگلیسی است. دو کار دارد: روی سرور ایجنت، نصب و نگه‌داری؛ و روی کامپیوتر خودتان، اجرای Claude Code، Codex، Hermes یا OpenClaw با کلید ایران‌روتر.

روی کامپیوتر خودتان

Shell
curl -fsSL https://iranrouter.com/v1/agent/install.sh | sh
irouter login --api https://iranrouter.com
irouter claude
  • نصب‌کننده روی Linux و macOS کار می‌کند و irouter را در ‎~/.local/bin می‌گذارد؛ اگر این پوشه در PATH نباشد، می‌گوید چه بنویسید. روی Windows فایل را مستقیم بگیرید: https://iranrouter.com/v1/agent/cli/irouter-windows-x64.exe
  • irouter login یک نشانی و یک کد هشت‌حرفی (مثل ABCD-EFGH) نشان می‌دهد، و در ترمینال یک QR هم برای گوشی. نشانی را باز کنید، یا در پنل به تأیید ورود irouter بروید و کد را وارد کنید. همان‌جا Workspace، نام کلید، منبع پرداخت، سقف خرج روزانه و عمر کلید را انتخاب می‌کنید. با تأیید، یک کلید API فقط برای همین دستگاه ساخته می‌شود و فقط به همان ترمینال می‌رسد؛ کلیدی را دستی کپی نمی‌کنید.
  • فقط کدی را تأیید کنید که خودتان همین الان در ترمینال دیده‌اید. اگر کسی کدی برایتان فرستاده، تأییدش نکنید. کد چند دقیقه اعتبار دارد؛ اگر گذشت، دوباره irouter login بزنید.
  • کلید در فایل irouter/credentials.json زیر پوشهٔ تنظیمات کاربرتان ذخیره می‌شود که فقط خودتان می‌خوانید. irouter logout آن را از این دستگاه پاک می‌کند، ولی خود کلید باقی است؛ اگر لازمش ندارید، در صفحهٔ «کلیدهای API» باطلش کنید.
  • irouter claude، irouter codex، irouter hermes و irouter openclaw همان ابزار را با آدرس و کلید ایران‌روتر، فقط برای همان اجرا، راه می‌اندازند و بقیهٔ آرگومان‌ها را دست‌نخورده به آن می‌دهند. خود ابزار باید از قبل روی دستگاه نصب باشد.

روی سرور ایجنت

این دستورها را با sudo بزنید:

دستورچه می‌کند
irouter enroll <token>همان کاری که دستور نصب پنل می‌کند: سرور را ثبت و ایجنتش را نصب می‌کند. معمولاً خودتان لازمش ندارید. با --replace ثبت فعلی سرور را جایگزین می‌کند.
irouter setupایجنتی را که این سرور برایش ثبت شده دوباره نصب و تنظیم می‌کند. ‎--features a,b امکانات دیگری را به‌جای سفارش‌داده‌ها تنظیم می‌کند، ‎--accept-risk هشدار خود OpenClaw را می‌پذیرد و ‎--force زیر حداقل اندازهٔ ایجنت هم نصب می‌کند. ایجنت دیگری روی همین سرور نمی‌رود: برایش در پنل ایجنت تازه بسازید.
irouter statusچه چیزی اینجا اجرا می‌شود و در چه حالی: ایجنت و نسخه‌اش، حالت دسترسی، چهار حرف آخر کلید، سرویس‌ها، سلامت، نشانی‌ها و گواهی، و رمز صفحهٔ وب.
irouter doctorهر چیزی را که جلوی کار ایجنت را می‌گیرد می‌سنجد: رسیدن به API ما، فضای دیسک، سرویس‌ها، سلامت ایجنت، کلید، گواهی، پورت ۴۴۳ و رمز صفحهٔ وب، و کنار هر مورد ناموفق راه رفعش را می‌گوید.
irouter updateنسخه‌ای را که ایران‌روتر الان ارائه می‌دهد نصب می‌کند.
irouter web-passwordرمز تازه برای صفحهٔ وب ایجنت؛ ‎--generate یکی می‌سازد و یک بار نشان می‌دهد. نشست‌های رمز قبلی همان لحظه تمام می‌شوند.
irouter grant-access <minutes>به پشتیبانی برای چند دقیقه‌ای که خودتان می‌گویید اجازهٔ کار روی این ایجنت را می‌دهد: همان فهرست بستهٔ فرمان‌ها، بدون shell.
irouter revokeسهم ایران‌روتر را روی این سرور تمام می‌کند: کلید باطل و از سرور پاک می‌شود، سرور دیگر با ما حرف نمی‌زند، و حالت مدیریت و پنجرهٔ اضطراری بسته می‌شوند. ایجنت نصب می‌ماند ولی دیگر به مدل‌ها نمی‌رسد.
irouter uninstallایجنت و سرویس‌های ما را برمی‌دارد و کلیدش را باطل می‌کند. دادهٔ خود ایجنت (حافظه و گفتگوها) می‌ماند، مگر با ‎--purge که آن را و کاربر ایجنت را هم پاک می‌کند. خود irouter می‌ماند و دستور پاک کردنش را چاپ می‌کند.
irouter versionنسخهٔ irouter.

irouter agentd و irouter edge را سرویس‌های systemd خودشان اجرا می‌کنند؛ لازم نیست دستی بزنیدشان. اگر چیزی کار نمی‌کند، اول irouter doctor را بزنید و برای تیکت پشتیبانی خروجی آن را بفرستید.

وصل کردن ایجنت‌ها و ابزارهای خودتان به ایران‌روتر ←