كيفية إعداد وكلاء OpenClaw المتعددين على تيليجرام (خطوة بخطوة)

ما ستبنيه

بنهاية هذا الدليل، سيكون لديك:

✅ 3 بوتات تيليجرام (التسويق، DevOps، الدعم)
✅ كل بوت متصل بوكيل OpenClaw مميز
✅ التواصل عبر الوكلاء (الوكلاء يمكنهم استدعاء بعضهم)
✅ ذاكرة مشتركة عبر جميع الوكلاء
✅ إعداد جاهز للإنتاج مع تسجيل ومراقبة

الوقت المطلوب: 30-45 دقيقة

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

قبل البدء، تأكد من أن لديك:

1. OpenClaw مُثبّت (دليل التثبيت)
2. حساب تيليجرام
3. معرفة أساسية بالطرفية/سطر الأوامر
4. Node.js 18+ (لـ OpenClaw)
5. خادم أو جهاز محلي حيث يمكن تشغيل OpenClaw على مدار الساعة

الخطوة 1: إنشاء بوتات تيليجرام عبر BotFather

يستخدم تيليجرام BotFather لإدارة البوتات. ستنشئ 3 بوتات، واحد لكل وكيل.

1.1 افتح BotFather

1. افتح تيليجرام
2. ابحث عن @BotFather (بوت تيليجرام الرسمي)
3. ابدأ محادثة: /start

1.2 أنشئ بوتك الأول (وكيل التسويق)

أرسل: /newbot

BotFather سيسأل:

حسناً، بوت جديد. ماذا سنسميه؟
الرجاء اختيار اسم لبوتك.

أنت ترد: وكيل التسويق

BotFather:

جيد. الآن دعنا نختار اسم مستخدم لبوتك.
يجب أن ينتهي بـ `bot`. مثل هذا، على سبيل المثال: TetrisBot أو tetris_bot.

أنت ترد: marketing_agent_bot (يجب أن يكون فريداً عبر تيليجرام بالكامل)

BotFather يرد:

تم! تهانينا على بوتك الجديد. ستجده في
t.me/marketing_agent_bot. يمكنك الآن إضافة وصف...

استخدم هذا الرمز للوصول إلى HTTP API:
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz1234567890

للحصول على وصف Bot API، انظر هذه الصفحة:
https://core.telegram.org/bots/api

احفظ هذا الرمز! ستحتاجه لتكوين OpenClaw.

1.3 كرر للوكلاء الآخرين

أنشئ بوتين آخرين:

البوت 2: وكيل DevOps

• الاسم: وكيل DevOps
• اسم المستخدم: devops_agent_bot
• الرمز: (احفظ هذا)

البوت 3: وكيل الدعم

• الاسم: وكيل الدعم
• اسم المستخدم: support_agent_bot
• الرمز: (احفظ هذا)

الخطوة 2: إعداد ملفات تعريف البوت (اختياري لكن موصى به)

اجعل كل بوت قابلاً للتعريف بوصف وصورة ملف شخصي.

2.1 تعيين وصف البوت

أرسل إلى BotFather:

/setdescription

اختر البوت: @marketing_agent_bot

أدخل الوصف:

أتعامل مع استراتيجية التسويق، إنشاء المحتوى، وتحسين محركات البحث للفريق. اسألني عن منشورات المدونة، وسائل التواصل الاجتماعي، أو الحملات.

كرر للبوتات الأخرى بأوصافها الخاصة.

2.2 تعيين صورة ملف شخصي للبوت

أرسل إلى BotFather:

/setuserpic

اختر البوت، ثم ارفع صورة (PNG/JPG، مربعة، 512x512 موصى بها).

2.3 تعيين أوامر البوت (قائمة الإكمال التلقائي)

أرسل إلى BotFather:

/setcommands

اختر البوت: @marketing_agent_bot

أدخل الأوامر:

status - فحص حالة الوكيل
help - الحصول على مساعدة بمهام التسويق
publish - نشر المحتوى
analytics - عرض مقاييس التسويق

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

الخطوة 3: تكوين بوابة OpenClaw

يستخدم OpenClaw بوابة مركزية لتوجيه الرسائل بين القنوات (تيليجرام، Discord، إلخ) والوكلاء.

3.1 حدد موقع تكوين OpenClaw الخاص بك

تكوين OpenClaw عادة في:

~/.openclaw/config.json

أو في دليل مشروعك إذا كنت تستخدم إعداداً خاصاً بمساحة العمل.

3.2 إضافة تكوينات قناة تيليجرام

