مركز التحكم والعمليات المستمرة

وكيلك مُثبّت، ومتصل بالقنوات، ومُدمج مع الذاكرة والصوت والبريد الإلكتروني. بقيت مشكلة واحدة — لحظة إغلاق الطرفية أو إعادة تشغيل جهازك، كل شيء يتوقف. الوكيل المفيد حقاً يحتاج أن يعمل على مدار الساعة، ويصمد أمام الأعطال، ويتيح لك مراقبة نشاطه من أي مكان.

الحفاظ على تشغيل الوكلاء على مدار الساعة

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

استخدام systemd (خادم Linux VPS)

systemd هو مدير العمليات القياسي في معظم توزيعات Linux. وهو مُثبّت بالفعل على VPS الخاص بك.

أنشئ ملف خدمة لوكيلك:

sudo nano /etc/systemd/system/openclaw-agent.service

[Unit]
Description=OpenClaw AI Agent
After=network.target

[Service]
Type=simple
User=agent
WorkingDirectory=/home/agent/my-agent
ExecStart=/usr/bin/node /usr/lib/node_modules/openclaw/bin/openclaw start
Restart=always
RestartSec=10
Environment=NODE_ENV=production
EnvironmentFile=/home/agent/.env

[Install]
WantedBy=multi-user.target

# تفعيل الخدمة وتشغيلها
sudo systemctl enable openclaw-agent
sudo systemctl start openclaw-agent

# التحقق من الحالة
sudo systemctl status openclaw-agent

# عرض السجلات
sudo journalctl -u openclaw-agent -f

توجيه Restart=always يضمن إعادة تشغيل وكيلك تلقائياً بعد أي عطل. RestartSec=10 يضيف تأخير 10 ثوانٍ بين عمليات إعادة التشغيل لتجنب حلقات إعادة التشغيل السريعة إذا كان هناك خطأ مستمر.

استخدام pm2 (متعدد المنصات)

إذا فضلت حلاً أصلياً لـ Node.js يعمل على كلٍّ من الأجهزة المحلية والخوادم، pm2 هو مدير عمليات شائع:

# تثبيت pm2 بشكل عام
npm install -g pm2

# تشغيل وكيلك مع pm2
pm2 start openclaw -- start

# حفظ قائمة العمليات (تصمد أمام إعادة التشغيل)
pm2 save

# إعداد نص الإقلاع (التشغيل التلقائي عند الإقلاع)
pm2 startup

# أوامر pm2 مفيدة
pm2 status          # عرض جميع العمليات المُدارة
pm2 logs            # بث السجلات مباشرة
pm2 restart all     # إعادة تشغيل جميع العمليات
pm2 monit           # لوحة مراقبة فورية

يوفر pm2 أيضاً لوحة مراقبة مدمجة (pm2 monit) تعرض استخدام المعالج واستهلاك الذاكرة وعدد مرات إعادة التشغيل — مفيدة لفحوصات الصحة السريعة.

الوصول عن بُعد والمراقبة

عندما يعمل وكيلك على VPS، تحتاج لمراقبته دون الوصول الفعلي للخادم.

الوصول عبر SSH

# الاتصال بخادم VPS
ssh agent@your-server-ip

# التحقق من حالة الوكيل
sudo systemctl status openclaw-agent

# عرض السجلات الأخيرة
sudo journalctl -u openclaw-agent --since "1 hour ago"

إعداد لوحة مركز التحكم

لوحة مركز التحكم تمنحك نظرة بصرية شاملة على نشاط وكيلك. يمكنك بناء واحدة باستخدام واجهة ويب بسيطة تعرض:

• حالة الوكيل — يعمل، متوقف، أو حالة خطأ
• الإجراءات الأخيرة — ماذا فعل الوكيل في الساعة الأخيرة؟
• عدد الرسائل — كم رسالة تمت معالجتها عبر القنوات
• سجل الأخطاء — أي إخفاقات أو استثناءات
• استخدام الموارد — المعالج والذاكرة وعدد استدعاءات API

# إعداد لوحة التحكم
dashboard:
  enabled: true
  port: 3001
  auth:
    username: ${DASHBOARD_USER}
    password: ${DASHBOARD_PASS}
  metrics:
    - agent_status
    - messages_processed
    - api_calls_count
    - error_count
    - uptime

احمِ لوحة التحكم بالمصادقة — فهي تكشف تفاصيل تشغيلية عن وكيلك لا يجب أن تكون متاحة للعامة.

