DEV Community

Cover image for كيفية استخدام وكيل هيرميس
Yusuf Khalidd
Yusuf Khalidd

Posted on • Originally published at apidog.com

كيفية استخدام وكيل هيرميس

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

جرّب Apidog اليوم

ما هو عميل هيرمس؟

عميل هيرمس هو مساعد ذكاء اصطناعي شخصي تم بناؤه بواسطة NousResearch. يعمل باستمرار ويتذكر كل ما يتعلمه، ليبني نموذجًا دائمًا لعملك ومشاريعك وتفضيلاتك، عكس ChatGPT أو Claude.

القدرات الرئيسية:

  • يتذكر: يخزن المحادثات والتعليمات البرمجية والقرارات
  • يتعلم: ينشئ مهارات قابلة لإعادة الاستخدام
  • متعدد المنصات: CLI، تيليجرام، ديسكورد، سلاك، واتساب، IDE
  • مستضاف ذاتيًا: على جهازك، VPS، أو السحابة
  • محايد للموديل: أكثر من 200 نموذج عبر OpenRouter أو مزودين آخرين
  • قابل للتوسيع: نظام مكونات إضافية وأوامر مخصصة

لمن يناسب هيرمس:

  • المطورون الذين يريدون مساعدًا يعرف قاعدة بياناتهم البرمجية
  • الفرق التي تحتاج إلى وكيل مشترك
  • المستخدمون المتقدمون لأتمتة المهام عبر cron
  • الباحثون في تدريب نماذج الذكاء الاصطناعي

التثبيت: خطوة بخطوة

المتطلبات الأساسية

  • نظام التشغيل: macOS، لينكس، أو ويندوز (يفضل WSL)
  • بايثون 3.10+
  • git
  • مفتاح API: OpenRouter، Anthropic، OpenAI أو مزود LLM آخر

تثبيت سريع (موصى به) 

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Enter fullscreen mode Exit fullscreen mode

هذا السكريبت:

  1. يستنسخ مستودع هيرمس
  2. يثبت uv
  3. ينشئ بيئة افتراضية
  4. يثبت كافة التبعيات
  5. يضيف هيرمس إلى PATH

بعد التثبيت، أعد تحميل الشل:

source ~/.bashrc  # bash
source ~/.zshrc   # zsh
Enter fullscreen mode Exit fullscreen mode

للتحقق:

hermes --version
Enter fullscreen mode Exit fullscreen mode

يجب أن تحصل على إصدار مثل: Hermes Agent v0.5.0

تثبيت يدوي (للمطورين) 

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

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
Enter fullscreen mode Exit fullscreen mode

التثبيت مع دعم التدريب المعزز (RL) 

git submodule update --init tinker-atropos
uv pip install -e "./tinker-atropos"
Enter fullscreen mode Exit fullscreen mode

الإعداد والتكوين الأولي

تشغيل معالج الإعداد

ابدأ الإعداد التفاعلي:

hermes setup
Enter fullscreen mode Exit fullscreen mode

يمر بك عبر:

  1. اختيار مزود LLM
  2. تعيين مفاتيح API (تُخزن في ~/.hermes/.env)
  3. تفعيل/تعطيل الذاكرة الدائمة
  4. تحديد واجهة المحطة الطرفية (محلي، Docker، SSH، سحابي)
  5. إعداد تكامل تيليجرام/ديسكورد/سلاك (اختياري)

التكوين اليدوي

لتحرير التكوين يدويًا:

hermes config edit
Enter fullscreen mode Exit fullscreen mode

أو عبر CLI:

hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend local
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...
Enter fullscreen mode Exit fullscreen mode

موقع ملف التكوين 

~/.hermes/
├── config.yaml      # التكوين الرئيسي
├── .env            # مفاتيح API (خاصة)
├── memory/         # الذاكرة
├── skills/         # المهارات
└── plugins/        # المكونات الإضافية
Enter fullscreen mode Exit fullscreen mode

التحقق من الإعداد 

hermes doctor
Enter fullscreen mode Exit fullscreen mode

يتحقق من: التكوين، مفاتيح API، الذاكرة، بوابات الرسائل، اتصال المحطة الطرفية.

اختيار مزود LLM الخاص بك

يدعم هيرمس أكثر من 200 نموذج عبر مزودين مختلفين.

OpenRouter (موصى به للمبتدئين)

مفتاح واحد للوصول إلى مئات النماذج (مستوى مجاني متوفر).

hermes config set model openrouter
hermes config set OPENROUTER_API_KEY sk-or-...
Enter fullscreen mode Exit fullscreen mode

