CLI commands

الدليل

openclaw directory

عمليات البحث في الدليل للقنوات التي تدعم ذلك (جهات الاتصال/الأقران، والمجموعات، و"أنا").

العلامات الشائعة

  • --channel <name>: معرّف/اسم مستعار للقناة (مطلوب عند تكوين عدة قنوات؛ تلقائي عند تكوين قناة واحدة فقط)
  • --account <id>: معرّف الحساب (الافتراضي: افتراضي القناة)
  • --json: إخراج JSON

ملاحظات

  • يهدف directory إلى مساعدتك في العثور على المعرّفات التي يمكنك لصقها في أوامر أخرى (خصوصًا openclaw message send --target ...).
  • بالنسبة إلى كثير من القنوات، تكون النتائج مستندة إلى التكوين (قوائم السماح / المجموعات المكوّنة) بدلًا من دليل موفّر مباشر.
  • لا يزال بإمكان Plugins القنوات المثبتة إغفال دعم الدليل؛ في هذه الحالة يبلّغ الأمر عن عملية الدليل غير المدعومة بدلًا من إعادة تثبيت Plugin.
  • الإخراج الافتراضي هو id (وأحيانًا name) مفصولًا بعلامة تبويب؛ استخدم --json للبرمجة النصية.

استخدام النتائج مع message send

openclaw directory peers list --channel slack --query "U0"
openclaw message send --channel slack --target user:U012ABCDEF --message "hello"

صيغ المعرّفات (حسب القناة)

  • WhatsApp: +15551234567 (رسالة مباشرة)، [email protected] (مجموعة)، 120363123456789@newsletter (هدف صادر لقناة/نشرة إخبارية)
  • Telegram: @username أو معرّف دردشة رقمي؛ المجموعات هي معرّفات رقمية
  • Slack: user:U… وchannel:C…
  • Discord: user:<id> وchannel:<id>
  • Matrix (Plugin): user:@user:server أو room:!roomId:server أو #alias:server
  • Microsoft Teams (Plugin): user:<id> وconversation:<id>
  • Zalo (Plugin): معرّف المستخدم (Bot API)
  • Zalo Personal / zalouser (Plugin): معرّف سلسلة المحادثة (رسالة مباشرة/مجموعة) من zca (me، friend list، group list)

الذات ("أنا")

openclaw directory self --channel zalouser

الأقران (جهات الاتصال/المستخدمون)

openclaw directory peers list --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory peers list --channel zalouser --limit 50

المجموعات

openclaw directory groups list --channel zalouser
openclaw directory groups list --channel zalouser --query "work"
openclaw directory groups members --channel zalouser --group-id <id>

ذات صلة