محتويات المقال
إعداد روبوت OpenClaw عبر تيليجرام يتيح لك التحكم الآمن في وكيل الذكاء الاصطناعي المحلي الخاص بك مباشرة من هاتفك الذكي، مما يلغي الحاجة إلى البقاء مقيداً بمحطة العمل المكتبية. من خلال ربط البوابة المحلية بروبوت مخصص، يمكنك إصدار الأوامر، وتشغيل الأدوات، ومراقبة العمليات الخلفية عن بُعد. يوفر هذا الدليل خطوات التكوين الدقيقة المطلوبة لإنشاء اتصال آمن وموثق بين مثيلك المحلي ومنصة المراسلة.
قبل تعديل أي ملفات تكوين، يجب التأكد من أن بيئتك المحلية جاهزة تماماً. يجب أن تكون البوابة قيد التشغيل وتستجيب لفحوصات النظام.
- تحقق من التثبيت عن طريق تشغيل أمر حالة البوابة. هذا يضمن أن الخدمة الأساسية نشطة وجاهزة لقبول اتصالات القنوات الخارجية.
- قم بتجهيز حساب نشط على تطبيق Telegram. سيتم استخدام هذا الحساب للتفاعل مع أداة BotFather وإنشاء رموز الوصول الفريدة الخاصة بك.
الخطوة 1: إنشاء الروبوت عبر أداة BotFather
لا يستخدم النظام حساب المراسلة الشخصي الخاص بك للتواصل؛ بل يتطلب كياناً مخصصاً للروبوت. يجب عليك إنشاء هذا الكيان باستخدام أدوات المطورين الرسمية.
- ابحث عن حساب @BotFather داخل تطبيق المراسلة وتحقق من وجود العلامة الزرقاء. هذا يضمن أنك تتفاعل مع أداة المطور الرسمية، مما يمنع سرقة الرموز.
- أرسل أمر
/newbotلبدء عملية الإنشاء. هذا يدفع النظام لطلب اسم العرض واسم المستخدم المطلوبين. - اختر اسم مستخدم ينتهي حصراً بكلمة 'bot' (على سبيل المثال، myopenclawbot). هذا متطلب صارم من المنصة لجميع الحسابات الآلية.
- انسخ الرمز الأبجدي الرقمي الذي تم إنشاؤه على الفور. تعمل هذه السلسلة ككلمة مرور رئيسية ولا يمكن استرجاعها لاحقاً دون إعادة إنشائها بالكامل.
الخطوة 2: تكوين بوابة نظام OpenClaw
بعد تأمين الرمز الخاص بك، يجب عليك الآن توجيه البوابة المحلية للاستماع إلى هذه القناة المحددة. يتطلب ذلك تعديل ملف التكوين الأساسي بصيغة YAML.
- افتح ملف التكوين الموجود في المسار
~/.openclaw/config.yamlباستخدام محرر النصوص المفضل لديك. يحدد هذا الملف جميع سلوكيات القناة والسياسات الأمنية للوكيل الخاص بك. - أدرج كتلة القناة التالية، مع استبدال العنصر النائب بالرمز الفعلي الخاص بك. هذا يُفعل التكامل وينشئ سياسة إقران آمنة بشكل افتراضي.
channels:
telegram:
enabled: true
botToken: 'PASTE_YOUR_TOKEN_HERE'
dmPolicy: 'pairing'
groups:
'*':
requireMention: trueبمجرد حفظ الملف، يجب عليك تطبيق التغييرات على الخدمة النشطة.
- أعد تشغيل الخدمة عن طريق تنفيذ أمر إعادة تشغيل البوابة. هذا يجبر النظام على قراءة ملف YAML الجديد وبدء اتصال الاستعلام الطويل.
openclaw gateway restartالخطوة 3: إقران حساب تطبيق Telegram الخاص بك
نظراً لأن السياسة الأمنية الافتراضية تحظر المستخدمين غير المعروفين، يجب عليك التصريح صراحة لحسابك الشخصي بالتفاعل مع الروبوت المنشأ حديثاً.
- أرسل أي رسالة أولية (مثل 'مرحباً') إلى الروبوت الخاص بك من هاتفك. هذا يدفع النظام لإنشاء وإرجاع رمز إقران أبجدي رقمي قصير.
- نفذ أوامر الإقران على جهازك المضيف باستخدام الرمز المستلم. هذا يضع معرف المستخدم الخاص بك في القائمة البيضاء بشكل دائم، مما يسمح بالمراسلة المباشرة غير المقيدة.
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>لاحظ أن رموز الإقران تنتهي صلاحيتها بصرامة بعد ساعة واحدة. إذا انتهت صلاحية الرمز الخاص بك، ما عليك سوى إرسال رسالة أخرى لإنشاء سلسلة جديدة.
تكوين الدردشة الجماعية والصلاحيات
يتطلب نشر الوكيل في دردشة جماعية مشتركة تعديل كل من إعدادات خصوصية المنصة وقواعد التكوين المحلية. بشكل افتراضي، تعمل الروبوتات في وضع الخصوصية، مما يعني أنها تعالج فقط الرسائل التي تشير إليها صراحة.
- عطل وضع الخصوصية عن طريق إرسال أمر
/setprivacyإلى أداة @BotFather. هذا يسمح للوكيل بقراءة جميع سياقات المجموعة، وهو أمر ضروري إذا كنت تريده أن يستجيب بشكل محيطي دون الإشارة إليه. - استخرج معرف الدردشة الجماعية الخاص بك عن طريق إعادة توجيه رسالة إلى أداة @userinfobot. هذا يوفر المعرف الرقمي السلبي الدقيق (مثل -1001234567890) المطلوب لملف YAML الخاص بك.
- قم بتحديث ملف التكوين الخاص بك لإدراج معرف المجموعة هذا صراحة في القائمة البيضاء. هذا يمنع المجموعات غير المصرح لها من اختطاف الموارد الحسابية للوكيل الخاص بك.
channels:
telegram:
groups:
'-1001234567890':
requireMention: false
groupPolicy: 'open'شرح السياسات الأمنية
يعد فهم معلمات التحكم في الوصول أمراً بالغ الأهمية لمنع التنفيذ غير المصرح به للأوامر على جهازك المضيف.
| الإعداد | الوظيفة | الاستخدام الموصى به |
|---|---|---|
dmPolicy: 'pairing' | يمكن للمستخدمين المعتمدين صراحة فقط إرسال رسائل مباشرة. | الوضع الافتراضي للإعدادات الشخصية. |
dmPolicy: 'allowlist' | يقيد الوصول إلى معرفات المستخدمين الرقمية المحددة مسبقاً. | البيئات عالية الأمان. |
dmPolicy: 'open' | يسمح لأي مستخدم على المنصة بالتفاعل مع الوكيل. | غير موصى به على الإطلاق. |
requireMention: false | يعالج الوكيل كل رسالة يتم إرسالها في المجموعة. | يستخدم فقط في المجموعات الخاصة والموثوقة. |
الرؤية التحليلية: الأمان المعماري وتجاوز مسار الشبكة
يعد القرار المعماري باستخدام تقنية الاستعلام الطويل (Long Polling) افتراضياً ميزة استراتيجية لعمليات النشر الذاتية لنظام OpenClaw. من خلال جعل البوابة المحلية تتصل بخوادم المراسلة بدلاً من طلب خطافات ويب (Webhooks) واردة، يمكن للمستخدمين تجاوز تعقيدات ترجمة عنوان الشبكة (NAT) بالكامل. هذا يعني أنك لست بحاجة إلى فتح منافذ جهاز التوجيه أو كشف عنوان IP عام، مما يقلل بشكل كبير من سطح الهجوم الخارجي لشبكتك المنزلية.
ومع ذلك، فإن سهولة الاتصال هذه تفرض اعتبارات أمنية داخلية بالغة الأهمية، خاصة فيما يتعلق بسياسات المراسلة المباشرة. إن ترك سياسة dmPolicy مفتوحة لوكيل مزود بصلاحيات الوصول إلى نظام الملفات أو قدرات تنفيذ الأوامر الطرفية يخلق ثغرة أمنية خطيرة. يمكن للغرباء نظرياً تشغيل الأدوات أو قراءة الملفات المحلية. لذلك، فإن الالتزام بوضع الإقران الافتراضي أو استخدام قائمة بيضاء صارمة يعد أمراً ضرورياً للغاية لأي عملية نشر شخصية.
في النهاية، يؤدي دمج قناة الاتصال هذه إلى تحويل مثيل الذكاء الاصطناعي المحلي الثابت إلى مساعد ديناميكي يمكن الوصول إليه عبر الهاتف المحمول. بالنسبة للمستخدمين المتقدمين، فإن التكوين الدقيق لسياسات المجموعة والصلاحيات الإدارية سيفتح قدرات توجيه متقدمة للوكلاء المتعددين، مما يسمح بالتعاون السلس دون المساس بسلامة النظام المضيف.