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- إدارة الجلسات النشطة