الاقتران
«الاقتران» هو خطوة موافقة المالك الصريحة في OpenClaw. ويُستخدم في موضعين:- اقتران الرسائل المباشرة (DM) (من المسموح له التحدث إلى البوت)
- اقتران العُقد (الأجهزة/العُقد المسموح لها بالانضمام إلى شبكة Gateway)
1. اقتران الرسائل المباشرة (الوصول الوارد إلى الدردشة)
عندما تُهيَّأ قناة بسياسة DMpairing، يحصل المُرسِلون غير المعروفين على رمز قصير ولا تتم معالجة رسالتهم حتى تقوم بالموافقة.
سياسات DM الافتراضية موثّقة في: الأمان
رموز الاقتران:
- 8 أحرف، أحرف كبيرة، دون أحرف ملتبسة (
0O1I). - تنتهي صلاحيتها بعد ساعة واحدة. يرسل البوت رسالة الاقتران فقط عند إنشاء طلب جديد (تقريبًا مرة واحدة في الساعة لكل مُرسِل).
- تُحدَّد طلبات اقتران DM المعلّقة افتراضيًا بـ 3 لكل قناة؛ ويتم تجاهل الطلبات الإضافية حتى تنتهي صلاحية أحدها أو تتم الموافقة عليه.
الموافقة على مُرسِل
telegram، whatsapp، signal، imessage، discord، slack.
أين تُحفَظ الحالة
تُخزَّن تحت~/.openclaw/credentials/:
- الطلبات المعلّقة:
<channel>-pairing.json - مخزن قائمة السماح المعتمدة:
<channel>-allowFrom.json
2. اقتران أجهزة العُقد (iOS/Android/macOS/عُقد بدون واجهة)
تتصل العُقد بـ Gateway على أنها أجهزة باستخدامrole: node. ينشئ Gateway
طلب اقتران جهاز يجب الموافقة عليه.
الاقتران عبر Telegram (موصى به لنظام iOS)
إذا كنت تستخدم إضافةdevice-pair، يمكنك تنفيذ اقتران الجهاز لأول مرة بالكامل من خلال Telegram:
- في Telegram، أرسل رسالة إلى البوت الخاص بك:
/pair - يرد البوت برسالتين: رسالة تعليمات ورسالة منفصلة تحتوي على رمز الإعداد (سهل النسخ/اللصق في Telegram).
- على هاتفك، افتح تطبيق OpenClaw على iOS → الإعدادات → Gateway.
- الصق رمز الإعداد واتصل.
- العودة إلى Telegram:
/pair approve
url: عنوان WebSocket الخاص بالبوابة (ws://...أوwss://...)token: رمز اقتران قصير العمر
الموافقة على جهاز عُقدة
تخزين حالة اقتران العُقد
تُخزَّن تحت~/.openclaw/devices/:
pending.json(قصيرة الأجل؛ تنتهي صلاحية الطلبات المعلّقة)paired.json(الأجهزة المقترنة + الرموز)
ملاحظات
- واجهة
node.pair.*القديمة (CLI:openclaw nodes pending/approve) هي مخزن اقتران منفصل مملوك للبوابة. ما زالت عُقد WS تتطلب اقتران الأجهزة.