🪽🤖

هرمس ایجنت (Hermes Agent) — آموزش کاربردی از صفر تا راه‌اندازی

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

قراره چی یاد بگیریم؟
اینکه هرمس دقیقاً چیست، چطور نصبش کنیم، چطور به یک مدل هوش مصنوعی وصلش کنیم، چطور حافظه و مهارت‌هایش را کنترل کنیم، چطور از تلگرام باهاش حرف بزنیم، چطور کارهای تکراری را برایش زمان‌بندی کنیم، و آخر سر یک جدول مقایسه کامل با OpenClaw.

📋 فهرست مراحل

  1. هرمس اصلاً چیست؟ (با یک مثال ساده)
  2. مرحله ۱ — تصمیم بگیر کجا نصبش کنی
  3. مرحله ۲ — پیش‌نیازها را چک کن
  4. مرحله ۳ — نصب هرمس
  5. مرحله ۴ — وصل کردن مغز (مدل هوش مصنوعی)
  6. مرحله ۵ — اولین گفتگو و دستورهای پایه
  7. مرحله ۶ — حافظه‌ی همیشگی
  8. مرحله ۷ — مهارت‌ها (قدرت اصلی هرمس)
  9. مرحله ۸ — اتصال به تلگرام
  10. مرحله ۹ — کارهای زمان‌بندی‌شده (Cron)
  11. مرحله ۱۰ — امنیت و ترمز دستی
  12. ۱۰ کار واقعی که می‌توانی همین امروز انجام بدهی
  13. جدول دستورهای پرکاربرد
  14. رفع اشکال
  15. 🆚 جدول مقایسه: هرمس ایجنت در برابر OpenClaw
📌 فرض‌های این آموزش (لطفاً یک بار بخوان) فرض کرده‌ام تو یک کاربر معمولی هستی که فقط بلد است کامپیوتر را روشن کند، کلیک کند و تایپ کند. هیچ دانش برنامه‌نویسی لازم نیست.
محتوا بر پایه‌ی مستندات رسمی هرمس (hermes-agent.nousresearch.com/docs) نوشته شده است. چون این نرم‌افزار خیلی سریع به‌روز می‌شود، اسم دقیق بعضی دکمه‌ها یا گزینه‌ها ممکن است کمی فرق کند — هر جا این احتمال بود، جمله را «انعطاف‌پذیر» نوشته‌ام و مسیر بررسی را گفته‌ام.

🧠 هرمس اصلاً چیست؟

تشبیه ساده: یک ربات چت معمولی مثل کارمندی است که هر روز صبح حافظه‌اش پاک می‌شود؛ باید از اول همه‌چیز را برایش توضیح بدهی و او فقط حرف می‌زند.

هرمس مثل کارمندی است که: (۱) یادش می‌ماند دیروز چه کار کردید، (۲) دست دارد و واقعاً کار انجام می‌دهد — فایل می‌سازد، در اینترنت جستجو می‌کند، برنامه اجرا می‌کند — و (۳) وقتی یک کار سخت را یاد گرفت، برای خودش یک «دستورالعمل» می‌نویسد تا دفعه‌ی بعد سریع‌تر انجامش بدهد.

🗣️ تواز ترمینال یا تلگرام
🧠 مدل هوش مصنوعیفکر کردن
🛠️ ابزارهاجستجو، فایل، مرورگر
💾 حافظه و مهارتیاد می‌گیرد
🧩

متن‌باز و مال خودت

ساخته‌ی آزمایشگاه Nous Research با مجوز MIT. روی سرور یا لپ‌تاپ خودت اجرا می‌شود.

💭

حافظه‌ی پایدار

بین نشست‌ها یادش می‌ماند تو کی هستی و پروژه‌ات چیست.

📚

مهارت‌سازی خودکار

یک روش کاری را یک بار یادش بده، خودش تبدیلش می‌کند به مهارت قابل‌استفاده‌ی مجدد.

💬

هر جا که تو هستی

ترمینال، تلگرام، دیسکورد، اسلک، واتساپ، سیگنال، ایمیل و بیش از ۲۰ پلتفرم دیگر.

زمان‌بندی خودکار

«هر روز ساعت ۸ صبح خلاصه‌ی خبرها را برایم بفرست» — و انجام می‌شود.

🖥️

چند چهره

خط فرمان، رابط ترمینالی (TUI)، داشبورد وب و اپلیکیشن دسکتاپ.

