Skip to main content

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
Default (non-JSON) output is 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

Self (“me”)

Peers (contacts/users)

Groups