Directory

text

Copy

openclaw directory

Directory lookups for channels that support it (contacts/peers, groups, and “me”).

Common flags

• text

  Copy

  --channel <name>
  : channel id/alias (required when multiple channels are configured; auto when only one is configured)
• text

  Copy

  --account <id>
  : account id (default: channel default)
• text

  Copy

  --json
  : output JSON

Notes

• text

  Copy

  directory
  is meant to help you find IDs you can paste into other commands (especially
  text

  Copy

  openclaw message send --target ...
  ).
• For many channels, results are config-backed (allowlists / configured groups) rather than a live provider directory.
• Default output is
  text

  Copy

  id
  (and sometimes
  text

  Copy

  name
  ) separated by a tab; use
  text

  Copy

  --json
  for scripting.

Using results with

text

Copy

message send

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

ID formats (by channel)

• WhatsApp:
  text

  Copy

  +15551234567
  (DM),
  text

  Copy

  1234567890-1234567890@g.us
  (group)
• Telegram:
  text

  Copy

  @username
  or numeric chat id; groups are numeric ids
• Slack:
  text

  Copy

  user:U…
  and
  text

  Copy

  channel:C…
• Discord:
  text

  Copy

  user:<id>
  and
  text

  Copy

  channel:<id>
• Matrix (plugin):
  text

  Copy

  user:@user:server
  ,
  text

  Copy

  room:!roomId:server
  , or
  text

  Copy

  #alias:server
• Microsoft Teams (plugin):
  text

  Copy

  user:<id>
  and
  text

  Copy

  conversation:<id>
• Zalo (plugin): user id (Bot API)
• Zalo Personal /
  text

  Copy

  zalouser
  (plugin): thread id (DM/group) from
  text

  Copy

  zca
  (
  text

  Copy

  me
  ,
  text

  Copy

  friend list
  ,
  text

  Copy

  group list
  )

Self ("me")

bash
Copy
openclaw directory self --channel zalouser

Peers (contacts/users)

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

Groups

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

Related

• CLI reference