📖 پاورقی — چند واژه‌ی سخت که از این به بعد می‌بینی ایجنت (Agent): برنامه‌ای که فقط جواب نمی‌دهد، بلکه خودش قدم‌به‌قدم کار انجام می‌دهد.
ترمینال / خط فرمان: پنجره‌ی سیاهی که در آن به‌جای کلیک، دستور تایپ می‌کنی. در ویندوز اسمش PowerShell است.
CLI: همان ابزار خط فرمان.
مدل (Model): «مغز» هوش مصنوعی، مثل Claude یا GPT. هرمس خودش مغز ندارد؛ به یک مغز وصل می‌شود.
API Key: یک رشته‌ی رمز طولانی که مثل کارت عضویت است و به هرمس اجازه می‌دهد از آن مغز استفاده کند.
گیت‌وی (Gateway): برنامه‌ای که پیام‌های تلگرام/دیسکورد و... را می‌گیرد و به هرمس می‌رساند.
VPS / سرور: یک کامپیوتر اجاره‌ای در اینترنت که ۲۴ ساعته روشن است.
۱

تصمیم بگیر هرمس را کجا نصب کنی

مرحله ۱ از ۱۰

قبل از هر کاری فقط یک تصمیم بگیر. فقط همین یک تصمیم.

💻

الف) روی کامپیوتر خودم

ساده‌ترین راه برای شروع و یادگیری. عیبش: وقتی کامپیوتر خاموش شود، هرمس هم می‌خوابد.

☁️

ب) روی یک سرور (VPS)

۲۴ ساعته روشن می‌ماند و کارهای زمان‌بندی‌شده واقعاً اجرا می‌شوند. کمی سخت‌تر، ولی حالت واقعی استفاده همین است.

💡 نکته برای بار اول گزینه‌ی الف را انتخاب کن. وقتی همه‌چیز کار کرد و فهمیدی چه خبر است، همان تنظیمات را روی سرور تکرار کن. یاد گرفتن روی سرور از راه دور، اشتباه رایج مبتدی‌هاست.
✅ ایست بازرسی الان باید یک جمله در ذهنت داشته باشی: «من هرمس را روی ______ نصب می‌کنم.» اگر نداری، بنویس «کامپیوتر خودم» و برو مرحله‌ی بعد.
۲

پیش‌نیازها را چک کن

مرحله ۲ از ۱۰

خبر خوب: نصب‌کننده‌ی هرمس تقریباً همه‌چیز را خودش نصب می‌کند — پایتون، نودجی‌اس، ابزار جستجوی فایل و مبدل صوت. تو فقط دو تا چیز لازم داری:

۱) یک برنامه به اسم Git

در ویندوز و مک، اگر از نصب‌کننده‌ی دسکتاپ استفاده کنی معمولاً درگیرش نمی‌شوی. در لینوکس/مک از راه ترمینال، Git تنها پیش‌نیاز واقعی است. برای بررسی، ترمینال را باز کن و این را تایپ کن:

git --version

اگر یک شماره‌ی نسخه دیدی، یعنی داری‌اش. اگر پیام خطا دیدی، از git-scm.com نصبش کن.

۲) یک راه برای دسترسی به مغز هوش مصنوعی

یکی از این‌ها کافی است: حساب Nous Portal، یا OpenRouter، یا کلید مستقیم OpenAI / Anthropic / Google، یا حتی یک مدل محلی روی کامپیوتر خودت.

⚠️ مواظب باش — کاربران داخل ایران دسترسی به سرویس‌های مدل و حتی به api.telegram.org ممکن است مسدود باشد. هرمس برای همین حالت‌ها پشتیبانی از پروکسی دارد و در مرحله‌ی ۸ نشانت می‌دهم چطور تنظیمش کنی. فعلاً فقط بدان که این مشکل راه‌حل دارد.
⚠️ مواظب باش — کاربران ویندوز روان‌ترین مسیر در ویندوز، نصب‌کننده‌ی Hermes Desktop است. نصب مستقیم روی ویندوز از راه PowerShell هم پشتیبانی می‌شود، ولی اگر به مشکل خوردی، گزینه‌ی مطمئن‌تر نصب داخل WSL2 (لینوکس داخل ویندوز) است.
✅ ایست بازرسی الان باید بدانی: (الف) Git داری یا نه، و (ب) قرار است از کدام سرویس مدل استفاده کنی.
۳

نصب هرمس

مرحله ۳ از ۱۰

سه راه وجود دارد. فقط یکی را انتخاب کن.

راه A — ویندوز یا مک، با برنامه‌ی گرافیکی (ساده‌ترین)

به سایت رسمی hermes-agent.nousresearch.com برو، فایل نصب Hermes Desktop را دانلود کن و اجرایش کن. این روش هم برنامه‌ی گرافیکی و هم ابزار خط فرمان را با هم نصب می‌کند.

راه B — لینوکس، مک، WSL2 یا اندروید (Termux)

ترمینال را باز کن و این یک خط را کپی کن، بچسبان، و کلید Enter را بزن:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

راه C — ویندوز، بدون برنامه‌ی گرافیکی

