وكلاء البرمجة عبر تلغرام: من الصفر إلى وكيل يجيب على استفساراتك

توقف عن القراءة وابدأ بالتنفيذ.

بنهاية هذا الدليل، سيكون لديك موضوع (topic) في تلغرام حيث يقوم وكيل برمجي بالرد على رسائلك. سيقوم هذا الوكيل بالتحكم في نافذة tmux على جهازك الخاص.

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

⏱️ الوقت المطلوب: 30–45 دقيقة.

🛠️ المتطلبات المسبقة

قبل البدء، تأكد من جاهزية العناصر التالية:

  • جهاز يحتوي على tmux وصلاحية الوصول إلى shell.
  • وكيل برمجي يعمل (مثل OpenCode أو Claude Code) يعمل بالفعل في نافذة tmux.
  • هدف tmux المحدد لوكيلك (مثال: mybox:1.1).
  • الأمر المحدد لتشغيل وكيلك.
  • تثبيت بيئة تشغيل OpenClaw.
  • حساب تلغرام وتطبيق تلغرام.

📦 الإصدارات المطلوبة

لا تتخطَّ هذه الخطوات؛ فالإصدارات الخاطئة تسبب فشلاً صامتاً.

• Node.js: 24.11.1 • مدير الحزم: pnpm 11.2.2 • OpenClaw: قم بالتثبيت على commit محدد (Pin to a specific commit).

🚀 مسار الإعداد السريع

يمكنك استخدام هذه السكربتات لإتمام الإعداد المحلي:

  1. تحميل السكربتات: curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/cd0f8353aac74e47c591111b758943e9/raw/setup-openclaw.sh" -o setup-openclaw.sh curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/7cf94af3e96526f9f14d0c28b6c26b69/raw/ready-check.sh" -o ready-check.sh chmod +x setup-openclaw.sh ready-check.sh

  2. تشغيل الإعداد باستخدام رمز البوت (bot token) الخاص بك: OPENCLAW_BOT_TOKEN="<YOUR_TOKEN>" OPENCLAW_BOT_ACCOUNT="my-bot" ./setup-openclaw.sh

  3. التحقق من الإعداد: AGENT_ID=my-agent PANE=mybox:1.1 ./ready-check.sh

📱 إعداد تلغرام

اتبع هذه الخطوات في تطبيق تلغرام الخاص بك:

  • أنشئ بوتاً عبر @BotFather واحفظ الرمز (token).
  • أنشئ مجموعة جديدة وأضف البوت إليها.
  • اجعل البوت مسؤولاً (Administrator). هذا سيسمح له برؤية رسائلك.
  • قم بتفعيل "المواضيع" (Topics) في إعدادات المجموعة.
  • أنشئ موضوعاً لمشروعك.
  • أرسل رسالة واحدة في ذلك الموضوع لإنشاء معرف موضوع (Topic ID) في سجلاتك.

⚙️ الربط معاً

تستخدم البوابة ملف تكوين JSON في ~/.openclaw/openclaw.json.

استخدم المرحلة الأولى (Phase 1) للعثور على معرف الدردشة (Chat ID) ومعرف الموضوع (Topic ID) عن طريق إرسال رسالة والتحقق من سجلات البوابة.

استخدم المرحلة الثانية (Phase 2) لتأمين المجموعة. قم بتغيير السياسة إلى "القائمة المسموح بها" (allowlist) وأضف معرف مستخدم تلغرام الرقمي الخاص بك فقط. قم بربط معرف الموضوع (Topic ID) بمعرف الوكيل (Agent ID) الخاص بك.

📝 عقد الوكيل (The Agent Contract)

قم بإنشاء ملف AGENTS.md في مساحة عمل الوكيل (agent workspace) الخاصة بك. يخبر هذا الملف الوكيل بكيفية التصرف. يجب عليك تحديد:

  • كيفية قراءة اللوحة (tmux capture-pane).
  • كيفية الكتابة في اللوحة (tmux send-keys).
  • كيفية التعامل مع أوامر محددة مثل "status" أو "send" أو "restart".

✅ اختبار الجاهزية

لن تنتهي إلا عند اجتياز هذه الاختبارات الخمسة:

  1. يرد البوت في موضوع (topic) التليجرام الخاص بك.
  2. يصل طلبك (prompt) إلى لوحة tmux.
  3. يبدأ وكيل البرمجة (coding agent) في العمل على الطلب.
  4. يثبت ملف السجل (log file) أن الوكيل قد تعامل مع موضوعك.
  5. يتم قفل المجموعة لتقتصر على معرف المستخدم (User ID) الخاص بك فقط.

المصدر: https://dev.to/jerilk/coding-agents-over-telegram-part-2-from-zero-to-an-agent-that-answers-2777

مجتمع تعليمي اختياري: https://t.me/GyaanSetuAi