الإقران
"الإقران" هو خطوة موافقة المالك الصريحة في OpenClaw. يتم استخدامه في مكانين:
- إقران الرسائل المباشرة (من المسموح له بالتحدث إلى البوت)
- إقران العقدة (أي الأجهزة/العقد مسموح لها بالانضمام إلى شبكة البوابة)
سياق الأمان: الأمان
1) إقران الرسائل المباشرة (وصول الدردشة الوارد)
عند تكوين قناة بسياسة رسائل مباشرة pairing، يحصل المرسلون غير المعروفين على رمز قصير ولا يتم معالجة رسالتهم حتى تقوم بالموافقة. سياسات الرسائل المباشرة الافتراضية موثقة في: الأمان رموز الإقران:
- 8 أحرف، كبيرة، بدون أحرف غامضة (
0O1I). - تنتهي صلاحيتها بعد ساعة واحدة. يرسل البوت رسالة الإقران فقط عند إنشاء طلب جديد (تقريبًا مرة واحدة في الساعة لكل مرسل).
- يتم تحديد طلبات إقران الرسائل المباشرة المعلقة عند 3 لكل قناة افتراضيًا؛ يتم تجاهل الطلبات الإضافية حتى تنتهي صلاحية أحدها أو تتم الموافقة عليه.
الموافقة على مرسل
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
القنوات المدعومة: telegram, whatsapp, signal, imessage, discord, slack, feishu.
مكان تخزين الحالة
يتم التخزين تحت ~/.openclaw/credentials/:
- الطلبات المعلقة:
<channel>-pairing.json - مخزن قائمة السماح المعتمدة:
- الحساب الافتراضي:
<channel>-allowFrom.json - الحساب غير الافتراضي:
<channel>-<accountId>-allowFrom.json
- الحساب الافتراضي:
سلوك تحديد نطاق الحساب:
- تقوم الحسابات غير الافتراضية بقراءة/كتابة ملف قائمة السماح الخاص بنطاقها فقط.
- يستخدم الحساب الافتراضي ملف قائمة السماح غير المحدد بنطاق القناة.
عامل هذه الملفات على أنها حساسة (فهي تتحكم في الوصول إلى مساعدك).
2) إقران جهاز العقدة (عقد iOS/Android/macOS/عديمة الرأس)
تتصل العقد بالبوابة كـ أجهزة مع role: node. تنشئ البوابة طلب إقران جهاز يجب الموافقة عليه.
الإقران عبر تليجرام (موصى به لـ iOS)
إذا كنت تستخدم إضافة device-pair، يمكنك إجراء إقران الجهاز لأول مرة بالكامل من تليجرام:
- في تليجرام، راسل بوتك:
/pair - يرد البوت برسالتين: رسالة تعليمات ورسالة منفصلة تحتوي على رمز الإعداد (سهل النسخ/اللصق في تليجرام).
- على هاتفك، افتح تطبيق OpenClaw لنظام iOS → الإعدادات → البوابة.
- الصق رمز الإعداد وقم بالاتصال.
- مرة أخرى في تليجرام:
/pair approve
رمز الإعداد هو حمولة JSON مشفرة بـ base64 تحتوي على:
url: عنوان URL لـ WebSocket الخاص بالبوابة (ws://...أوwss://...)token: رمز إقران قصير العمر
عامل رمز الإعداد مثل كلمة مرور طالما أنه ساري المفعول.
الموافقة على جهاز عقدة
openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>
تخزين حالة إقران العقدة
يتم التخزين تحت ~/.openclaw/devices/:
pending.json(قصير العمر؛ تنتهي صلاحية الطلبات المعلقة)paired.json(الأجهزة المقترنة + الرموز)
ملاحظات
- واجهة برمجة التطبيقات القديمة
node.pair.*(سطر الأوامر:openclaw nodes pending/approve) هي مخزن إقران منفصل تمتلكه البوابة. لا تزال عقد WS تتطلب إقران جهاز.