در منوی استارت بنویس PowerShell، بازش کن و این خط را اجرا کن:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)
💡 نکته نصب چند دقیقه طول می‌کشد و متن‌های زیادی روی صفحه می‌آید. این طبیعی است — دارد پایتون، نودجی‌اس و بقیه‌ی ابزارها را دانلود می‌کند. صبور باش و پنجره را نبند.

بعد از پایان نصب، این دستور را بزن تا ترمینال تنظیمات جدید را بخواند:

source ~/.bashrc   # اگر از zsh استفاده می‌کنی: source ~/.zshrc
✅ ایست بازرسی این را تایپ کن: hermes doctor
باید یک گزارش وضعیت ببینی که می‌گوید چه چیزی سالم است و چه چیزی کم است. اگر پیام command not found دیدی، برو به بخش «رفع اشکال» در پایین صفحه.
۴

وصل کردن مغز (مدل هوش مصنوعی)

مرحله ۴ از ۱۰

هرمس بدون مدل، مثل ماشین بدون بنزین است. دو راه داری:

راه سریع — Nous Portal

مستندات رسمی این را «سریع‌ترین مسیر تا یک ایجنت کارکن» می‌داند، چون با یک بار ورود، هم مدل و هم چهار ابزار مهم (جستجوی وب، تولید تصویر، تبدیل متن به گفتار، مرورگر ابری) با هم فعال می‌شوند:

hermes setup --portal

راه دستی — انتخاب هر سرویسی که خودت داری

hermes model

یک منوی انتخابی باز می‌شود: سرویس‌دهنده را انتخاب کن (مثلاً OpenRouter یا OpenAI)، کلید API خودت را بچسبان، و مدل موردنظر را انتخاب کن.

📖 توضیح — کلید API را از کجا بیاورم؟ از سایت همان سرویس. مثلاً برای OpenRouter وارد حسابت می‌شوی و در بخش کلیدها یک کلید جدید می‌سازی. کلید یک رشته‌ی طولانی است. آن را مثل رمز عبور نگه دار و هرگز در جای عمومی نگذار.

دستورهای مفید دیگر برای بعدها:

دستورکارش چیست
hermes setupجادوگر کامل تنظیمات؛ همه‌چیز را یکجا می‌پرسد
hermes toolsانتخاب اینکه کدام ابزارها روشن باشند
hermes config getدیدن یک تنظیم
hermes config setتغییر یک تنظیم
hermes updateبه‌روزرسانی هرمس به آخرین نسخه
✅ ایست بازرسی اگر پیام خطای API key not set ندیدی، یعنی مغز وصل شده است. برو مرحله‌ی بعد.
۵

اولین گفتگو و دستورهای پایه

مرحله ۵ از ۱۰

فقط این یک کلمه را تایپ کن و Enter بزن:

hermes

حالا در محیط گفتگو هستی. مثل چت معمولی فارسی یا انگلیسی تایپ کن. مثلاً بنویس: «سلام، خودت را معرفی کن و بگو الان چه ابزارهایی داری.»

دستورهای اسلش (Slash Commands)

هر وقت داخل گفتگو کاراکتر / را تایپ کنی، یک منوی خودکار باز می‌شود. این‌ها دستورهای خود هرمس هستند، نه پیام به مدل.

دستورکارش چیست
/helpنمایش راهنما
/statusوضعیت نشست: مدل، پروفایل، پوشه‌ی کاری، مصرف توکن
/newشروع یک گفتگوی تازه (تاریخچه پاک می‌شود)
/resumeبرگشتن به یک گفتگوی قبلی
/modelعوض کردن مدل وسط کار
/contextنمایش تصویری اینکه چقدر از حافظه‌ی گفتگو پر شده
/usageمصرف توکن و هزینه
/stopمتوقف کردن کاری که در حال اجراست
/quitخروج
💡 نکته‌ی طلایی لازم نیست همه را حفظ کنی. فقط /help و /status را یاد بگیر؛ بقیه را با تایپ / از منو پیدا می‌کنی.
✅ ایست بازرسی یک سؤال ساده بپرس و جواب بگیر. بعد /status بزن و ببین اسم مدل و شماره‌ی نشست نمایش داده می‌شود. اگر بله — تبریک، هرمس زنده است! 🎉
۶

حافظه‌ی همیشگی — تفاوت اصلی هرمس

مرحله ۶ از ۱۰

تشبیه: حافظه‌ی هرمس مثل یک دفترچه‌ی جیبی کوچک است، نه یک انبار. عمداً کوچک است تا فقط چیزهای واقعاً مهم داخلش بماند.

فایلداخلش چه می‌نویسدسقف اندازه
MEMORY.mdیادداشت‌های خود ایجنت: مشخصات سیستم، قواعد پروژه، درس‌هایی که یاد گرفته۲۲۰۰ کاراکتر
USER.mdپروفایل تو: اسم، سلیقه، سبک ارتباطی، چیزهایی که دوست نداری۱۳۷۵ کاراکتر

