1 / 17
🚀
الموديول 12 — الترحيل والمستقبل

الترحيل والمستقبل

من OpenClaw إلى Hermes بالأوامر الحقيقية — ثم البروتوكولات والموديلات والخطة التي بعد الكورس
17 شريحة ثنائي اللغة مشروع الكابستون
شريحة 2 — الترحيل من OpenClaw إلى Hermes
الترحيل من OpenClaw إلى Hermes
الترحيل قراءة من OpenClaw وكتابة في Hermes — OpenClaw بتاعك بيفضل شغّال، مفيش نقطة رجوع
🧭
فلسفة الترحيل
الترحيل عملية قراءة من OpenClaw وكتابة في Hermes. Hermes مش بيكتب في مجلدات OpenClaw أبداً — غير أمر hermes claw cleanup.
الأمر الأساسي — بيشتغل على 5 خطوات: يقرأ، يعرض preview، يسألك تأكيد، ياخد backup، يطبّق.
bash
hermes claw migrate
الخطوة اللي بيحصل
1يقرأ من ~/.openclaw/ (افتراضياً)
2يعرض preview كامل لكل اللي هيتنقل
3يسألك تأكيد قبل أي كتابة
4يأخذ backup بصيغة zip لـ ~/.hermes/ قبل التطبيق
5يطبّق
شريحة 3 — كل خيارات أمر الترحيل
كل خيارات أمر الترحيل
تسعة خيارات موثّقة — ومفيش واحد فيهم بيلغي الـ dry-run
الخيار الوظيفة
--dry-runPreview فقط — مفيش أي كتابة
--preset <name>full أو user-data
--overwriteالكتابة فوق ملفات Hermes الموجودة
--migrate-secretsتضمين الـ API keys — مطلوب حتى مع full
--no-backupتخطّي الـ zip snapshot التمهيدي
--source <path>مجلد OpenClaw مخصص
--workspace-targetمكان وضع AGENTS.md
--skill-conflictskip / overwrite / rename
--yesتخطّي سؤال التأكيد بعد الـ preview
استرجاع الـ backup كامل أو ملف واحد بـ -f:
bash
# استرجاع الـ backup
hermes import ~/.hermes/backups/pre-migration-20260423.zip

# قصر الاسترجاع على ملف واحد باستخدام -f
hermes import ~/.hermes/backups/pre-migration-20260423.zip --force
أداة نسخ احتياطي مستقلة، و--keep افتراضيه 3:
bash
hermes backup                              # backup كامل → ~/hermes-backup-*.zip
hermes backup -o ~/backups/hermes.zip      # مسار مخصص
hermes backup --quick                      # snapshot سريع للحالة بس
hermes backup --quick --label "pre-upgrade" # مع label
⚠️
نقطة أمنية حرجة
مفيش preset بينقل الأسرار. لازم تمرّر --migrate-secrets بشكل صريح.
شريحة 4 — أمثلة حقيقية من الـ docs
أمثلة حقيقية من الـ docs
حرفياً كما هي في التوثيق الرسمي
الأمثلة الأساسية: preview ثم ترحيل، preview فقط، وترحيل كامل مع المفاتيح.
bash
# Preview ثم ترحيل (دايماً بيعرض preview الأول وبعدين يسأل تأكيد)
hermes claw migrate

# Preview فقط، بدون أي تغيير
hermes claw migrate --dry-run

# ترحيل كامل شامل API keys، بدون سؤال تأكيد
hermes claw migrate --preset full --migrate-secrets --yes
أمثلة إضافية من مرجع الـ CLI: ترحيل كامل، ترحيل مع المفاتيح، بيانات المستخدم، ومسار مخصص.
bash
# ترحيل كامل (كل الإعدادات المتوافقة، بدون أسرار)
hermes claw migrate --preset full

# ترحيل كامل مع API keys
hermes claw migrate --preset full --migrate-secrets

# بيانات المستخدم بس (بدون secrets)، مع الكتابة فوق التعارضات
hermes claw migrate --preset user-data --overwrite