الإشعارات على الهاتف المحمول

المراقبة من حاسوب محمول جيدة. المراقبة من معصمك أفضل. عندما يواجه وكيلك أخطاءً أو يكمل مهام حرجة أو يحتاج مدخلات بشرية، تريد أن تعرف فوراً.

إشعارات Apple Watch عبر TGWatch

TGWatch هو عميل تيليجرام لـ Apple Watch. بما أن وكيلك يتواصل بالفعل عبر تيليجرام، هذا ينشئ خط أنابيب إشعارات طبيعي:

1. وكيلك يرسل رسالة تيليجرام عن مهمة مكتملة أو خطأ
2. إشعار تيليجرام يظهر على هاتفك
3. TGWatch ينقله إلى Apple Watch
4. يمكنك قراءة الإشعار وحتى الرد بردود سريعة

هذا يعني أن وكيلك يمكنه نقر معصمك عندما يحتاج الاهتمام — لا حاجة للتحقق من لوحة تحكم أو فتح حاسوبك المحمول.

للتنبيهات الحرجة، هيّئ وكيلك لإرسال رسائل إلى قناة تيليجرام مخصصة للتنبيهات:

# إعداد التنبيهات
alerts:
  channel: telegram
  chat_id: ${ALERT_CHAT_ID}
  triggers:
    - event: error
      message: "الوكيل واجه خطأ: {error_details}"
    - event: task_complete
      message: "المهمة اكتملت: {task_summary}"
    - event: approval_needed
      message: "الموافقة البشرية مطلوبة: {action_description}"

مراقبة السجلات وفحوصات الصحة

السجلات هي صندوق الرحلات الأسود لوكيلك. عندما يحدث خطأ ما، السجلات تخبرك ماذا حدث ولماذا.

التسجيل المنظم

هيّئ وكيلك لكتابة سجلات منظمة سهلة البحث والتصفية:

# إعداد التسجيل
logging:
  level: info
  format: json
  output:
    - file: /var/log/openclaw/agent.log
    - stdout
  rotation:
    max_size: 50MB
    max_files: 10

نقطة فحص الصحة

أعدّ فحص صحة بسيط يمكن لأدوات المراقبة الخارجية استقصاؤه:

# إعداد فحص الصحة
health_check:
  enabled: true
  port: 3002
  path: /health
  checks:
    - name: model_connection
      timeout: 5s
    - name: telegram_connection
      timeout: 5s
    - name: memory_access
      timeout: 3s

# اختبار فحص الصحة
curl http://localhost:3002/health

نقطة فحص الصحة تُرجع رد حالة بسيط. خدمات المراقبة الخارجية يمكنها استقصاء هذه النقطة بانتظام وتنبيهك إذا توقفت عن الاستجابة.

نصائح عملية للموثوقية

ابدأ بالبساطة: استخدم pm2 أو systemd، ليس نظام تنسيق حاويات معقد. أنت تشغل عملية وكيل واحدة، ليس نظاماً موزعاً.

راقب تكاليف API: أعدّ تنبيهات تكلفة يومية مع مزود النموذج. الوكيل العالق في حلقة إعادة محاولة يمكنه استهلاك رصيد API بسرعة.

طبّق الإيقاف السلس: عندما يتلقى وكيلك إشارة توقف، يجب أن ينهي المهام الجارية قبل الإيقاف، وليس القطع في منتصف الإجراء.

اختبر التعافي من الأعطال: عطّل وكيلك عمداً وتحقق من إعادة تشغيله بشكل صحيح. تأكد أن الذاكرة محفوظة، واتصالات القنوات أُعيد تأسيسها، والمهام الجارية مُعالجة.

أبقِ السجلات مُدوّرة: السجلات غير المُدوّرة ستملأ القرص في النهاية. هيّئ تدوير السجلات من اليوم الأول.

النقطة الرئيسية: العمليات المستمرة تتطلب إدارة العمليات والمراقبة عن بُعد والإشعارات على الهاتف. استخدم systemd أو pm2 للحفاظ على تشغيل وكيلك، وأعدّ لوحة تحكم للرؤية، ووجّه التنبيهات الحرجة لهاتفك أو ساعتك. الموثوقية ليست عن منع كل الأعطال — بل عن اكتشافها والتعافي منها تلقائياً.

الوحدة التالية: بناء مهارات وكيلك وتكاملات الأدوات لتنفيذ المهام في العالم الحقيقي. :::