clawdbot/docs/cli/directory.md

summary, read_when

summary	read_when
CLI reference for `clawdbot directory` (self, peers, groups)	You want to look up contacts/groups/self ids for a channel You are developing a channel directory adapter

clawdbot directory

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

Common flags

• --channel <name>: channel id/alias (auto when exactly one channel is configured)
• --account <id>: account id (default: channel default)
• --json: output JSON

Notes

• For many channels, directory lists IDs from your configuration (allowlists / configured groups), not a live provider directory.

Self (“me”)

clawdbot directory self --channel zalouser

Peers (contacts/users)

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

Groups

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