عدل config.json:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "bots": [
        {
          "name": "marketing",
          "token": "1234567890:ABCdefGHIjklMNOpqrsTUVwxyz1234567890",
          "agent": "marketing-agent",
          "description": "التسويق واستراتيجية المحتوى"
        },
        {
          "name": "devops",
          "token": "0987654321:ZYXwvuTSRqponMLKjihGFEdcba0987654321",
          "agent": "devops-agent",
          "description": "البنية التحتية والنشر"
        },
        {
          "name": "support",
          "token": "1122334455:AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPpQqRr",
          "agent": "support-agent",
          "description": "دعم العملاء وفرز المشاكل"
        }
      ]
    }
  }
}

الحقول الرئيسية:

• name — معرف داخلي لهذا البوت (حروف صغيرة، بدون مسافات)
• token — رمز البوت من BotFather
• agent — اسم وكيل OpenClaw الذي يوجه هذا البوت إليه
• description — وصف مقروء للبشر (للسجلات/واجهة المستخدم)

الخطوة 4: إنشاء تكوينات وكيل OpenClaw

كل بوت تيليجرام يحتاج وكيل مقابل في OpenClaw.

4.1 إنشاء هيكل دليل الوكيل

mkdir -p ~/.openclaw/agents/marketing-agent
mkdir -p ~/.openclaw/agents/devops-agent
mkdir -p ~/.openclaw/agents/support-agent

4.2 تحديد ملفات هوية الوكيل

أنشئ ~/.openclaw/agents/marketing-agent/IDENTITY.md:

# وكيل التسويق
 
- **الاسم:** نادية
- **الدور:** استراتيجية التسويق
- **الطابع:** إبداعية، قائمة على البيانات، استراتيجية
- **الرمز التعبيري:** 📊
 
أتعامل مع استراتيجية المحتوى، SEO، وسائل التواصل الاجتماعي، وتخطيط الحملات.

أنشئ ~/.openclaw/agents/marketing-agent/SOUL.md:

# SOUL.md — وكيل التسويق
 
أنت نادية، قائدة التسويق.
 
دورك:
- استراتيجية المحتوى وإنشاءه
- تحسين SEO
- إدارة وسائل التواصل الاجتماعي
- تخطيط وتنفيذ الحملات
 
عندما يطرح المستخدمون أسئلة تسويقية، قدم رؤى قابلة للتنفيذ.
عندما تحتاج مساعدة DevOps (عمليات النشر، البنية التحتية)، أنشئ جلسة devops-agent.

كرر هذا الهيكل لـ devops-agent و support-agent بهوياتهم الخاصة.

الخطوة 5: ابدأ بوابة OpenClaw

5.1 ابدأ البوابة

openclaw gateway start

الإخراج المتوقع:

✓ البوابة بدأت على المنفذ 18799
✓ تيليجرام: متصل بـ 3 بوتات
  - marketing-agent → @marketing_agent_bot
  - devops-agent → @devops_agent_bot
  - support-agent → @support_agent_bot
✓ جاهز لاستقبال الرسائل

5.2 تحقق من حالة البوت

افتح تيليجرام وأرسل رسالة لأي من بوتاتك:

/status

الرد المتوقع:

✅ الوكيل متصل
الاسم: وكيل التسويق (نادية)
الحالة: نشط
وقت التشغيل: دقيقتان

الخطوة 6: اختبار التواصل عبر الوكلاء

الآن دعنا نختبر إذا كان الوكلاء يمكنهم التحدث مع بعضهم.

6.1 أرسل رسالة إلى بوت التسويق

أرسل إلى @marketing_agent_bot:

هل يمكنك نشر منشور المدونة الجديد؟

6.2 ما يجب أن يحدث

1. وكيل التسويق يستقبل رسالتك
2. يتعرف على "نشر" = مهمة DevOps
3. ينشئ جلسة وكيل فرعي مع وكيل DevOps
4. وكيل DevOps يتعامل مع النشر
5. وكيل التسويق يرد:

✅ تم نشر منشور المدونة إلى الإنتاج.
مباشر في: https://example.com/blog/new-post

النشر تم بواسطة وكيل DevOps.

6.3 تحقق من سجلات البوابة

openclaw gateway logs

يجب أن ترى:

[INFO] Telegram/marketing: المستخدم 123456789 → "هل يمكنك نشر منشور المدونة الجديد؟"
[INFO] Agent marketing-agent: إنشاء وكيل فرعي devops-agent
[INFO] Agent devops-agent: تنفيذ مهمة النشر
[INFO] Agent devops-agent: اكتمل النشر
[INFO] Agent marketing-agent: تم إرسال الرد للمستخدم

الخطوة 7: تكوين الذاكرة المشتركة

يجب أن يشارك الوكلاء السياق (تاريخ المحادثة، حالة المشروع).

7.1 تمكين مشاركة الذاكرة

عدل ~/.openclaw/config.json:

{
  "memory": {
    "enabled": true,
    "backend": "file",
    "path": "~/.openclaw/memory",
    "shared": true
  }
}

