الإقران (Pairing)
"الإقران" هو خطوة الموافقة الصريحة من المالك في OpenClaw. يُستخدم في مكانين رئيسيين لتأمين الوصول.
نوعا الإقران
- 1. إقران الرسائل المباشرة: من يُسمح له بالتحدث مع البوت
- 2. إقران Node: ما الأجهزة/العقد المسموح لها بالانضمام إلى شبكة Gateway
1) إقران الرسائل المباشرة (الوصول الوارد للدردشة)
عندما يتم تكوين قناة بسياسة DM pairing، يحصل المرسلون غير المعروفين على رمز قصير ولا تتم معالجة رسالتهم حتى تقوم بالموافقة.
رموز الإقران
- صالحة لمدة ساعة واحدة
- رمز مكون من 6 أحرف (مثل
ABC123) - فريدة لكل مرسل + قناة
الموافقة على مرسل
openclaw pairing list telegram openclaw pairing approve telegram <CODE>
القنوات المدعومة: telegram, whatsapp, signal, imessage, discord, slack
أين يتم تخزين الحالة
مخزنة تحت ~/.openclaw/credentials/:
- الطلبات المعلقة:
<channel>-pairing.json - قائمة السماح المعتمدة:
<channel>-allowFrom.json
تحذير أمني
تعامل مع هذه الملفات على أنها حساسة (فهي تتحكم في الوصول إلى مساعدك).
2) إقران أجهزة Node (iOS/Android/macOS/العقد بدون واجهة)
تتصل العقد (Nodes) بـ Gateway كأجهزة بـ role: node. ينشئ Gateway طلب إقران جهاز يجب الموافقة عليه.
الموافقة على جهاز Node
openclaw devices list openclaw devices approve <requestId> openclaw devices reject <requestId>
تخزين حالة إقران Node
مخزنة تحت ~/.openclaw/devices/:
pending.json(قصير الأجل؛ تنتهي صلاحية الطلبات المعلقة)paired.json(الأجهزة المقترنة + الرموز)
ملاحظة
واجهة برمجة التطبيقات القديمة node.pair.* (CLI: openclaw nodes pending/approve) هي مخزن إقران منفصل مملوك لـ Gateway. لا تزال عقد WS تتطلب إقران الجهاز.