​

openclaw directory

​

Common flags

• --channel <name>: channel id/alias (required when multiple channels are configured; auto-selected when only one is configured)
• --account <id>: account id (default: channel default)
• --json: output JSON

​

Notes

• For many channels, results are config-backed (allowlists / configured groups) rather than a live provider directory.
• WhatsApp group listing is live. Gateway lookups reuse its owned connection; a standalone command opens the linked session only when no other process owns that account and otherwise reports that live groups are unavailable.
• An already-installed channel plugin can lack directory support. In that case the command reports the unsupported operation; it does not try to reinstall or upgrade the plugin to add support.

​

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

​

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>

​

Related

• CLI reference