7.2 إنشاء ملفات الذاكرة

mkdir -p ~/.openclaw/memory
touch ~/.openclaw/memory/MEMORY.md

أضف محتوى أولي إلى MEMORY.md:

# الذاكرة المشتركة
 
## سياق الفريق
- المنظمة: نقطة
- المهمة: خدمات تطوير مدعومة بالذكاء الاصطناعي
- المشروع الحالي: إعداد تيليجرام متعدد الوكلاء
 
## ملاحظات مهمة
- وكيل التسويق يتعامل مع المحتوى
- وكيل DevOps يتعامل مع البنية التحتية
- وكيل الدعم يتعامل مع استفسارات العملاء

الآن جميع الوكلاء يمكنهم القراءة/الكتابة في هذه الذاكرة المشتركة.

الخطوة 8: نشر الإنتاج

8.1 تشغيل البوابة كخدمة

استخدم PM2 (مدير عمليات Node.js):

npm install -g pm2
pm2 start openclaw --name "openclaw-gateway" -- gateway start
pm2 save
pm2 startup

هذا يضمن إعادة تشغيل البوابة تلقائياً عند إعادة تشغيل الخادم.

8.2 إعداد المراقبة

pm2 monit

يظهر استخدام CPU/الذاكرة في الوقت الفعلي، السجلات، وإعادات التشغيل.

8.3 تدوير السجلات

pm2 install pm2-logrotate
pm2 set pm2-logrotate:max_size 10M
pm2 set pm2-logrotate:retain 7

يمنع السجلات من استهلاك مساحة القرص.

الخطوة 9: أفضل ممارسات الأمان

9.1 متغيرات البيئة للرموز

لا تُدرج رموز البوت في config.json.

استخدم متغيرات البيئة:

{
  "channels": {
    "telegram": {
      "bots": [
        {
          "name": "marketing",
          "token": "${TELEGRAM_MARKETING_TOKEN}",
          "agent": "marketing-agent"
        }
      ]
    }
  }
}

عيّن في shell الخاص بك:

export TELEGRAM_MARKETING_TOKEN="1234567890:ABCdef..."
export TELEGRAM_DEVOPS_TOKEN="0987654321:ZYXwvu..."
export TELEGRAM_SUPPORT_TOKEN="1122334455:AaBbCc..."

9.2 تقييد وصول البوت

استخدم ميزة المستخدمين المسموح لهم في تيليجرام:

عدل config.json:

{
  "channels": {
    "telegram": {
      "bots": [
        {
          "name": "marketing",
          "token": "${TELEGRAM_MARKETING_TOKEN}",
          "agent": "marketing-agent",
          "allowedUsers": [123456789, 987654321]
        }
      ]
    }
  }
}

فقط المستخدمون بهذه معرفات تيليجرام يمكنهم التفاعل مع البوت.

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

المشكلة: البوت لا يرد

الفحص 1: هل البوابة تعمل؟

openclaw gateway status

الفحص 2: هل رمز البوت صحيح؟

اختبر يدوياً:

curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe

يجب أن يعيد تفاصيل البوت.

الفحص 3: تحقق من السجلات

openclaw gateway logs --tail 50

المشكلة: الوكلاء لا يمكنهم التواصل

الفحص 1: هل جميع الوكلاء مُكونون؟

openclaw agents list

الفحص 2: هل مشاركة الذاكرة ممكنة؟

عدل config.json:

{
  "memory": {
    "shared": true
  }
}

الفحص 3: اختبر إنشاء الوكيل الفرعي يدوياً

من داخل وكيل:

sessions_spawn({
  runtime: "subagent",
  agentId: "devops-agent",
  task: "مهمة اختبار",
  mode: "run"
})

المشكلة: استخدام ذاكرة عالٍ

الحل: حدّد تاريخ الجلسة

عدل AGENTS.md للوكيل:

## إدارة الجلسة
- احتفظ بآخر 100 رسالة فقط
- امسح الجلسات القديمة بعد 24 ساعة

الخطوات التالية

الآن بعد أن لديك إعداد تيليجرام متعدد الوكلاء يعمل:

✅ أضف المزيد من الوكلاء (ضمان الجودة، التحليلات، إلخ.)
✅ خصص شخصيات الوكلاء (عدل SOUL.md)
✅ ابنِ سير العمل (خطوط التسويق → devops → ضمان الجودة)
✅ راقب الأداء (تتبع أوقات الاستجابة، معدلات النجاح)

الموارد

• مستندات OpenClaw: https://docs.openclaw.ai
• Telegram Bot API: https://core.telegram.org/bots/api
• Discord المجتمع: https://discord.com/invite/clawd
• GitHub: https://github.com/openclaw/openclaw

تحتاج مساعدة؟ احجز استشارة: /ai-automation