# من مسار OpenClaw مخصص
hermes claw migrate --source /home/user/old-openclaw
الحالةالسلوك الافتراضيإزاي تتعامل
ملف Hermes موجود بنفس الاسميرفض التطبيقمرّر --overwrite
skill بنفس الاسمskip--skill-conflict
renameنسخة -importedيبقى عندك الاتنين
💡
الاستراتيجية الآمنة
شغّل --dry-run الأول. اقرأ الـ preview قبل أي كتابة.
شريحة 6 — إيه اللي بينتقل تلقائياً
إيه اللي بينتقل تلقائياً
الشخصية والذاكرة والمهارات والموديلات وسيرفرات MCP
الحاجةOpenClaw (المصدر)Hermes (الوجهة)ملاحظات
Personaworkspace/SOUL.md~/.hermes/SOUL.mdنسخة مباشرة
تعليمات الـ workspaceworkspace/AGENTS.mdAGENTS.mdمحتاج الـ flag
الذاكرة طويلة المدىworkspace/MEMORY.md~/.hermes/memories/MEMORY.mdيتحلّل لـ entries — الفاصل §
ملف المستخدمworkspace/USER.mdUSER.mdنفس منطق الـ entry-merge
الملفات اليوميةworkspace/memory/*.mdMEMORY.mdكل الملفات اليومية بتتدمج
المهارات (4 مصادر)4 مجلداتopenclaw-imports/كلها في مجلد واحد
الموديل الافتراضيagents.defaults.modelconfig.yaml → modelstring أو object
مفاتيح الـ providersapiKey~/.hermes/.envمحتاج --migrate-secrets
سيرفرات MCPmcp.servers.*mcp_servers.*بتنقل بالكامل
إعدادات TTSmessages.ttsconfig.yaml → tts.*3 أماكن
توكنات المراسلةchannels.*.env7 منصات
سلوك الوكيلagents.defaults.*agent.*تحويلات محسوبة
الموافقات والقوائمapprovals.exec.modeapprovals.modeتحويل مباشر
✅
يعني فعلياً
شخصيتك + ذاكرتك + ملاحظاتك اليومية — كلها بتنتقل وتتدمج بإتقان.
شريحة 7 — إيه اللي لازم تعمله يدوياً
إيه اللي لازم تعمله يدوياً
كل حاجة ما اتنقلتش بتتحفظ في أرشيف
archive location
~/.hermes/migration/openclaw/<timestamp>/archive/
الحاجةملف الأرشيفإزاي تعملها في Hermes
IDENTITY.mdarchive/workspace/IDENTITY.mdادمجها في SOUL.md
HEARTBEAT.mdarchive/workspace/HEARTBEAT.mdاستخدم cron jobs
BOOTSTRAP.mdarchive/…/BOOTSTRAP.mdcontext files أو skills
Cron jobscron-config.jsonhermes cron create
Pluginsplugins-config.jsonشوف plugins guide
Hooks / webhookshooks-config.jsonhermes webhook
Skills registryskills-registry…hermes skills config
قائمة الوكلاءagents-list.jsonHermes profiles
ربط القنواتbindings.jsonإعداد يدوي لكل منصة
🕓
Session Lifetime — مقصود إنه ما ينقلش
الـ reset timers مش بيتستوردوا — وده بالتصميم.
الـ SecretRef له ثلاث صيغ، والتلاتة بيتحلوا ما عدا file وexec:
json5
// 1. Plain string
"channels": { "telegram": { "botToken": "123456:ABC-DEF..." } }

// 2. Environment template
"channels": { "telegram": { "botToken": "${TELEGRAM_BOT_TOKEN}" } }

// 3. SecretRef object
"channels": { "telegram": { "botToken": { "source": "env", "id": "TELEGRAM_BOT_TOKEN" } } }
شريحة 8 — الأسرار وقائمة التحقق
الأسرار وقائمة التحقق
عشرة مفاتيح بس بينتقلوا — وأربع خطوات بعد الترحيل
🚫
الـ allowlist — مين ينتقل ومين لأ
فقط 10 مفاتيح بيتنسخوا. أي مفتاح تاني حُطه يدوياً.
1️⃣
اقرأ تقرير الترحيل
بيطبع عدد المتنقل والمتخطى والمتعارض
2️⃣
ابدأ session جديد
المهارات المستوردة محتاجة جلسة جديدة
3️⃣
تحقق من المفاتيح
hermes status + QR لـ WhatsApp
4️⃣
نظّف بعد ما تتأكد
إعادة تسمية لـ .pre-migration/
الأوامر الحقيقية للقائمة:
bash
hermes status                                  # حالة مصادقة الـ providers
systemctl --user restart hermes-gateway        # بعد ترحيل توكنات المراسلة
hermes whatsapp                               # إعادة ربط WhatsApp بـ QR
hermes claw cleanup                           # أرشفة مجلدات OpenClaw المتبقية
شريحة 9 — الترحيل في الاتجاه المعاكس
الاتجاه المعاكس: Hermes ← OpenClaw
مفيش أداة. الإجابة المختصرة: لأ
🚫
هل في أداة؟
مفيش أداة مدعومة. الوثائق بتغطي اتجاه واحد بس.
السببالتفسير
التباين المعماريPython+YAML مقابل Node.js+JSON5
OpenClaw مبيقبلش استيرادمافيش آلية استيراد في OpenClaw
الـ sessions مش portableمفيش مكافئ لـ state.db
لو مضطر ترجع — الشخصية والذاكرة والمهارات أولاً، والـ config هو الأصعب:
bash
# الخطوة 1 — الـ Persona
cp ~/.hermes/SOUL.md ~/.openclaw/workspace/SOUL.md

# الخطوة 2 — الذاكرة (Hermes بيستخدم § كفاصل، OpenClaw بيقرأ نص عادي)
cp ~/.hermes/memories/MEMORY.md  ~/.openclaw/workspace/MEMORY.md
cp ~/.hermes/memories/USER.md    ~/.openclaw/workspace/USER.md

# الخطوة 3 — الـ Skills
cp -r ~/.hermes/skills/* ~/.openclaw/workspace/skills/
💡
القاعدة الذهبية
اعمل snapshot قبل أي ترحيل — ده أرخص قرار هتاخده.
شريحة 10 — إطار القرار
إطار القرار: تختار المنصة إزاي
مفيش منصة أحسن — فيه منصة أحسن لحالتك
decision tree
ابدأ من هنا | |-- محتاج Zalo / WeChat / iMessage؟ | => OpenClaw (Hermes مافيهاش دي أصلاً) |-- محتاج Email (IMAP/SMTP)؟ | => Hermes (OpenClaw مافيهوش Email adapter) |-- محتاج WhatsApp Business Cloud API؟ | => Hermes (مسارات أوضح) |-- محتاج ACP في VS Code / Zed؟ | => Hermes (hermes acp) |-- محتاج enterprise auth (Bedrock/Vertex/Foundry/OAuth)؟ | => Hermes |-- محتاج Kanban + profiles متعددين؟ | => Hermes |-- محتاج Web dashboard + macOS app + Discord voice؟ | => OpenClaw --> مش متأكد => Hermes (إعداد أقل، افتراضات أأمن)
المعيارالوزنOpenClawHermes
عدد المنصات15%45
أمان الافتراضيات15%35
Enterprise auth15%25
Multi-agent10%35
الأتمتة10%35
البروتوكولات10%35
Setup friction10%25
UI / Desktop10%53
الإجمالي100%2.954.70
💡
متى تستخدم الاتنين مع بعض
ما تترحلش — إنك توسّع. الترحيل أداة، مش إيمان.
شريحة 11 — البروتوكولات الناشئة
البروتوكولات الناشئة
ثلاث طبقات تكامل مختلفة
🔌
MCP — Agent → Tools
معيار الأدوات. Hermes: client + server
🤝
A2A — Agent → Agent
تواصل بين الوكلاء — v1.0 كامل
🧑‍💻
ACP — Host/Editor → Agent
Hermes داخل أي محرر — OpenClaw لا
أوامر MCP الموثّقة في Hermes:
bash
hermes mcp                        # picker تفاعلي
hermes mcp catalog                # تصفح السيرفرات المتاحة
hermes mcp install <name>         # تثبيت من الكتالوج
hermes mcp add NAME --url <url>   # إضافة HTTP/SSE server
hermes mcp add NAME --command python3 --arg /path/server.py   # stdio server
hermes mcp test NAME              # اختبار الاتصال
hermes mcp serve                  # تشغيل Hermes كـ MCP server
البروتوكولالطبقةOpenClawHermes
MCPAgent → Tools✅ client✅ client + server
A2AAgent → Agentجزئيكامل
ACPHost → Agent❌كامل
LSPLanguage Server❌hermes lsp
OpenAI proxyOpenAI-compatible❌hermes proxy
EgressSandbox → Internet❌hermes egress
🚨
التحذير الأمني في ACP
الـ security posture = أضعف رابط في السلسلة. قلّص الصلاحيات نفسها.
شريحة 12 — تطور الموديلات
تطور الموديلات وأفضلية الاستقلال
المنصة المرتبطة بموديل واحد بتموت معاه
🔥
أكثر من 40 provider
مش محتاج تعمل حساب في كل شركة
🎚️
اختيار الموديل
اختيار تفاعلي وتبديل وقت التشغيل
🛟
Fallback و MoA
حماية ضد الـ outages
🏠
نماذج محلية
مفيش تكلفة API ومفيش بيانات بتخرج
📺
Per-channel overrides
موديل مختلف لكل قناة
القرار الخاطئالبديل الصح
system_prompt فيه syntax خاص بموديلاكتب تعليمات عامة
code fences بصيغة موديلplain markdown
الاعتماد على knowledge cutoffcontext files و MCP
Tool-calling syntax محددstandard function calling
💼
منصة model-agnostic = ميزة مهنية مش بس تقنية.
شريحة 13 — خطة 12 شهر
خطة 12 شهر للذكاء الاصطناعي
قالب تملاه — أربعة أرباع، وقياس واحد لكل ربع
الربعالثيمنقاط الوصول
Q1 (شهر 1-3)الأساسياتنظام شغّال + أول PR
Q2 (شهر 4-6)التخصصنظام + أول عميل
Q3 (شهر 7-9)الظهور12 مقال / 3 فيديوهات
Q4 (شهر 10-12)التحوّل للدخل20% من الدخل
🎯
قياس واحد لكل ربع
مش اتنين، مش تلاتة
✅
أهداف قابلة للقياس
"3 أنظمة شغّالة 30 يوم" رقم
⏰
وقت أسبوعي مخصص
حدد الساعات في التقويم
⚠️
اكتب المخاطر ونموذج الدخل بنفس صراحة الأرقام
شريحة 14 — فرص العمل
فرص العمل وإزاي تبيع اللي اتعلمته
الأدوار اللي اتخلقوا بسبب المنصات دي
الدورالوصفالمهارات المطلوبة
AI Agent Engineerبناء أنظمة وكلاءPython، MCP
AI Automation Consultantاستشارات للأتمتةسكريبت + فهم الأعمال
AI Platform Engineerمنصات المؤسساتأمن + observability
Agent Ops Engineerتشغيل ومراقبةcron + on-call
MCP Server Developerبناء MCP serversTS/Python
Prompt & Context Engineerتحسين المخرجاتهندسة البرومبت
✅
Must-have في 2026
Python، APIs، MCP، Linux، أمن، debugging
○
Nice-to-have
A2A/ACP، K8s، LLM محلي، تخصص مجال
💼
إزاي تبيع اللي اتعلمته
"ده نظام أتمته فروع شركتي" أقوى من "أنا بعرف AI"
bash
hermes skills install <source>   # اكتب skills في ~/.hermes/skills/
hermes skills publish <name>    # لو كتبت skill بتاعك، انشره في الكتالوج
شريحة 15 — مشروع الكابستون: المواصفات
الكابستون: نظام OCH-Hermes
نظام أتمتة كامل يمرّ على كل الـ 12 وحدة
architecture
Telegram ─┐ Discord ─┼─> Gateway (hermes) ─> Session Store ─> AI Agent Email ─┘ (SOUL.md + Memory) | Cron Scheduler (60s tick) | Kanban Board (multi-profile) | MCP Servers +-----------+------------+-------------+ | | | profile:research profile:coder profile:ops
#الميزةالوحدة المصدر
F1Gateway على 3 منصات3, 4
F2–F3Persona + ذاكرة6
F43+ مهارات6
F5خادم MCP مخصص5
F6–F74+ cron jobs + webhooks8
F8–F93 profiles + kanban7
F10إعدادات أمن4, 5
F11–F12ترحيل + README12
🏁
كل مرحلة مالهاش deliverable = لسه ما بدأش.
شريحة 16 — مراحل الكابستون
مراحل الكابستون (من 0 إلى 9)
الأوامر الحقيقية لكل مرحلة
bash
# Phase 0 — Foundation
mkdir -p ~/och-hermes/{skills,scripts,mcp,runbooks,backups} && cd ~/och-hermes && git init

# Phase 1 — Migration (dry-run ثم تطبيق)
hermes claw migrate --dry-run
hermes claw migrate --preset full --migrate-secrets
ls -la ~/.hermes/migration/openclaw/*/archive/

