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

Ashley Innocent

Ashley Innocent

30 مارس 2026

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

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

زر

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

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

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

من يجب أن يستخدم هيرمس:

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

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

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

أسرع طريقة لتثبيت هيرمس:

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

يقوم هذا السكريبت بـ:

  1. استنساخ مستودع هيرمس
  2. تثبيت uv (مدير حزم بايثون سريع)
  3. إنشاء بيئة افتراضية
  4. تثبيت جميع التبعيات
  5. إضافة هيرمس إلى متغير 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

سيرشدك المعالج خلال:

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

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

إذا كنت تفضل الإعداد اليدوي، قم بتحرير ملف التكوين:

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

هذا يتحقق من:

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

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

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

لماذا: مفتاح API واحد يمنح الوصول إلى أكثر من 200 نموذج. يتوفر مستوى مجاني.

الإعداد:

hermes config set model openrouter
hermes config set OPENROUTER_API_KEY sk-or-...

نماذج شائعة على OpenRouter:

النموذج

حالة الاستخدام

التكلفة

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

OpenAI مباشر

لماذا: نماذج 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. إنشاء بوت:

2. تكوين هيرمس:

hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

3. بدء تشغيل البوابة:

hermes gateway setup telegram
hermes gateway start

4. ابدأ الدردشة:

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

1. إنشاء تطبيق ديسكورد:

2. دعوة البوت إلى خادمك:

3. تكوين هيرمس:

hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
hermes gateway setup discord
hermes gateway start

4. الاستخدام في ديسكورد:

إعداد سلاك

1. إنشاء تطبيق سلاك:

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:

2. تكوين هيرمس كواجهة خلفية:

hermes acp start

3. الاستخدام في VS Code:

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

1. تثبيت إضافة ACP:

2. بدء تشغيل خادم Hermes ACP:

hermes acp start

3. التكوين في JetBrains:

محرر 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. هل تريد إعادة النظر في ذلك؟

ضغط السياق

يضغط هيرمس السياق تلقائيًا لتجنب الوصول إلى الحدود:

يسمح هذا بمحادثات غير محدودة دون إدارة السياق يدويًا.

تصدير ونسخ احتياطي

تصدير الذاكرة:

hermes memory export ~/backup/hermes-memory.json

استيراد الذاكرة:

hermes memory import ~/backup/hermes-memory.json

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

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

المهارات هي سير عمل قابلة لإعادة الاستخدام يمكن لهيرمس تنفيذها. فكر فيها على أنها وحدات ماكرو للمهام المعقدة.

تشمل المهارات المدمجة:

تصفح وتثبيت المهارات

عرض المهارات المتاحة:

> /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. التكاليف النموذجية:

استخدام النماذج المحلية (Ollama) مجاني ولكنه يتطلب عتادًا.

هل يمكن لهيرمس أن يعمل على مدار الساعة طوال أيام الأسبوع؟

نعم. انشر هيرمس على خادم افتراضي خاص (VPS):

# التثبيت على VPS
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# التشغيل كخدمة systemd
hermes service install
hermes service start

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

نعم. تشمل ميزات المؤسسات:

كيف أقوم بالترحيل من 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

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

يمكن لهيرمس الوصول فقط إلى الملفات التي تشير إليها صراحةً أو إلى الأدلة التي منحتها الإذن بالوصول إليها. افتراضيًا، ليس لديه وصول إلى نظام ملفاتك.

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

ممارسة تصميم API في Apidog

اكتشف طريقة أسهل لبناء واستخدام واجهات برمجة التطبيقات