메인 콘텐츠로 건너뛰기

​
openclaw directory

directory lookup을 지원하는 channel에서 contacts/peers, groups, 그리고 “me” 정보를 조회합니다.

​
Common flags

  • --channel <name>: channel id/alias (여러 channel이 설정되어 있으면 필수, 하나만 있으면 자동 선택)
  • --account <id>: account id (기본값: channel default)
  • --json: JSON 출력

​
Notes

  • directory는 다른 명령, 특히 openclaw message send --target ...에 붙여 넣을 ID를 찾는 데 목적이 있습니다.
  • 많은 channel에서는 결과가 live provider directory가 아니라 config-backed 정보(allowlist/configured group)에서 나옵니다.
  • 기본 출력은 id와 경우에 따라 name을 tab으로 구분한 형태입니다. 스크립트에는 --json을 사용하세요.

​
Using results with message send

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

​
ID formats (by channel)

  • WhatsApp: +15551234567 (DM), 1234567890-1234567890@g.us (group)
  • Telegram: @username 또는 numeric chat id, group도 numeric id 사용
  • 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): user id (Bot API)
  • Zalo Personal / zalouser (plugin): zca의 thread id (DM/group), 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>