این دو فایل در پوشه‌ی ~/.hermes/memories/ ذخیره می‌شوند و در شروع هر گفتگو به‌صورت خودکار جلوی چشم ایجنت گذاشته می‌شوند.

یک چیز مهم که باید بدانی

هرمس خودش تصمیم می‌گیرد چه چیزی را ذخیره کند — لازم نیست بگویی «این را یادت باشه». ولی می‌توانی صریح هم بگویی، مثلاً: «یادت باشه من همیشه جواب کوتاه و فارسی می‌خوام.»

📖 توضیح — چرا حافظه محدود است؟ چون هر چیزی که در حافظه باشد، در هر پیام دوباره برای مدل فرستاده می‌شود و هزینه دارد. وقتی حافظه پر شود، هرمس خطا می‌گیرد و مجبور می‌شود یادداشت‌های قدیمی را خلاصه یا حذف کند. این عمدی است.

ولی گفتگوهای قدیمی چه می‌شوند؟

هیچ‌کدام پاک نمی‌شوند. همه‌ی نشست‌ها در یک پایگاه‌داده‌ی محلی ذخیره می‌شوند و ایجنت می‌تواند داخلشان جستجو کند. یعنی می‌توانی بپرسی «هفته‌ی پیش درباره‌ی فلان موضوع چی گفتیم؟» و پیدایش می‌کند.

hermes sessions list   # فهرست گفتگوهای قبلی

دیدن و پاک کردن چیزهایی که یاد گرفته

داخل گفتگو بنویس:

/journey

یک خط زمانی از همه‌ی مهارت‌ها و خاطره‌هایی که جمع کرده نشان می‌دهد — و می‌توانی همان‌جا موردی را ویرایش یا حذف کنی.

💡 اگر چیز اشتباهی درباره‌ات یاد گرفت دو راه داری: با /journey حذفش کن، یا جلوی ذخیره‌ی خودکار را بگیر. برای دومی، در فایل ~/.hermes/config.yaml این را بنویس:
memory:
  write_approval: true
از آن به بعد هر ذخیره‌سازی منتظر تأیید تو می‌ماند و با /memory pending می‌توانی ببینی چه چیزی در صف است.
✅ ایست بازرسی بگو «اسم من ______ است و ترجیح می‌دهم جواب‌ها کوتاه باشند.» بعد /quit بزن، دوباره hermes را اجرا کن و بپرس «اسم من چیست؟» — اگر یادش بود، حافظه کار می‌کند.
۷

مهارت‌ها — قدرت اصلی هرمس

مرحله ۷ از ۱۰

تشبیه: مهارت مثل دستور پخت آشپزی است. تو یک بار به آشپز یاد می‌دهی کیک چطور درست می‌شود؛ او آن را می‌نویسد و می‌چسباند روی یخچال. دفعه‌ی بعد فقط نگاه می‌کند و می‌پزد.

مهارت در هرمس یک فایل متنی ساده به اسم SKILL.md است که فقط هنگام نیاز خوانده می‌شود — یعنی وقتی لازم نیست، هزینه‌ای هم ندارد.

سه راه برای داشتن مهارت

📦

۱) آماده و همراه نصب

حدود ۹۰ مهارت از قبل همراه هرمس نصب می‌شود، به‌علاوه‌ی حدود ۶۰ مهارت اختیاری قابل‌نصب.

🛒

۲) از فروشگاه مهارت

با /skills می‌توانی در مخازن آنلاین جستجو و نصب کنی. استاندارد باز آن agentskills.io است.

🎓

۳) خودش می‌سازد

مهم‌ترین قابلیت هرمس. با /learn از یک پوشه، یک لینک، یا کاری که همین الان با هم انجام دادید، یک مهارت جدید می‌نویسد.

مثال عملی — یاد دادن یک روش کاری

فرض کن با هرمس یک کار چندمرحله‌ای انجام دادی و خوب جواب داد. کافی است بنویسی:

/learn روشی که همین الان برای تهیه گزارش هفتگی انجام دادیم

هرمس همان روش را به یک مهارت قابل‌استفاده‌ی مجدد تبدیل می‌کند. دفعه‌ی بعد کافی است نامش را با اسلش صدا بزنی.

دستورهای مهارت

دستورکارش چیست
/skillsجستجو، نصب، بررسی و مدیریت مهارت‌ها
/learn <موضوع>ساختن یک مهارت جدید از تجربه، پوشه یا لینک
/reload-skillsخواندن دوباره‌ی پوشه‌ی مهارت‌ها بعد از افزودن دستی
/curatorنگهداری خودکار مهارت‌ها: بایگانی موارد قدیمی و بی‌استفاده
/<نام-مهارت>اجرای مستقیم یک مهارت نصب‌شده
⚠️ مواظب باش مهارت‌هایی که از اینترنت نصب می‌کنی، در عمل «کد قابل‌اجرا» هستند و ایجنت طبق آن‌ها عمل می‌کند. فقط از منابعی نصب کن که به آن‌ها اعتماد داری، و اگر بلدی، محتوای فایل را قبل از استفاده یک نگاه بینداز.
💡 اگر می‌خواهی هر تغییر مهارت را خودت تأیید کنی در ~/.hermes/config.yaml:
skills:
  write_approval: true
