openclaw pairing

إدارة طلبات الإقران من الأجهزة والمستخدمين الجدد.

الاستخدام الأساسي

openclaw pairing [command] [options]

الأوامر

عرض طلبات الإقران

# عرض جميع الطلبات المعلقة
openclaw pairing list

# لقناة محددة
openclaw pairing list telegram
openclaw pairing list discord

# تضمين الطلبات المكتملة
openclaw pairing list --all

# بتنسيق JSON
openclaw pairing list --json

الموافقة على طلب

# الموافقة باستخدام معرف الطلب
openclaw pairing approve telegram ABC123

# الموافقة مع اسم مخصص
openclaw pairing approve telegram ABC123 --name "iPhone de Julie"

# الموافقة التلقائية على جميع الطلبات (خطير!)
openclaw pairing approve --all

رفض طلب

# رفض طلب محدد
openclaw pairing reject telegram ABC123

# رفض مع سبب
openclaw pairing reject telegram ABC123 --reason "Unknown device"

# رفض جميع الطلبات المعلقة
openclaw pairing reject --all

إلغاء إقران

# إلغاء إقران جهاز
openclaw pairing unpair telegram user123

# حذف جميع الإقرانات لقناة
openclaw pairing unpair telegram --all

# إلغاء مع تأكيد
openclaw pairing unpair telegram user123 --confirm

الخيارات

الخيارالوصف
--allجميع الطلبات/الإقرانات
--jsonإخراج بتنسيق JSON
--name <name>اسم مخصص للجهاز
--reason <text>سبب الرفض
--confirmتأكيد بدون سؤال
--watchمراقبة الطلبات الجديدة في الوقت الفعلي
--auto-approveالموافقة التلقائية على الطلبات الجديدة

كيف يعمل الإقران؟

1️⃣

المستخدم يرسل طلب

المستخدم يرسل /start على Telegram أو يستخدم تطبيق Node

2️⃣

Gateway ينشئ طلب إقران

يتم إنشاء معرف فريد للطلب ويظهر في قائمة الطلبات المعلقة

3️⃣

المسؤول يراجع الطلب

تشغيل openclaw pairing list لعرض التفاصيل

4️⃣

الموافقة أو الرفض

تشغيل approve أو reject

5️⃣

الجهاز يصبح نشطاً

بعد الموافقة، يمكن للمستخدم التفاعل مع الوكيل

أمثلة متقدمة

مراقبة الطلبات الجديدة

# مراقبة مستمرة للطلبات الجديدة
openclaw pairing list --watch

# سيظهر في الوقت الفعلي:
# New pairing request from Telegram:
#   ID: XYZ789
#   User: @newuser
#   Device: iPhone 14 Pro

الموافقة التلقائية (لبيئات التطوير)

# تفعيل الموافقة التلقائية
openclaw config set pairing.auto_approve true

# أو من سطر الأوامر
openclaw pairing watch --auto-approve

# ⚠️ استخدم هذا فقط في بيئات آمنة!

تصفية الطلبات

# عرض الطلبات المعلقة فقط
openclaw pairing list --pending

# عرض الطلبات المكتملة
openclaw pairing list --approved
openclaw pairing list --rejected

# البحث عن مستخدم محدد
openclaw pairing list --json | jq '.[] | select(.user == "@username")'

إدارة الإقرانات بالجملة

# الموافقة على جميع الطلبات من قناة
openclaw pairing list telegram --pending --json | \
  jq -r '.[].id' | \
  xargs -I {} openclaw pairing approve telegram {}

# رفض الطلبات القديمة (أكثر من 7 أيام)
openclaw pairing list --pending --json | \
  jq '.[] | select(.created < (now - 604800))' | \
  jq -r '.id' | \
  xargs -I {} openclaw pairing reject telegram {} --reason "Expired"

💡 نصائح الأمان

  • راجع دائماً معرف المستخدم قبل الموافقة
  • استخدم أسماء وصفية للأجهزة (مثل "iPhone de Julie")
  • لا تفعّل auto-approve في الإنتاج
  • قم بمراجعة الإقرانات النشطة بانتظام

حالات الإقران

pending-في انتظار الموافقة
approved-تمت الموافقة، نشط
rejected-تم الرفض
🔗
unpaired-تم إلغاء الإقران
expired-انتهت صلاحية الطلب

معلومات الطلب

كل طلب إقران يحتوي على:

الحقلالوصف
idمعرف فريد للطلب
channelالقناة (telegram, discord, etc.)
userمعرف المستخدم أو username
deviceمعلومات الجهاز
createdوقت إنشاء الطلب
statusالحالة الحالية

استكشاف الأخطاء

لا توجد طلبات معلقة

# التحقق من حالة القنوات
openclaw channels status

# التحقق من السجلات
openclaw logs --source pairing

# محاولة إنشاء طلب يدوياً
# (من جهاز المستخدم: /start في Telegram)

فشلت الموافقة

# التحقق من معرف الطلب
openclaw pairing list --verbose

# محاولة الموافقة مع verbose
openclaw pairing approve telegram ABC123 --verbose

# التحقق من السجلات للأخطاء
openclaw logs --level error --source pairing

الجهاز لا يتلقى الرد

# التحقق من اتصال القناة
openclaw channels status telegram --probe

# إعادة تشغيل Gateway
openclaw gateway restart

# محاولة إرسال رسالة اختبار
openclaw message send --channel telegram --target @user "Test"

⚠️ تحذير أمني

الموافقة على طلب إقران تمنح المستخدم الوصول الكامل للوكيل. تأكد من:

  • التحقق من هوية المستخدم
  • مراجعة معرف الجهاز
  • التأكد من أن الطلب متوقع
  • عدم استخدام --auto-approve في الإنتاج

الأوامر ذات الصلة

  • openclaw channels - إدارة القنوات
  • openclaw nodes - عرض الأجهزة المقترنة
  • openclaw sessions - إدارة الجلسات النشطة