# Phase 5 — Custom MCP server
hermes mcp add och_tracker --command python3 --arg /home/YOU/och-hermes/mcp/tracker-server.py
hermes gateway restart && hermes mcp test och_tracker

# Phase 7 — Multi-agent
hermes profile create research && hermes profile create coder && hermes profile create ops --clone
hermes kanban init && hermes kanban stats
المرحلةالوقتمعيار القبول الحاسم
0 — التأسيسأسبوعdoctor نظيف + رد في CLI
1 — الترحيليومانتقرير migration + /skills
2 — الذاكرة3 أيامالذاكرة بتفضل بعد /new
3 — المهاراتأسبوع3 skills حقيقية
4 — المنصاتأسبوعغير مصرّح مرفوض
5 — MCPأسبوعmcp test بيعدّي
6 — الأتمتةأسبوع4 cron + --no-agent
7 — Multi-agentأسبوعprofiles + kanban شغّال
8 — Securityيومانsecurity audit نظيف
9 — التسليم3 أيامREADME كافٍ لوحده
bash
# Phase 6 — cron حقيقي: يومي، بلا LLM، أسبوعي، تنبيه كل ساعة
hermes cron create "every 1d at 09:00" "Summarize yesterday's messages and post key items" --name daily-digest --deliver telegram
hermes cron create "every 15m" "Return OK" --name health-check --no-agent --script och-hermes/scripts/health.sh
hermes cron create "every monday 9am" "Review this week's open items and list blockers" --name weekly-review --deliver telegram
hermes cron run daily-digest    # تجربة فورية