بعد با /skills pending و /skills approve کنترل کامل داری.
✅ ایست بازرسی /skills را بزن. باید فهرستی از مهارت‌ها را ببینی. اگر خالی بود، یک بار /reload-skills بزن.
۸

اتصال به تلگرام — با هرمس از موبایل حرف بزن

مرحله ۸ از ۱۰

این جایی است که هرمس واقعاً مفید می‌شود: کامپیوتر یا سرورت کار می‌کند، تو از موبایل دستور می‌دهی.

گام ۸.۱ — ساختن ربات تلگرام

  1. در تلگرام بگرد دنبال @BotFather (ربات رسمی خود تلگرام).
  2. برایش بفرست: /newbot
  3. یک نام نمایشی انتخاب کن (هر چیزی، مثلاً «دستیار من»).
  4. یک نام کاربری انتخاب کن که یکتا باشد و به bot ختم شود (مثلاً my_hermes_bot).
  5. BotFather یک توکن می‌دهد؛ چیزی شبیه 123456789:ABCdef... — کپی‌اش کن.
⚠️ مواظب باش این توکن دقیقاً مثل رمز عبور ربات توست. هر کسی آن را داشته باشد می‌تواند رباتت را کنترل کند. اگر لو رفت، فوراً در BotFather دستور /revoke را بزن.

گام ۸.۲ — پیدا کردن شماره‌ی کاربری خودت

هرمس برای اینکه بفهمد فقط تو اجازه داری با ربات حرف بزنی، به عدد شناسه‌ی تلگرامت نیاز دارد (نه نام کاربری). به ربات @userinfobot پیام بده؛ فوراً یک عدد مثل 123456789 برایت می‌فرستد. یادداشتش کن.

گام ۸.۳ — تنظیم در هرمس

ساده‌ترین راه، جادوگر خودکار است. در ترمینال:

hermes gateway setup

گزینه‌ی Telegram را انتخاب کن، توکن را بچسبان و شناسه‌ی کاربری‌ات را وارد کن. تمام.

اگر ترجیح می‌دهی دستی انجام بدهی، فایل ~/.hermes/.env را باز کن و این دو خط را اضافه کن:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjkl...
TELEGRAM_ALLOWED_USERS=123456789

گام ۸.۴ — روشن کردن گیت‌وی

hermes gateway

چند ثانیه بعد ربات آنلاین می‌شود. در تلگرام به رباتت پیام بده و ببین جواب می‌دهد.

🌐 اگر تلگرام روی سرور/کامپیوترت مسدود است هرمس پروکسی اختصاصی تلگرام را پشتیبانی می‌کند. در فایل ~/.hermes/config.yaml:
telegram:
  proxy_url: "socks5://127.0.0.1:1080"
یا به‌جایش در ~/.hermes/.env:
TELEGRAM_PROXY=socks5://127.0.0.1:1080
آدرس و پورت را با مقادیر پروکسی خودت عوض کن. حالت‌های http://، https:// و socks5:// پشتیبانی می‌شوند.
💡 یک دستور که حتماً بزن در همان چت تلگرام بنویس /sethome. این یعنی «نتیجه‌ی کارهای زمان‌بندی‌شده را همین‌جا بفرست». در مرحله‌ی بعد لازمش داری.
✅ ایست بازرسی در تلگرام به رباتت بنویس «سلام» و جواب بگیر. اگر گفت «unauthorized»، یعنی شناسه‌ی کاربری‌ات درست وارد نشده. اگر اصلاً جواب نداد، توکن را دوباره چک کن و لاگ گیت‌وی را ببین.
۹

کارهای زمان‌بندی‌شده — بگذار خودش کار کند

مرحله ۹ از ۱۰

تشبیه: مثل زنگ ساعت، ولی به‌جای صدا دادن، یک کار کامل انجام می‌دهد و نتیجه را برایت می‌فرستد.

زیبایی ماجرا این است که لازم نیست فرمول عجیب زمان‌بندی بلد باشی — با زبان طبیعی می‌گویی. داخل گفتگو (چه در ترمینال، چه در تلگرام) بنویس:

/cron

یا مستقیم به خودش بگو، مثلاً:

«هر روز ساعت ۸ صبح، مهم‌ترین خبرهای حوزه‌ی هوش مصنوعی را جمع‌آوری کن، در سه بند فارسی خلاصه کن و برایم بفرست.»