نماذج شائعة:
| النموذج | حالة الاستخدام | التكلفة |
|---|---|---|
| anthropic/claude-opus-4 | البرمجة المعقدة | $$$ |
| anthropic/claude-sonnet-4 | متوازن | $$ |
| openai/gpt-4o | للأغراض العامة | $$ |
| google/gemini-pro-1.5 | سياق طويل | $ |
| meta/llama-3-70b | مفتوح المصدر | $ |

Anthropic مباشر 

hermes config set model anthropic
hermes config set ANTHROPIC_API_KEY sk-ant-...
hermes config set model.default claude-opus-4
Enter fullscreen mode Exit fullscreen mode

OpenAI مباشر 

hermes config set model openai
hermes config set OPENAI_API_KEY sk-...
Enter fullscreen mode Exit fullscreen mode

النماذج المحلية (Ollama) 

# ثبّت Ollama أولاً: https://ollama.ai
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b
Enter fullscreen mode Exit fullscreen mode

أمثلة تكوين متقدم

توجيه ذكي:

model:
  provider: openrouter
  default: anthropic/claude-opus-4
  fallback:
    - anthropic/claude-haiku-4-5
    - openai/gpt-4o-mini
Enter fullscreen mode Exit fullscreen mode

ضبط ميزانية LLM:

model:
  budget:
    daily_limit: 5.00
    monthly_limit: 100.00
Enter fullscreen mode Exit fullscreen mode

الاستخدام الأساسي: وضع سطر الأوامر (CLI)

بدء تشغيل هيرمس 

hermes
Enter fullscreen mode Exit fullscreen mode

ستدخل في جلسة دردشة تفاعلية مباشرة.

الأوامر الأساسية

الدردشة مباشرة:

> مرحبًا، ساعدني في كتابة دالة بايثون لتحليل JSON.
Enter fullscreen mode Exit fullscreen mode

أوامر الشرطة المائلة:

> /help
> /skills
> /memory
> /config
> /clear
> /history
Enter fullscreen mode Exit fullscreen mode

مهام الملفات:

> انظر إلى الملف ./src/main.py وأعد هيكلة اتصال قاعدة البيانات
Enter fullscreen mode Exit fullscreen mode

تشغيل أوامر المحطة الطرفية:

> تشغيل: npm install && npm run build
Enter fullscreen mode Exit fullscreen mode

سيطلب هيرمس تأكيدًا للأوامر التنفيذية.

شل دائم

يحافظ هيرمس على حالة الشل:

> cd /my/project && source venv/bin/activate
> python src/main.py
Enter fullscreen mode Exit fullscreen mode

العمل مع الملفات

  • قراءة: > أظهر لي محتويات config.yaml
  • تعديل: > في main.py، غير منفذ قاعدة البيانات من 5432 إلى 5433
  • إنشاء: > أنشئ ملف utils.py لدوال تنسيق التاريخ

سير العمل متعدد الخطوات 

> أضف مصادقة مستخدم لتطبيق Flask:
1. إعداد نماذج DB
2. إنشاء نقاط نهاية تسجيل الدخول/الخروج
3. إضافة JWT
4. كتابة اختبارات
Enter fullscreen mode Exit fullscreen mode

سيعمل هيرمس عبر كل خطوة مع طلب التأكيد.

بوابة الرسائل: تيليجرام، ديسكورد، سلاك

يمكنك تشغيل هيرمس كبوت على تيليجرام أو ديسكورد أو سلاك.

إعداد تيليجرام

  1. أنشئ بوت عبر @botfather واحتفظ بالتوكن.
  2. في هيرمس: 
   hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF...
   hermes gateway setup telegram
   hermes gateway start
Enter fullscreen mode Exit fullscreen mode
  1. ابحث عن البوت في تيليجرام وأرسل /start.

إعداد ديسكورد

  1. أنشئ تطبيقًا جديدًا في Discord Developers.
  2. أنشئ بوت واحتفظ بالتوكن.
  3. أضف البوت إلى الخادم عبر OAuth2.
  4. في هيرمس: 
   hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
   hermes gateway setup discord
   hermes gateway start
Enter fullscreen mode Exit fullscreen mode
  1. استخدم البوت في الخادم أو الرسائل المباشرة.

إعداد سلاك

  1. أنشئ تطبيقًا جديدًا في Slack Apps وأضف صلاحيات "Bot".
  2. ثبت التطبيق في مساحة العمل واحتفظ بالتوكن.
  3. في هيرمس: 
   hermes config set SLACK_BOT_TOKEN xoxb-...
   hermes gateway setup slack
   hermes gateway start
Enter fullscreen mode Exit fullscreen mode

الاستخدام متعدد المنصات