# Phase 8 — Security hardening
hermes config set approvals.mode smart
hermes config set security.redact_secrets true
hermes security audit
شريحة 17 — المقارنة النهائية وختام الكورس
المقارنة النهائية وختام الكورس
OpenClaw ضد Hermes — ثم الخطوة اللي بعدها
البُعدالفائزليه
اللغة وملف الإعداداتHermesYAML + .env نظيف
النسخ والاسترجاعHermesbackup + import + dump
أوسع reachOpenClawZalo / WeChat / iMessage
أوسع منصاتHermesEmail + Matrix وغيرها
الأمان والمصادقةHermesOAuth + audit + egress
المهاراتHermesbundles + curator
البروتوكولاتHermesA2A كامل + ACP
واجهة سطح المكتبOpenClawControl UI + macOS app
أقل خصومHermesافتراضات آمنة افتراضياً
🎉
مبروك — خلصت الكورس
رحلة من الـ «ما أعرفش إيه ده» لحد نظام أتمتة production كامل.
📋
خطوتك الجاية (الليلية)
طبّق الكابستون، واكتب، واعمل demo
🧭
تذكير أخير
ابني على المبادئ، مش على الأدوات
شريحة 18 — اختبار المعرفة
اختبار المعرفة
اختبر نفسك — 5 أسئلة سريعة