دستورهای مدیریت زمان‌بندی: افزودن، ویرایش، توقف موقت، ادامه، اجرای فوری و حذف — همه از طریق /cron در دسترس‌اند.

💡 چند ایده‌ی عملی • خلاصه‌ی روزانه‌ی ایمیل‌های مهم
• گزارش هفتگی از تغییرات مخزن کد
• پشتیبان‌گیری شبانه و ارسال پیام تأیید
• رصد قیمت یا رصد سایت رقیب و اطلاع در صورت تغییر
⚠️ مواظب باش اگر هرمس روی لپ‌تاپ خودت نصب است و لپ‌تاپ خاموش باشد، کار زمان‌بندی‌شده اجرا نمی‌شود. برای کارهای واقعاً همیشگی، سرور لازم است (همان گزینه‌ی «ب» در مرحله‌ی ۱).
✅ ایست بازرسی یک کار آزمایشی بساز که «هر ۵ دقیقه یک بار فقط بنویسد سلام» و بعد از دیدن نتیجه حذفش کن. اگر پیام رسید، زمان‌بندی سالم است.
۱۰

امنیت و ترمز دستی

مرحله ۱۰ از ۱۰

این مهم‌ترین مرحله است و لطفاً از رویش رد نشو. هرمس یک چت‌بات نیست؛ برنامه‌ای است که روی کامپیوتر تو دستور اجرا می‌کند.

🔐

همیشه لیست مجاز بگذار

حتماً TELEGRAM_ALLOWED_USERS را تنظیم کن تا فقط تو بتوانی دستور بدهی.

🛑

تأیید دستورهای خطرناک

وقتی ایجنت بخواهد کار پرریسکی انجام دهد، از تو اجازه می‌گیرد. با /approvals رفتارش را تنظیم کن.

↩️

برگشت به عقب

با /rollback می‌توانی تغییرات فایلی را برگردانی و با /diff ببینی چه چیزی عوض شده.

📦

جداسازی

هرمس می‌تواند داخل Docker یا روی یک سرور جداگانه اجرا شود تا به فایل‌های شخصی‌ات دسترسی نداشته باشد.

⚠️ درباره‌ی حالت YOLO دستوری به اسم /yolo وجود دارد که همه‌ی تأییدهای امنیتی را خاموش می‌کند. روشنش نکن — مخصوصاً وقتی تازه‌کاری یا هرمس به فایل‌های مهمت دسترسی دارد.
💡 توصیه‌ی عملی برای شروع امن یک پوشه‌ی جداگانه بساز (مثلاً ~/hermes-workspace)، هرمس را از داخل همان پوشه اجرا کن، و اول فقط کارهای بی‌خطر بهش بده. وقتی به رفتارش اعتماد کردی، دامنه را گسترش بده.
✅ ایست بازرسی نهایی • لیست کاربران مجاز تلگرام تنظیم شده؟ ✔
• حالت YOLO خاموش است؟ ✔
• می‌دانی /stop کار در حال اجرا را متوقف می‌کند؟ ✔

🎯 ده کار واقعی که می‌توانی همین امروز انجام بدهی

۱. دستیار پژوهش صبحگاهی

هر روز موضوعات موردعلاقه‌ات را جستجو و خلاصه کند و در تلگرام بفرستد.

۲. مرتب‌کننده‌ی فایل‌ها

پوشه‌ی دانلودها را بررسی و بر اساس نوع و تاریخ دسته‌بندی کند.

۳. بازبین کد

تغییرات مخزن را بخواند و ایرادهای احتمالی را با دلیل گزارش کند.

۴. ردیاب باگ

از پیام خطا شروع کند، لاگ‌ها را بگردد و محل احتمالی مشکل را پیشنهاد بدهد.

۵. دستیار ایمیل

ایمیل‌های مهم را از بقیه جدا کند و خلاصه‌ی روزانه بدهد.

۶. رصد رقبا

سایت یا صفحه‌ای را مرتب چک کند و فقط وقتی چیزی عوض شد خبر بدهد.

۷. تبدیل صوت به متن

ویس تلگرام بفرست؛ خودش پیاده می‌کند و خلاصه می‌دهد.

۸. دستیار تیمی

در یک گروه تلگرام یا اسلک بنشیند و به سؤال‌های تیم جواب بدهد.

۹. پشتیبان‌گیری شبانه

هر شب اسکریپت پشتیبان‌گیری را اجرا و نتیجه را گزارش کند.

۱۰. کارگر موازی

با تفویض کار به زیرایجنت‌ها، چند کار سنگین را هم‌زمان جلو ببرد.

⌨️ جدول دستورهای پرکاربرد

دستورهای ترمینال (بیرون از گفتگو)