لتشغيل جميع البوابات:

hermes gateway start --all
Enter fullscreen mode Exit fullscreen mode

يتم مزامنة حالة المحادثة بين جميع المنصات.

تكامل بيئة التطوير المتكاملة (IDE): VS Code، JetBrains

يدعم هيرمس التكامل العملي مع المحررات عبر بروتوكول ACP.

تكامل VS Code

  1. ثبّت إضافة "Agent Communication Protocol" من المتجر.
  2. شغل هيرمس كخادم: 
   hermes acp start
Enter fullscreen mode Exit fullscreen mode
  1. استخدم الشريط الجانبي لـ ACP واختر Hermes.

تكامل JetBrains (IntelliJ، PyCharm...)

  1. ثبّت إضافة ACP من Plugins.
  2. شغل هيرمس: 
   hermes acp start
Enter fullscreen mode Exit fullscreen mode
  1. من الإعدادات → الأدوات → وكلاء الذكاء الاصطناعي، أضف Hermes كواجهة ACP.

محرر Zed

يدعم Zed ACP أصليًا. في إعدادات Zed:

{
  "agent": {
    "provider": "acp",
    "endpoint": "hermes"
  }
}
Enter fullscreen mode Exit fullscreen mode

ثم:

hermes acp start
Enter fullscreen mode Exit fullscreen mode

نظام الذاكرة والتعلم

أنواع الذاكرة

  • العرضية: تخزين المحادثات والبحث فيها 
  > /memory search "database migration"
Enter fullscreen mode Exit fullscreen mode
  • الدلالية: رسوم معرفية حول المشاريع 
  > /memory projects
Enter fullscreen mode Exit fullscreen mode
  • الإجرائية (المهارات): إنشاء مهارات قابلة لإعادة الاستخدام 
  > /skills list
Enter fullscreen mode Exit fullscreen mode

البحث وتنبيهات الذاكرة

ابحث في الجلسات:

> /memory search "كيف تعاملنا مع انتهاء صلاحية JWT الأسبوع الماضي؟"
Enter fullscreen mode Exit fullscreen mode

يعرض هيرمس تنبيهات استباقية عند اكتشاف سياق سابق ذي صلة.

ضغط السياق

يضغط السياق تلقائيًا عند الاقتراب من حدود LLM.

تصدير واستيراد الذاكرة 

hermes memory export ~/backup/hermes-memory.json
hermes memory import ~/backup/hermes-memory.json
Enter fullscreen mode Exit fullscreen mode

المهارات والمكونات الإضافية

ما هي المهارات؟

هي سير عمل قابلة لإعادة الاستخدام، مثل ماكرو للمهام البرمجية المعقدة.

أمثلة:

  • code_review: مراجعة الكود
  • debug_session: تصحيح الأخطاء
  • api_tester: اختبار APIs

تثبيت واستخدام المهارات 

> /skills list
> /skills install code_review
> /skills run code_review ./src/auth.py
Enter fullscreen mode Exit fullscreen mode

إنشاء مهارات مخصصة 

# ~/.hermes/skills/my_skill.py
from hermes.skills import Skill

class MyCustomSkill(Skill):
    name = "my_custom_skill"
    description = "يفعل شيئًا مفيدًا"

    def execute(self, context):
        return "تم تنفيذ المهارة بنجاح"
Enter fullscreen mode Exit fullscreen mode

نظام المكونات الإضافية 

# ~/.hermes/plugins/my_tool.py
from hermes.tools import Tool

class MyCustomTool(Tool):
    name = "my_tool"
    description = "أداة مخصصة لمهام محددة"

    def run(self, **kwargs):
        return {"result": "success"}
Enter fullscreen mode Exit fullscreen mode

أنواع المكونات: أدوات، أوامر، خطافات.

الميزات المتقدمة

جدولة Cron

لجدولة مهمة:

> قم بإعداد ملخص يومي لإشعارات GitHub الخاصة بي في الساعة 9 صباحًا
Enter fullscreen mode Exit fullscreen mode

أو يدويًا في config.yaml:

cron:
  - name: "ملخص يومي"
    schedule: "0 9 * * *"
    command: "/skills run github_digest"
    model: "anthropic/claude-haiku-4-5"
Enter fullscreen mode Exit fullscreen mode

تفويض الوكيل الفرعي 

> راجع جميع PRs في المستودع وخصّص التغييرات
Enter fullscreen mode Exit fullscreen mode

سيتم استدعاء وكلاء فرعيين تلقائيًا.

وضع الصوت

  • CLI: hermes --voice
  • تيليجرام/ديسكورد: أرسل رسالة صوتية وسيتم نسخها والرد عليها
  • ديسكورد: يمكنه الانضمام لقنوات صوتية