اختبار الموديول 12

Score: 0/5
Q1: شغّلت hermes claw migrate --preset full ولقيت إن الـ API keys مانتقلتش. ليه؟
لأن مفيش preset بينقل الأسرار — حتى full. لازم --migrate-secrets
لأن الـ backup مفعّل
لأن الـ source كان غلط
لأن OpenClaw مبيخزّنش مفاتيح أصلاً
Q2: رحت تعمل الترحيل ورفض وطلع conflicts. إيه السلوك الصح؟
تشغّل --dry-run وتقرأ الـ preview قبل ما تقرر
تضيف --overwrite على طول
تمسح مجلد ~/.hermes وتعيد من الأول
تستخدم --no-backup
Q3: بعد الترحيل، الـ skills مستوردة بس مش بتظهر والذاكرة مش فاكرة. السبب؟
الجلسة الحالية اتبنت في أولها — افتح /new
لأن المهارات اتنقلت لمجلد تاني
الذاكرة محتاجة embedding provider
لأن الـ gateway محتاجة restart
Q4: في ACP داخل Buzz، الوكيل قدر يشغّل rm -rf من غير موافقة، وapprovals.mode: manual مش بيحل. الحل الصح؟
تقلّص الـ toolset نفسه
ترفع approvals.mode لـ always
تعمل container معزول
تعمل allow_once مرة واحدة بس
Q5: ليه مافيش أمر migrate-to-openclaw في مرجع CLI؟
OpenClaw مافيهوش استيراد + تباين معماري كبير
لأن الأمر لسه في الطريق
لأن الـ sessions مش قابلة للنسخ
لأن الترحيل بياخد وقت أطول