目录
openclaw directory 的 CLI 参考（自身、对等方、群组）
对支持目录查询的渠道进行查找：联系人/对等方、群组以及“我”（自身）。
查询结果用于粘贴到其他命令中，尤其是 openclaw message send --target ...。
通用标志
--channel <name>：渠道 ID/别名（配置多个渠道时必填；仅配置一个渠道时自动选择）--account <id>：账户 ID（默认值：渠道默认账户）--json：以 JSON 格式输出
默认（非 JSON）输出为 id（有时还包括 name），以制表符分隔。
注意事项
- 对于许多渠道，结果来自配置（允许列表/已配置的群组），而不是实时提供商目录。
- WhatsApp 群组列表是实时获取的。Gateway 网关查询会复用其拥有的连接；仅当没有其他进程占用该账户时，独立命令才会打开已关联的会话，否则会报告实时群组不可用。
- 已安装的渠道插件可能不支持目录功能。在这种情况下，该命令会报告操作不受支持；它不会尝试重新安装或升级插件以添加支持。
将结果与 message send 配合使用
openclaw directory peers list --channel slack --query "U0"
openclaw message send --channel slack --target user:U012ABCDEF --message "hello"各渠道的 ID 格式
| 渠道 | 目标 ID 格式 |
|---|---|
+15551234567（私信）、[email protected]（群组）、120363123456789@newsletter（频道/资讯频道，仅限出站） | |
| Signal | 已配置的别名解析为 E.164/UUID 私信目标或 group:<id> 群组目标 |
| Telegram | @username 或数字聊天 ID；群组使用数字 ID |
| Slack | user:U… 和 channel:C… |
| Discord | user:<id> 和 channel:<id> |
| Matrix（插件） | user:@user:server、room:!roomId:server 或 #alias:server |
| Microsoft Teams（插件） | user:<id> 和 conversation:<id> |
| Zalo（插件） | 用户 ID（Bot API） |
Zalo Personal / zalouser（插件） | 线程 ID（私信/群组），来自 zca（me、friend list、group list） |
自身（“我”）
openclaw directory self --channel zalouser对等方（联系人/用户）
openclaw directory peers list --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory peers list --channel zalouser --limit 50群组
openclaw directory groups list --channel zalouser
openclaw directory groups list --channel zalouser --query "work"
openclaw directory groups members --channel zalouser --group-id <id>