التحكم في المتصفح

لأتمتة الويب:

> انتقل إلى github.com وابحث عن أفضل 5 مستودعات بايثون
Enter fullscreen mode Exit fullscreen mode

أو للاتصال بـ Chrome:

hermes browser connect --cdp
Enter fullscreen mode Exit fullscreen mode

تكامل MCP 

mcp:
  servers:
    filesystem:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-filesystem", "~/projects"]
    git:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-git"]
Enter fullscreen mode Exit fullscreen mode

وضع Worktree 

hermes -w
Enter fullscreen mode Exit fullscreen mode

يمكنك تشغيل وكلاء متعددين على نفس المستودع دون تعارضات.

تشغيل وكلاء ذكاء اصطناعي آخرين 

> استخدم claude-code لمراجعة طلب السحب هذا
Enter fullscreen mode Exit fullscreen mode

استكشاف الأخطاء وإصلاحها

مشاكل شائعة

"لم يتم العثور على مفتاح API"

hermes config get OPENROUTER_API_KEY
hermes config set OPENROUTER_API_KEY sk-or-...
Enter fullscreen mode Exit fullscreen mode

"النموذج غير متاح"

hermes models list
hermes config set model anthropic/claude-opus-4
Enter fullscreen mode Exit fullscreen mode

"فشل تشغيل البوابة"

hermes gateway status
hermes gateway stop
hermes gateway start
Enter fullscreen mode Exit fullscreen mode

"تم اكتشاف تلف في الذاكرة"

hermes memory export ~/backup/memory-backup.json
hermes memory reset
hermes memory import ~/backup/memory-backup.json
Enter fullscreen mode Exit fullscreen mode

الحصول على المساعدة

  • المساعدة المدمجة: 
  > /help
Enter fullscreen mode Exit fullscreen mode
  • عرض السجلات: 
  hermes logs tail --follow
Enter fullscreen mode Exit fullscreen mode
  • التشخيص: 
  hermes doctor
Enter fullscreen mode Exit fullscreen mode

الأسئلة الشائعة

كم يكلف تشغيل هيرمس؟

هيرمس مجاني، وتدفع فقط لاستخدام LLM:

  • استخدام خفيف: 5-15$/شهريًا (OpenRouter)
  • متوسط: 20-50$/شهريًا
  • مكثف: 50-200$/شهريًا النماذج المحلية (Ollama) مجانية لكن تحتاج عتاد.

هل يمكن تشغيل هيرمس على مدار الساعة؟

نعم، يمكنك تثبيته على VPS وتشغيله كخدمة systemd:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes service install
hermes service start
Enter fullscreen mode Exit fullscreen mode

هل هيرمس مناسب للاستخدام المؤسسي؟

نعم. يدعم:

  • تعدد المستخدمين مع عزل الجلسات
  • إخفاء PII
  • أمن سلسلة التوريد
  • نشر مستضاف ذاتيًا
  • تسجيل تدقيق

كيف أقوم بالترحيل من OpenClaw؟ 

hermes claw migrate --dry-run
hermes claw migrate
hermes doctor
Enter fullscreen mode Exit fullscreen mode

هل يمكنني استخدام هيرمس بدون إنترنت؟

مع النماذج المحلية:

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
Enter fullscreen mode Exit fullscreen mode

ما الفرق بين هيرمس و ChatGPT؟

الميزة هيرمس ChatGPT
الذاكرة دائمة وقابلة للبحث للجلسة فقط
النشر مستضاف ذاتيًا سحابي فقط
اختيار النموذج 200+ نموذج GPT فقط
قابلية التوسيع مكونات إضافية، مهارات محدودة
التكلفة دفع حسب الاستخدام اشتراك
الخصوصية تتحكم في بياناتك بياناتك لدى OpenAI

كيف أعمل نسخة احتياطية من بيانات هيرمس؟ 

hermes export --all ~/backup/hermes-full-backup.tar.gz
Enter fullscreen mode Exit fullscreen mode

هل يمكن لهيرمس الوصول إلى ملفاتي المحلية؟

فقط للملفات/المجلدات التي تمنحها إذنًا صريحًا. ليس هناك وصول افتراضي لنظام ملفاتك.

💡هل ترغب في اختبار واجهات برمجة التطبيقات (APIs) كجزء من سير عمل التطوير المدعوم بالذكاء الاصطناعي الخاص بك؟ تحقق من Apidog، منصة تطوير واجهة برمجة التطبيقات الشاملة لتصميم واجهات برمجة التطبيقات واختبارها وتوثيقها.

Top comments (0)