دستورکارش چیست
hermesشروع گفتگو
hermes setup --portalسریع‌ترین راه راه‌اندازی مدل و ابزارها
hermes modelانتخاب یا تغییر سرویس‌دهنده و مدل
hermes toolsروشن و خاموش کردن ابزارها
hermes gateway setupتنظیم پیام‌رسان‌ها (تلگرام، دیسکورد و…)
hermes gatewayاجرای گیت‌وی پیام‌رسان‌ها
hermes doctorعیب‌یابی: چه چیزی کم است و چطور درست شود
hermes sessions listفهرست گفتگوهای قبلی
hermes journeyخط زمانی چیزهایی که یاد گرفته
hermes updateبه‌روزرسانی
hermes desktopنصب و اجرای برنامه‌ی دسکتاپ

مسیر فایل‌های مهم

مسیرداخلش چیست
~/.hermes/config.yamlتنظیمات اصلی
~/.hermes/.envکلیدها و توکن‌های محرمانه
~/.hermes/memories/فایل‌های حافظه
~/.hermes/skills/مهارت‌ها
~/.hermes/logs/گزارش‌های اجرا (برای عیب‌یابی)

🔧 رفع اشکال

۱) می‌نویسم hermes ولی می‌گوید command not found

علت: ترمینال هنوز نمی‌داند برنامه‌ی جدید کجاست.
درمان: این را بزن: source ~/.bashrc (یا source ~/.zshrc). اگر باز هم نشد، ترمینال را کامل ببند و دوباره باز کن.

۲) خطای API key not set

علت: هنوز مغزی وصل نشده.
درمان: hermes model را اجرا کن و سرویس‌دهنده و کلیدت را وارد کن.

۳) بعد از به‌روزرسانی، تنظیماتم گم شد

درمان: به‌ترتیب این دو را بزن: hermes config check و سپس hermes config migrate.

۴) ربات تلگرام اصلاً جواب نمی‌دهد

بررسی کن: توکن درست است؟ گیت‌وی روشن است؟ لاگ را در ~/.hermes/logs/ نگاه کن. اگر شبکه‌ات تلگرام را مسدود می‌کند، پروکسی را طبق مرحله‌ی ۸ تنظیم کن.

۵) ربات می‌گوید «unauthorized»

علت: شناسه‌ی عددی تو در لیست مجاز نیست.
درمان: با @userinfobot دوباره شناسه‌ات را بگیر و مقدار TELEGRAM_ALLOWED_USERS را اصلاح کن. دقت کن این عدد است، نه نام کاربری.

۶) در چت خصوصی جواب می‌دهد ولی در گروه نه

علت: حالت حریم خصوصی ربات‌های تلگرام به‌صورت پیش‌فرض روشن است و ربات پیام‌های عادی گروه را نمی‌بیند.
درمان: در BotFather مسیر /mybots → Bot Settings → Group Privacy را خاموش کن، یا ربات را ادمین گروه کن. نکته‌ی حیاتی: بعد از تغییر این تنظیم، باید ربات را از گروه حذف و دوباره اضافه کنی.

۷) هر چیز دیگری

اولین کاری که باید بکنی همیشه یکی است:

hermes doctor

این دستور دقیقاً می‌گوید چه چیزی مشکل دارد و راه‌حلش چیست.

🆚 جدول مقایسه: هرمس ایجنت در برابر OpenClaw

