ملخص: عميل هيرمس هو مساعد ذكاء اصطناعي مفتوح المصدر يتذكر ما يتعلمه ويصبح أكثر ذكاءً بمرور الوقت. ثبته بأمر واحد، قم بتكوين مزود LLM الخاص بك، وابدأ الدردشة عبر CLI، تيليجرام، ديسكورد، أو بيئة التطوير المتكاملة (IDE) الخاصة بك. يغطي هذا الدليل التثبيت، الإعداد، الاستخدام اليومي، الميزات المتقدمة، وكيفية الاستفادة القصوى من هيرمس.
ما هو عميل هيرمس؟
عميل هيرمس هو مساعد ذكاء اصطناعي شخصي تم بناؤه بواسطة NousResearch، يعمل على مدار الساعة طوال أيام الأسبوع، ويتذكر كل ما يتعلمه، ويصبح أكثر قدرة بمرور الوقت. على عكس ChatGPT أو Claude اللذين يبدآن من الصفر في كل محادثة، يبني هيرمس نموذجًا دائمًا لعملك ومشروعاتك وتفضيلاتك.

القدرات الرئيسية:
- يتذكر — يخزن المحادثات والقرارات والتعليمات البرمجية التي كتبتها
- يتعلم — ينشئ مهارات قابلة لإعادة الاستخدام من المهام المتكررة
- متعدد المنصات — دردش عبر CLI، تيليجرام، ديسكورد، سلاك، واتساب، أو بيئة التطوير المتكاملة (IDE)
- مستضاف ذاتيًا — يعمل على جهاز الكمبيوتر المحمول الخاص بك، أو خادم افتراضي خاص (VPS) بقيمة 5 دولارات، أو البنية التحتية السحابية
- محايد للموديل — استخدم أكثر من 200 نموذج عبر OpenRouter أو الموفرين المباشرين
- قابل للتوسيع — نظام مكونات إضافية لأدوات وأوامر مخصصة
من يجب أن يستخدم هيرمس:
- المطورون الذين يريدون مبرمجًا مساعدًا بالذكاء الاصطناعي يعرف قاعدة بياناتهم البرمجية
- الفرق التي تحتاج إلى مساعد ذكاء اصطناعي مشترك يدعم عدة مستخدمين
- المستخدمون المتقدمون الذين يريدون أتمتة الوكيل على مدار الساعة طوال أيام الأسبوع عبر جدولة cron
- الباحثون الذين يدربون نماذج ذكاء اصطناعي مخصصة ببيانات المسار
التثبيت: خطوة بخطوة
المتطلبات الأساسية
- نظام التشغيل: macOS، لينكس، أو ويندوز (يوصى بـ WSL)
- بايثون: 3.10 أو أعلى
- جيت: لاستنساخ المستودعات
- مفتاح API: OpenRouter، Anthropic، OpenAI، أو أي مزود آخر لنموذج اللغة الكبيرة (LLM)
تثبيت سريع (موصى به)
أسرع طريقة لتثبيت هيرمس:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bashيقوم هذا السكريبت بـ:
- استنساخ مستودع هيرمس
- تثبيت
uv(مدير حزم بايثون سريع) - إنشاء بيئة افتراضية
- تثبيت جميع التبعيات
- إضافة هيرمس إلى متغير PATH الخاص بك
بعد التثبيت، أعد تحميل الشل الخاص بك:
source ~/.bashrc # لـ bash
source ~/.zshrc # لـ zshالتحقق من التثبيت:
hermes --versionيجب أن ترى شيئًا مثل Hermes Agent v0.5.0.
تثبيت يدوي (للمطورين)
إذا كنت تريد تحكمًا أكبر في التثبيت:
# استنساخ المستودع
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
# تثبيت uv (إذا لم يكن مثبتًا بالفعل)
curl -LsSf https://astral.sh/uv/install.sh | sh
# إنشاء وتفعيل بيئة افتراضية
uv venv venv --python 3.11
source venv/bin/activate # لينكس/ماك أو إس
# أو
.\venv\Scripts\activate # ويندوز
# تثبيت هيرمس مع جميع الميزات
uv pip install -e ".[all,dev]"
# تشغيل الاختبارات للتحقق من التثبيت
python -m pytest tests/ -qالتثبيت مع دعم تدريب التعلم المعزز (RL)
إذا كنت تخطط لتدريب نماذج مخصصة:
# تهيئة الوحدة الفرعية Atropos
git submodule update --init tinker-atropos
# التثبيت مع تبعيات التدريب
uv pip install -e "./tinker-atropos"الإعداد والتكوين الأولي
تشغيل معالج الإعداد
يجب على المستخدمين لأول مرة تشغيل الإعداد التفاعلي:
hermes setupسيرشدك المعالج خلال:
- اختيار مزود LLM الخاص بك — OpenRouter، Anthropic، OpenAI، إلخ.
- تعيين مفاتيح API — تُخزّن بشكل آمن في
~/.hermes/.env - تكوين الذاكرة — تمكين/تعطيل الذاكرة الدائمة
- الواجهة الخلفية للمحطة الطرفية — خيارات محلية، Docker، SSH، أو سحابية
- إعداد البوابة — تكامل تيليجرام، ديسكورد، سلاك (اختياري)
التكوين اليدوي
إذا كنت تفضل الإعداد اليدوي، قم بتحرير ملف التكوين:
hermes config editأو استخدم أوامر سطر الأوامر (CLI):
# تعيين النموذج الافتراضي
hermes config set model anthropic/claude-opus-4
# تعيين الواجهة الخلفية للمحطة الطرفية
hermes config set terminal.backend local
# تعيين مفاتيح API (يتم حفظها تلقائيًا في ~/.hermes/.env)
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...موقع ملف التكوين
يخزن هيرمس التكوين في ~/.hermes/:
~/.hermes/
├── config.yaml # التكوين الرئيسي
├── .env # مفاتيح API (لا تشاركها!)
├── memory/ # تخزين الذاكرة الدائمة
├── skills/ # المهارات المثبتة
└── plugins/ # المكونات الإضافية المخصصةالتحقق من إعدادك
تشغيل فحص الصحة:
hermes doctorهذا يتحقق من:
- صلاحية التكوين
- اتصال مفتاح API
- حالة نظام الذاكرة
- حالة البوابة (إذا كانت ممكّنة)
- اتصال الواجهة الخلفية للمحطة الطرفية
اختيار مزود LLM الخاص بك
يدعم هيرمس أكثر من 200 نموذج عبر العديد من الموفرين. إليك كيفية الاختيار:
OpenRouter (موصى به للمبتدئين)
لماذا: مفتاح API واحد يمنح الوصول إلى أكثر من 200 نموذج. يتوفر مستوى مجاني.
الإعداد:
hermes config set model openrouter
hermes config set OPENROUTER_API_KEY sk-or-...نماذج شائعة على OpenRouter:
النموذج | حالة الاستخدام | التكلفة |
|---|---|---|
| البرمجة المعقدة، الاستدلال | $$$ |
| أداء متوازن | $$ |
| للأغراض العامة | $$ |
| نوافذ سياق طويلة | $ |
| مفتوح المصدر، سريع | $ |
Anthropic مباشر
لماذا: الأفضل في فئته للبرمجة والاستدلال. وصول مباشر لأحدث نماذج كلود.
الإعداد:
hermes config set model anthropic
hermes config set ANTHROPIC_API_KEY sk-ant-...
hermes config set model.default claude-opus-4OpenAI مباشر
لماذا: نماذج GPT-4o و o1 لحالات استخدام محددة.
الإعداد:
hermes config set model openai
hermes config set OPENAI_API_KEY sk-...النماذج المحلية (Ollama)
لماذا: مجاني، خاص، قادر على العمل دون اتصال.
الإعداد:
# ثبّت Ollama أولاً: https://ollama.ai
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32bأمثلة على تكوين النموذج
التوجيه الذكي (نموذج مكلف للمهام المعقدة، ورخيص للمهام البسيطة):
model:
provider: openrouter
default: anthropic/claude-opus-4
fallback:
- anthropic/claude-haiku-4-5
- openai/gpt-4o-miniالتحكم في التكلفة (تعيين حدود الإنفاق):
model:
budget:
daily_limit: 5.00 # دولار أمريكي
monthly_limit: 100.00الاستخدام الأساسي: وضع سطر الأوامر (CLI)
بدء تشغيل هيرمس
أبسط طريقة لاستخدام هيرمس:
hermesسترى لافتة ترحيب ويمكنك بدء الدردشة فورًا.
الأوامر الأساسية
داخل هيرمس، يمكنك:
الدردشة بشكل طبيعي:
> مرحبًا، هل يمكنك مساعدتي في كتابة دالة بايثون لتحليل JSON؟استخدام أوامر الشرطة المائلة:
> /help # عرض جميع الأوامر
> /skills # تصفح المهارات المتاحة
> /memory # عرض حالة الذاكرة
> /config # عرض/تعديل التكوين
> /clear # مسح المحادثة الحالية
> /history # عرض المحادثات السابقةإعطاء مهام تعتمد على الملفات:
> انظر إلى الملف ./src/main.py وقم بإعادة هيكلة اتصال قاعدة البياناتتشغيل أوامر المحطة الطرفية:
> تشغيل: npm install && npm run buildسيطلب هيرمس تأكيدًا قبل تنفيذ أي أمر.
شل دائم
على عكس أدوات الذكاء الاصطناعي الأخرى، يحافظ هيرمس على حالة الشل عبر الأوامر:
> cd /my/project && source venv/bin/activate
> python src/main.py # يعمل في نفس جلسة الشلتبقى البيئة الافتراضية نشطة للأوامر اللاحقة.
العمل مع الملفات
قراءة الملفات:
> أظهر لي محتويات config.yamlتعديل الملفات:
> في main.py، غيّر منفذ قاعدة البيانات من 5432 إلى 5433إنشاء ملفات جديدة:
> أنشئ ملفًا جديدًا باسم utils.py يحتوي على دوال مساعدة لتنسيق التاريخسير العمل متعدد الخطوات
يتفوق هيرمس في المهام المعقدة ومتعددة الخطوات:
> أحتاج إلى إضافة مصادقة المستخدم إلى تطبيق Flask الخاص بي. هل يمكنك:
> 1. إعداد نماذج قاعدة البيانات
> 2. إنشاء نقاط نهاية لتسجيل الدخول/الخروج
> 3. إضافة إنشاء رموز JWT
> 4. كتابة اختبارات لتدفق المصادقةسيعمل هيرمس عبر كل خطوة، ويطلب التأكيد على طول الطريق.
بوابة الرسائل: تيليجرام، ديسكورد، سلاك
يمكن لهيرمس أن يعمل كبوت على منصات مراسلة متعددة، بحيث يمكنك التفاعل معه من هاتفك أو دردشة فريقك.
إعداد تيليجرام
1. إنشاء بوت:
- افتح تيليجرام وابحث عن @BotFather
- أرسل
/newbotواتبع التعليمات - انسخ توكن البوت
2. تكوين هيرمس:
hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew113. بدء تشغيل البوابة:
hermes gateway setup telegram
hermes gateway start4. ابدأ الدردشة:
- ابحث عن البوت الخاص بك في تيليجرام
- أرسل
/start - تحدث كما تفعل في سطر الأوامر (CLI)
إعداد ديسكورد
1. إنشاء تطبيق ديسكورد:
- انتقل إلى https://discord.com/developers/applications
- إنشاء تطبيق جديد
- انتقل إلى قسم "البوت" وأنشئ بوتًا
- انسخ توكن البوت
2. دعوة البوت إلى خادمك:
- انتقل إلى "OAuth2" ← "مولد الروابط (URL Generator)"
- اختر نطاق "bot"
- انسخ الرابط الذي تم إنشاؤه وافتحه
3. تكوين هيرمس:
hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
hermes gateway setup discord
hermes gateway start4. الاستخدام في ديسكورد:
- اذكر البوت:
@هيرمس ساعدني في كتابة دالة... - أو استخدم في الرسائل المباشرة
إعداد سلاك
1. إنشاء تطبيق سلاك:
- انتقل إلى https://api.slack.com/apps
- إنشاء تطبيق جديد من الصفر
- أضف أذونات "Bot"
2. التثبيت إلى مساحة العمل ونسخ التوكن
3. تكوين هيرمس:
hermes config set SLACK_BOT_TOKEN xoxb-...
hermes gateway setup slack
hermes gateway startالاستخدام متعدد المنصات
يمكنك تشغيل بوابات متعددة في وقت واحد:
hermes gateway start --allيقوم هيرمس بمزامنة حالة المحادثة عبر جميع المنصات.
تكامل بيئة التطوير المتكاملة (IDE): VS Code، JetBrains
يتكامل هيرمس مباشرة مع محرر التعليمات البرمجية الخاص بك عبر بروتوكول اتصال الوكيل (ACP).
تكامل VS Code
1. تثبيت إضافة ACP:
- افتح VS Code
- انتقل إلى الإضافات (Ctrl+Shift+X)
- ابحث عن "Agent Communication Protocol"
- ثبّت الإضافة
2. تكوين هيرمس كواجهة خلفية:
hermes acp start3. الاستخدام في VS Code:
- افتح الشريط الجانبي لـ ACP
- اختر هيرمس كوكيل خاص بك
- دردش واستخدم أوامر الشرطة المائلة مباشرة في المحرر
تكامل JetBrains (IntelliJ، PyCharm، إلخ.)
1. تثبيت إضافة ACP:
- افتح الإعدادات ← المكونات الإضافية
- ابحث عن "ACP" أو "Agent Communication Protocol"
- ثبّت وأعد تشغيل بيئة التطوير المتكاملة (IDE)
2. بدء تشغيل خادم Hermes ACP:
hermes acp start3. التكوين في JetBrains:
- انتقل إلى الإعدادات ← الأدوات ← وكلاء الذكاء الاصطناعي
- أضف هيرمس كواجهة خلفية لـ ACP
- اختبار الاتصال
محرر Zed
يدعم Zed بروتوكول ACP بشكل أصلي:
1. التكوين في إعدادات Zed:
{
"agent": {
"provider": "acp",
"endpoint": "hermes"
}
}2. بدء تشغيل هيرمس:
hermes acp startنظام الذاكرة والتعلم
تكمن القوة الخارقة لهيرمس في بنية الذاكرة الخاصة به. إليك كيفية استخدامها بفعالية.
أنواع الذاكرة
الذاكرة العرضية: تخزن المحادثات والجلسات المحددة. يمكنك البحث واسترجاع التفاعلات السابقة.
> /memory search "database migration"الذاكرة الدلالية: تبني رسومًا بيانية معرفية حول مشاريعك وتفضيلاتك وأنماطك.
> /memory projectsالذاكرة الإجرائية (المهارات): تنشئ مهارات قابلة لإعادة الاستخدام من المهام المتكررة.
> /skills listالبحث في الجلسات
ابحث عن العمل السابق ذي الصلة باستخدام البحث الدلالي:
> /memory search "كيف تعاملنا مع انتهاء صلاحية JWT الأسبوع الماضي؟"يبحث هيرمس في تاريخك بالكامل ويلخص النتائج.
تنبيهات الذاكرة
يعرض هيرمس المعلومات ذات الصلة بشكل استباقي:
[Hermes]: لاحظت أنك تعمل على نظام المصادقة. يوم الثلاثاء الماضي ذكرت
مشكلة تتعلق بانتهاء صلاحية JWT. هل تريد إعادة النظر في ذلك؟ضغط السياق
يضغط هيرمس السياق تلقائيًا لتجنب الوصول إلى الحدود:
- ضغط البوابة عند استخدام 85% من السياق
- ضغط على مستوى الوكيل بنسبة 50% (قابل للتكوين)
يسمح هذا بمحادثات غير محدودة دون إدارة السياق يدويًا.
تصدير ونسخ احتياطي
تصدير الذاكرة:
hermes memory export ~/backup/hermes-memory.jsonاستيراد الذاكرة:
hermes memory import ~/backup/hermes-memory.jsonالمهارات والمكونات الإضافية
ما هي المهارات؟
المهارات هي سير عمل قابلة لإعادة الاستخدام يمكن لهيرمس تنفيذها. فكر فيها على أنها وحدات ماكرو للمهام المعقدة.
تشمل المهارات المدمجة:
code_review— مراجعة التعليمات البرمجية بحثًا عن الأخطاء والأسلوبdebug_session— سير عمل تصحيح الأخطاء المنهجيapi_tester— اختبار واجهات برمجة تطبيقات REST/GraphQLgit_workflow— عمليات Git مع أفضل الممارساتdocumentation— إنشاء وثائق من التعليمات البرمجية
تصفح وتثبيت المهارات
عرض المهارات المتاحة:
> /skills listتثبيت مهارة:
> /skills install code_reviewاستخدام مهارة:
> /skills run code_review ./src/auth.pyالمهارات المخصصة
أنشئ مهارات مخصصة في ~/.hermes/skills/:
# ~/.hermes/skills/my_skill.py
from hermes.skills import Skill
class MyCustomSkill(Skill):
name = "my_custom_skill"
description = "يفعل شيئًا مفيدًا"
def execute(self, context):
# منطق مهارتك هنا
return "تم تنفيذ المهارة بنجاح"نظام المكونات الإضافية
توسع المكونات الإضافية هيرمس بأدوات وأوامر وخطافات مخصصة.
إنشاء مكون إضافي:
# ~/.hermes/plugins/my_tool.py
from hermes.tools import Tool
class MyCustomTool(Tool):
name = "my_tool"
description = "أداة مخصصة لمهام محددة"
def run(self, **kwargs):
# منطق الأداة هنا
return {"result": "success"}أنواع المكونات الإضافية:
- الأدوات — قدرات جديدة يمكن للوكيل استخدامها
- الأوامر — أوامر الشرطة المائلة الجديدة
- الخطافات — معالجات أحداث دورة الحياة (قبل/بعد الدورات)
الميزات المتقدمة
جدولة Cron
جدولة المهام المؤتمتة:
# اطلب من هيرمس إنشاء مهمة مجدولة
> قم بإعداد ملخص يومي لإشعارات GitHub الخاصة بي في الساعة 9 صباحًاأو قم بالتكوين يدويًا في config.yaml:
cron:
- name: "ملخص يومي"
schedule: "0 9 * * *"
command: "/skills run github_digest"
model: "anthropic/claude-haiku-4-5"تفويض الوكيل الفرعي
يمكن لهيرمس إنشاء وكلاء فرعيين للعمل المتوازي:
> أحتاج منك مراجعة جميع طلبات السحب (PRs) في مستودعي وتلخيص التغييراتسيقوم هيرمس بإنشاء عدة وكلاء فرعيين للعمل بالتوازي، ثم تجميع النتائج.
وضع الصوت
اضغط للتحدث في سطر الأوامر (CLI):
hermes --voiceملاحظات صوتية في تيليجرام/ديسكورد:
- أرسل رسالة صوتية
- يقوم هيرمس بنسخها والرد عليها
قنوات ديسكورد الصوتية:
- يمكن لهيرمس الانضمام إلى القنوات الصوتية
- تحدث واستمع في الوقت الفعلي
التحكم في المتصفح
يتكامل هيرمس مع Browser Use CLI 2.0 لأتمتة الويب:
> انتقل إلى github.com وابحث عن أفضل 5 مستودعات بايثون الرائجةأو اتصل بـ Chrome المباشر عبر CDP:
hermes browser connect --cdpتكامل MCP
يدعم هيرمس خوادم بروتوكول سياق النموذج (MCP):
mcp:
servers:
filesystem:
command: "npx"
args: ["-y", "@modelcontextprotocol/server-filesystem", "~/projects"]
git:
command: "npx"
args: ["-y", "@modelcontextprotocol/server-git"]وضع Worktree
شغّل هيرمس في مساحة عمل (worktree) Git معزولة:
hermes -wيمكن لوكلاء متعددين العمل على نفس المستودع في وقت واحد دون تعارضات.
تشغيل وكلاء آخرين داخل هيرمس
يمكن لهيرمس تشغيل وكلاء ذكاء اصطناعي آخرين كوكلاء فرعيين:
> استخدم claude-code لمراجعة طلب السحب هذاهذا مفيد للاستفادة من الوكلاء المتخصصين لمهام محددة.
استكشاف الأخطاء وإصلاحها
مشاكل شائعة
"لم يتم العثور على مفتاح API"
# تحقق من تعيين مفتاح API
hermes config get OPENROUTER_API_KEY
# أعد تعيينه إذا لزم الأمر
hermes config set OPENROUTER_API_KEY sk-or-..."النموذج غير متاح"
# سرد النماذج المتاحة
hermes models list
# تغيير النموذج
hermes config set model anthropic/claude-opus-4"فشل تشغيل البوابة"
# تحقق من حالة البوابة
hermes gateway status
# أعد تشغيل البوابة
hermes gateway stop
hermes gateway start"تم اكتشاف تلف في الذاكرة"
# نسخ الذاكرة الحالية احتياطيًا
hermes memory export ~/backup/memory-backup.json
# إعادة تعيين الذاكرة
hermes memory reset
# إعادة الاستيراد إذا لزم الأمر
hermes memory import ~/backup/memory-backup.jsonالحصول على المساعدة
المساعدة المدمجة:
> /helpعرض السجلات:
hermes logs tail --followتشغيل التشخيصات:
hermes doctorالأسئلة الشائعة
كم يكلف تشغيل هيرمس؟
هيرمس نفسه مجاني. أنت تدفع فقط مقابل استخدام LLM. التكاليف النموذجية:
- استخدام خفيف (مهام قليلة/يوم): 5-15 دولارًا/الشهر مع OpenRouter
- استخدام متوسط (تطوير منتظم): 20-50 دولارًا/الشهر
- استخدام مكثف (أتمتة على مدار الساعة طوال أيام الأسبوع): 50-200 دولارًا/الشهر
استخدام النماذج المحلية (Ollama) مجاني ولكنه يتطلب عتادًا.
هل يمكن لهيرمس أن يعمل على مدار الساعة طوال أيام الأسبوع؟
نعم. انشر هيرمس على خادم افتراضي خاص (VPS):
# التثبيت على VPS
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# التشغيل كخدمة systemd
hermes service install
hermes service startهل هيرمس مناسب للاستخدام المؤسسي؟
نعم. تشمل ميزات المؤسسات:
- وضع بوابة متعددة المستخدمين مع عزل الجلسات
- إخفاء معلومات التعريف الشخصية (PII) للامتثال
- تشديد أمن سلسلة التوريد
- النشر المستضاف ذاتيًا
- تسجيل التدقيق
كيف أقوم بالترحيل من OpenClaw؟
hermes claw migrate --dry-run # معاينة
hermes claw migrate # ترحيل كامل
hermes doctor # التحققهل يمكنني استخدام هيرمس بدون إنترنت؟
نعم، مع النماذج المحلية:
# تثبيت Ollama
curl -fsSL https://ollama.ai/install.sh | sh
# سحب نموذج
ollama pull qwen2.5-coder:32b
# تكوين هيرمس
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32bما الفرق بين هيرمس و ChatGPT؟
الميزة | هيرمس | ChatGPT |
|---|---|---|
الذاكرة | دائمة، قابلة للبحث | للجلسة فقط |
النشر | مستضاف ذاتيًا، على مدار الساعة طوال أيام الأسبوع | سحابي فقط |
اختيار النموذج | 200+ نموذج | GPT فقط |
قابلية التوسيع | مكونات إضافية، مهارات | محدودة |
التكلفة | الدفع مقابل الاستخدام فقط | اشتراك |
الخصوصية | تتحكم في البيانات | OpenAI تخزن البيانات |
كيف أقوم بعمل نسخة احتياطية من بيانات هيرمس الخاصة بي؟
# تصدير كل شيء
hermes export --all ~/backup/hermes-full-backup.tar.gzهل يمكن لهيرمس الوصول إلى ملفاتي المحلية؟
يمكن لهيرمس الوصول فقط إلى الملفات التي تشير إليها صراحةً أو إلى الأدلة التي منحتها الإذن بالوصول إليها. افتراضيًا، ليس لديه وصول إلى نظام ملفاتك.
