openclaw directory
Directory lookups for channels that support them: contacts/peers, groups, and “me” (self).
Results are meant to be pasted into other commands, especially openclaw message send --target ....
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
id (and sometimes name) separated by a tab.
Notes
- For many channels, results are config-backed (allowlists / configured groups) rather than a live provider directory.
- 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
ID formats by channel
| Channel | Target id format |
|---|---|
+15551234567 (DM), 1234567890-1234567890@g.us (group), 120363123456789@newsletter (Channel/Newsletter, outbound only) | |
| Signal | Configured aliases resolve to E.164/UUID DM targets or group:<id> group targets |
| Telegram | @username or numeric chat id; groups use numeric ids |
| Slack | user:U… and channel:C… |
| Discord | user:<id> and channel:<id> |
| Matrix (plugin) | user:@user:server, room:!roomId:server, or #alias:server |
| Microsoft Teams (plugin) | user:<id> and conversation:<id> |
| Zalo (plugin) | User id (Bot API) |
Zalo Personal / zalouser (plugin) | Thread id (DM/group), from zca (me, friend list, group list) |