إعداد بيئة الوكيل الخاصة بك

قنوات الاتصال: تيليجرام وديسكورد

4 دقيقة للقراءة

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

لماذا هاتان القناتان

تيليجرام مثالي للتفاعل الشخصي الفردي مع الوكيل. يعمل على كل جهاز، ويدعم الوسائط الغنية (الصور، المستندات، الملاحظات الصوتية)، وواجهة Bot API الخاصة به من أسهل الواجهات للتعامل معها. عندما تريد أن يشعر وكيلك كمساعد شخصي في جيبك، تيليجرام هو الخيار الصحيح.

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

إعداد بوت تيليجرام

بوتات تيليجرام تُنشأ من خلال BotFather، أداة إدارة البوتات الرسمية في تيليجرام.

الخطوة الأولى: إنشاء البوت

  1. افتح تيليجرام وابحث عن @BotFather
  2. أرسل الأمر /newbot
  3. اختر اسماً للعرض (مثل "وكيلي الذكي")
  4. اختر اسم مستخدم ينتهي بـ bot (مثل my_ai_agent_bot)
  5. يرد BotFather بـ رمز البوت — احفظه بشكل آمن

الخطوة الثانية: إعداد البوت في OpenClaw

# في إعدادات OpenClaw
channels:
  telegram:
    bot_token: ${TELEGRAM_BOT_TOKEN}
    allowed_users:
      - "your_telegram_user_id"
# تعيين الرمز كمتغير بيئة
export TELEGRAM_BOT_TOKEN="your-bot-token-here"

الخطوة الثالثة: تعيين أوامر البوت (اختياري لكن مستحسن)

أرسل هذه إلى BotFather لتحديد قائمة أوامر البوت:

/setcommands
status - التحقق من حالة الوكيل
help - عرض الأوامر المتاحة
task - تعيين مهمة جديدة

الخطوة الرابعة: الحصول على معرّف المستخدم

لتقييد البوت للرد عليك فقط، تحتاج معرّف مستخدم تيليجرام الخاص بك. أرسل رسالة إلى @userinfobot على تيليجرام — سيرد بمعرّفك الرقمي.

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

بوتات ديسكورد تتطلب خطوات إضافية بسبب نظام الصلاحيات والنوايا في ديسكورد.

الخطوة الأولى: إنشاء تطبيق ديسكورد

  1. اذهب إلى بوابة مطوري ديسكورد (discord.com/developers/applications)
  2. انقر "New Application" وأعطه اسماً
  3. انتقل لقسم "Bot" وانقر "Add Bot"
  4. انسخ رمز البوت — احفظه بشكل آمن
  5. تحت "Privileged Gateway Intents"، فعّل Message Content Intent (مطلوب لقراءة الرسائل)

الخطوة الثانية: دعوة البوت لخادمك

  1. في بوابة المطورين، اذهب إلى "OAuth2" ثم "URL Generator"
  2. اختر النطاقات: bot، applications.commands
  3. اختر الصلاحيات: Send Messages، Read Message History، Embed Links، Attach Files
  4. انسخ الرابط المُولّد وافتحه في متصفحك لدعوة البوت

الخطوة الثالثة: الإعداد في OpenClaw

# في إعدادات OpenClaw
channels:
  discord:
    bot_token: ${DISCORD_BOT_TOKEN}
    allowed_guilds:
      - "your_server_id"
    allowed_roles:
      - "agent-operator"
# تعيين الرمز كمتغير بيئة
export DISCORD_BOT_TOKEN="your-discord-bot-token-here"

ميزة السياق المتوازي في ديسكورد

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

القناة الغرض سلوك الوكيل
#research مهام البحث على الويب الوكيل يبحث ويلخص ويحفظ النتائج
#code-review تحليل الكود الوكيل يراجع طلبات الدمج ويقدم ملاحظات
#email-drafts كتابة البريد الإلكتروني الوكيل يصيغ رسائل لمراجعتك
#daily-briefing التقارير الصباحية الوكيل ينشر ملخصات يومية حسب الجدول
#logs سجلات نشاط الوكيل الوكيل يسجل جميع الإجراءات للمراجعة

كل قناة تحافظ على سياق محادثة خاص بها. عندما تراسل الوكيل في #research، لا يخلط ذلك مع المحادثة الجارية في #code-review. هذا العزل الطبيعي يعني أنه يمكنك تشغيل سير عمل متعددة بالتوازي دون تلوث السياق.

يمكنك إعداد هذا بإنشاء قنوات في خادم ديسكورد وتهيئة الوكيل لمراقبة قنوات محددة:

channels:
  discord:
    bot_token: ${DISCORD_BOT_TOKEN}
    monitored_channels:
      - name: "research"
        purpose: "البحث على الويب والتلخيص"
      - name: "code-review"
        purpose: "تحليل ومراجعة الكود"
      - name: "email-drafts"
        purpose: "كتابة ومراجعة البريد الإلكتروني"

اعتبارات أمنية

قنوات المراسلة هي واجهة مباشرة لقدرات وكيلك. تأمينها أمر بالغ الأهمية.

قوائم السماح: قيّد دائماً البوت للمستخدمين المعروفين (تيليجرام) أو خوادم وأدوار محددة (ديسكورد). البوت غير المقيد ثغرة أمنية — أي شخص يجده يمكنه إصدار أوامر.

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

أمان الرموز: رموز البوت تعادل كلمات المرور. لا تضعها أبداً في أنظمة التحكم بالإصدارات. استخدم متغيرات البيئة أو مدير أسرار.

# خطأ: الرمز مكتوب مباشرة في الإعدادات
bot_token: "7234567890:AAF..."

# صحيح: الرمز يُحمّل من متغير البيئة
bot_token: ${TELEGRAM_BOT_TOKEN}

تحديد المعدل: طبّق حدوداً للمعدل لمنع فيضان الرسائل العرضي أو الخبيث من تشغيل استدعاءات API مفرطة ورفع التكاليف.

تسجيل المراجعة: سجّل جميع الأوامر المستلمة والإجراءات المتخذة. إذا حدث خطأ ما، تحتاج مساراً واضحاً لما حدث ومن أطلقه.

النقطة الرئيسية: تيليجرام يمنحك مساعداً شخصياً في جيبك. ديسكورد يمنحك مركز تحكم متعدد القنوات. استخدم تيليجرام للتفاعل المباشر وديسكورد لسير العمل المتوازية — وأمّن كليهما دائماً بقوائم السماح وإدارة الرموز السليمة.

التالي: توسيع قدرات وكيلك بتكامل الذاكرة والصوت والبريد الإلكتروني. :::

اختبار

اختبار الوحدة 2: إعداد بيئة الوكيل

خذ الاختبار
نشرة أسبوعية مجانية

ابقَ على مسار النيرد

بريد واحد أسبوعياً — دورات، مقالات معمّقة، أدوات، وتجارب ذكاء اصطناعي.

بدون إزعاج. إلغاء الاشتراك في أي وقت.