openclaw directory

Tra cứu danh bạ cho các channel hỗ trợ (contacts/peers, groups, và “me”).

Các flag thông dụng

  • --channel <name>: channel id/alias (bắt buộc khi config nhiều channel; tự động khi chỉ có một channel)
  • --account <id>: account id (mặc định: channel default)
  • --json: xuất ra định dạng JSON

Lưu ý

  • directory giúp các bạn tìm các ID để paste vào các lệnh khác (đặc biệt là openclaw message send --target ...).
  • Với nhiều channel, kết quả được lấy từ config (allowlist / configured groups) chứ không phải từ danh bạ trực tiếp của provider.
  • Output mặc định là id (và đôi khi có name) phân cách bằng tab; dùng --json cho scripting.

Sử dụng kết quả với message send

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

Định dạng ID (theo channel)

  • WhatsApp: +15551234567 (DM), [email protected] (group)
  • Telegram: @username hoặc numeric chat id; groups là numeric ids
  • Slack: user:U… và channel:C…
  • Discord: user:<id> và channel:<id>
  • Matrix (plugin): user:@user:server, room:!roomId:server, hoặc #alias:server
  • Microsoft Teams (plugin): user:<id> và conversation:<id>
  • Zalo (plugin): user id (Bot API)
  • Zalo Personal / zalouser (plugin): thread id (DM/group) từ zca (me, friend list, group list)

Self (“me”)

openclaw directory self --channel zalouser

Peers (contacts/users)

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

Groups

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