الانتقال إلى المحتوى الرئيسي

التكوين

الإقران

"الإقران" هو خطوة موافقة المالك الصريحة في OpenClaw. يتم استخدامه في مكانين:

  1. إقران الرسائل المباشرة (من المسموح له بالتحدث إلى البوت)
  2. إقران العقدة (أي الأجهزة/العقد مسموح لها بالانضمام إلى شبكة البوابة)

سياق الأمان: الأمان

1) إقران الرسائل المباشرة (وصول الدردشة الوارد)​

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

  • 8 أحرف، كبيرة، بدون أحرف غامضة (0O1I).
  • تنتهي صلاحيتها بعد ساعة واحدة. يرسل البوت رسالة الإقران فقط عند إنشاء طلب جديد (تقريبًا مرة واحدة في الساعة لكل مرسل).
  • يتم تحديد طلبات إقران الرسائل المباشرة المعلقة عند 3 لكل قناة افتراضيًا؛ يتم تجاهل الطلبات الإضافية حتى تنتهي صلاحية أحدها أو تتم الموافقة عليه.

الموافقة على مرسل​

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

القنوات المدعومة: telegram, whatsapp, signal, imessage, discord, slack, feishu.

مكان تخزين الحالة​

يتم التخزين تحت ~/.openclaw/credentials/:

  • الطلبات المعلقة: -pairing.json
  • مخزن قائمة السماح المعتمدة:
    • الحساب الافتراضي: -allowFrom.json
    • الحساب غير الافتراضي: --allowFrom.json

سلوك تحديد نطاق الحساب:

  • تقوم الحسابات غير الافتراضية بقراءة/كتابة ملف قائمة السماح الخاص بنطاقها فقط.
  • يستخدم الحساب الافتراضي ملف قائمة السماح غير المحدد بنطاق القناة.

عامل هذه الملفات على أنها حساسة (فهي تتحكم في الوصول إلى مساعدك).

2) إقران جهاز العقدة (عقد iOS/Android/macOS/عديمة الرأس)​

تتصل العقد بالبوابة كـ أجهزة مع role: node. تنشئ البوابة طلب إقران جهاز يجب الموافقة عليه.

الإقران عبر تليجرام (موصى به لـ iOS)​

إذا كنت تستخدم إضافة device-pair، يمكنك إجراء إقران الجهاز لأول مرة بالكامل من تليجرام:

  1. في تليجرام، راسل بوتك: /pair
  2. يرد البوت برسالتين: رسالة تعليمات ورسالة منفصلة تحتوي على رمز الإعداد (سهل النسخ/اللصق في تليجرام).
  3. على هاتفك، افتح تطبيق OpenClaw لنظام iOS → الإعدادات → البوابة.
  4. الصق رمز الإعداد وقم بالاتصال.
  5. مرة أخرى في تليجرام: /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 تتطلب إقران جهاز.

وثائق ذات صلة​

Zalo PersonalGroup Messages