CLI commands

디렉터리

openclaw directory

이를 지원하는 채널의 디렉터리 조회(연락처/피어, 그룹 및 "나").

공통 플래그

  • --channel <name>: 채널 id/별칭(여러 채널이 구성된 경우 필수, 하나만 구성된 경우 자동)
  • --account <id>: 계정 id(기본값: 채널 기본값)
  • --json: JSON 출력

참고

  • directory는 다른 명령(특히 openclaw message send --target ...)에 붙여넣을 수 있는 ID를 찾는 데 도움을 주기 위한 것입니다.
  • 많은 채널에서 결과는 라이브 제공자 디렉터리가 아니라 구성 기반(허용 목록 / 구성된 그룹)입니다.
  • 설치된 채널 Plugin은 디렉터리 지원을 생략할 수도 있습니다. 이 경우 명령은 Plugin을 다시 설치하는 대신 지원되지 않는 디렉터리 작업을 보고합니다.
  • 기본 출력은 탭으로 구분된 id(그리고 때로는 name)입니다. 스크립팅에는 --json을 사용하세요.

message send와 함께 결과 사용

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

ID 형식(채널별)

  • WhatsApp: +15551234567(DM), [email protected](그룹), 120363123456789@newsletter(Channel/Newsletter 아웃바운드 대상)
  • Telegram: @username 또는 숫자 채팅 id; 그룹은 숫자 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): 사용자 id(Bot API)
  • Zalo Personal / zalouser(Plugin): zca의 스레드 id(DM/그룹)(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>

관련 항목