📖 اول یک توضیح کوتاه OpenClaw پروژه‌ی متن‌باز دیگری در همین حوزه است که ابتدا با نام Clawdbot و بعد Moltbot منتشر شد و به OpenClaw تغییر نام داد. ساخته‌ی Peter Steinberger است و در اوایل سال ۲۰۲۶ به یکی از پرستاره‌ترین پروژه‌های تاریخ گیت‌هاب تبدیل شد. کار هر دو یک چیز است: «یک دستیار هوش مصنوعی همیشه‌روشن روی سرور خودت که از پیام‌رسان‌ها در دسترس است». تفاوت‌ها در فلسفه و جزئیات است.
معیار🪽 Hermes Agent🦞 OpenClaw
سازنده آزمایشگاه Nous Research (سازنده‌ی مدل‌های Hermes) Peter Steinberger؛ اکنون زیر نظر یک بنیاد متن‌باز مستقل
ایده‌ی محوری ایجنتی که خودش را بهبود می‌دهد — حلقه‌ی یادگیری بسته دستیار شخصی همیشه‌روشن با اکوسیستم مهارت بسیار بزرگ
زبان و رانتایم پایتون (نصب‌کننده خودش Python و Node را نصب می‌کند) Node.js — باید نسخه‌ی مناسب Node را از قبل داشته باشی
مجوز MIT (به‌صراحت در مستندات رسمی) متن‌باز؛ برای جزئیات مجوز به مخزن رسمی مراجعه کن
نصب curl … | bash یا PowerShell، یا نصب‌کننده‌ی دسکتاپ npm install -g openclaw یا اسکریپت نصب، سپس openclaw onboard
پیش‌نیاز عملی فقط Git؛ بقیه خودکار نصب می‌شود Node.js با نسخه‌ی مشخص، به‌علاوه‌ی کلید مدل
ویندوز نصب‌کننده‌ی دسکتاپ + مسیر PowerShell + WSL2 اپلیکیشن Windows Hub + نصب‌کننده‌ی PowerShell + WSL2
حافظه دو فایل کوچک و سقف‌دار (MEMORY.md و USER.md) + جستجوی متن کامل در تمام نشست‌های قبلی + ۸ ارائه‌دهنده‌ی حافظه‌ی خارجی حافظه‌ی پایدار بین نشست‌ها + افزونه‌های حافظه‌ی جامعه‌محور
مهارت‌ها حدود ۹۰ مهارت همراه + حدود ۶۰ اختیاری؛ سازگار با استاندارد باز agentskills.io فروشگاه مهارت ClawHub با بیش از ۵۰۰ مهارت جامعه‌محور
یادگیری خودکار مهارت ✅ نقطه‌ی قوت اصلی — با /learn از تجربه مهارت می‌سازد و در حین استفاده بهبودش می‌دهد عمدتاً نصب مهارت آماده؛ تمرکز روی اکوسیستم است نه خودآموزی
پیام‌رسان‌ها ۲۰+ پلتفرم از یک گیت‌وی: تلگرام، دیسکورد، اسلک، واتساپ، سیگنال، ماتریکس، ایمیل، SMS، Teams، Google Chat و… واتساپ، تلگرام، اسلک، دیسکورد، iMessage، سیگنال، ماتریکس، Teams، Feishu، Zalo و…
رابط کاربری خط فرمان، رابط ترمینالی (TUI)، داشبورد وب، اپلیکیشن دسکتاپ خط فرمان، داشبورد و Control UI روی مرورگر (پورت پیش‌فرض 18789)
زمان‌بندی Cron داخلی با زبان طبیعی و تحویل نتیجه به هر پلتفرم اجرای دائمی به‌صورت daemon با چرخه‌ی heartbeat
محل اجرای فرمان‌ها ۶ بک‌اند: محلی، Docker، SSH، Daytona، Singularity، Modal — از جمله گزینه‌های سرورلس محلی، Docker، Kubernetes، انواع VPS و Raspberry Pi
کار موازی زیرایجنت‌های ایزوله + اجرای کد پایتونی برای فشرده‌سازی چند مرحله در یک نوبت پیکربندی چند ایجنت با فضای کاری جدا و مسیریابی بین کانال‌ها
بلوغ جامعه جوان‌تر، ولی پشتوانه‌ی یک آزمایشگاه مدل‌سازی و مستندات بسیار منظم بسیار بزرگ‌تر؛ طبق سایت رسمی بیش از ۳۴۶ هزار ستاره در گیت‌هاب
نکته‌ی امنیتی تأیید فرمان‌های خطرناک، دروازه‌ی تأیید برای نوشتن حافظه و مهارت، اسکن ورودی‌های حافظه، جداسازی با کانتینر هشدارهای جدی پژوهشگران امنیتی؛ توصیه‌ی اکید به عدم قرار دادن پورت گیت‌وی روی اینترنت عمومی و بررسی مهارت‌های نصب‌شده
مناسب چه کسی؟ کسی که می‌خواهد ایجنتش با گذر زمان بهتر و شخصی‌تر شود و کنترل دقیق روی حافظه و مهارت داشته باشد کسی که می‌خواهد سریع به یک اکوسیستم بزرگ مهارت و کانال وصل شود و جامعه‌ی پرجمعیت پشتش باشد
💡 جمع‌بندی بی‌طرفانه این‌ها رقیب مطلق هم نیستند و هر دو متن‌بازند — می‌توانی هر دو را روی یک ماشین (با پورت‌های جدا) امتحان کنی. اگر ارزش اصلی برایت یادگیری تدریجی و حافظه‌ی قابل‌کنترل است، هرمس گزینه‌ی طبیعی‌تری است. اگر سرعت رسیدن به نتیجه و تنوع مهارت آماده اولویت دارد، OpenClaw جلوتر است. در هر دو حالت، اصل «اول امن، بعد گسترده» را رعایت کن.

🎉 تمام شد! حالا تو بلدی…

قدم بعدی پیشنهادی: فقط یک کار واقعی از فهرست «ده کار» را انتخاب کن و تا آخر ببرش. یک کار کامل، از ده کار نیمه‌کاره ارزشمندتر است.

🔗 منابع رسمی برای ادامه مستندات هرمس: hermes-agent.nousresearch.com/docs
مخزن کد: github.com/NousResearch/hermes-agent
مخزن مهارت‌ها: agentskills.io
مستندات OpenClaw: docs.openclaw.ai