--channel <name>
告诉它你要查哪扇门里的目录，比如 Slack、Telegram、Discord。
Cli 导读
用 directory 命令找到任何人的 ID，然后直接发消息
`openclaw directory` 不是通讯录，而是帮你查出各平台用户/群组的 ID，这些 ID 是发给 `message send` 用的。不同渠道的 ID 格式完全不同（比如 Slack 要加 `user:` 前缀，WhatsApp 群组 ID 带 `@g.us`），查出来直接复制粘贴就行。
先讲这一页到底在解决什么
用 directory 命令找到任何人的 ID，然后直接发消息
`openclaw directory` 不是通讯录，而是帮你查出各平台用户/群组的 ID，这些 ID 是发给 `message send` 用的。不同渠道的 ID 格式完全不同（比如 Slack 要加 `user:` 前缀，WhatsApp 群组 ID 带 `@g.us`），查出来直接复制粘贴就行。
第一站
🧭 先认三个按钮：频道、账号、JSON
官方把这个命令的常用参数写得很少，因为它本来就很像查字典。你只要先知道查谁、查哪本字典、要不要机器能看懂的格式就够了。
--account <id>
同一扇门里可能有不同账号，就像同一栋楼里有不同房间。
--json
把答案装进一个整齐盒子里，方便别的程序接着拿去用。
一句话
channel 选门，account 选窗，json 选装盒子。
第二站
✍️ 这组命令像“先问路，再抄地址”
官方说它能帮你找 contacts、peers、groups、甚至 “me”。我们把它想成一本会动的通讯录。
openclaw directory self --channel zalouser像先照镜子，看“我自己在这扇门里叫什么名字”。
openclaw directory peers list --channel zalouser像翻联系人小本子，看看旁边都坐着哪些人。
openclaw directory groups list --channel zalouser像翻群组名册，找找有哪些大房间。
openclaw directory groups members --channel zalouser --group-id <id>像打开某个房间的门牌，看看里面坐着哪些小伙伴。
第三站
🪪 为什么它常常要配合 `message send`？因为它负责把昵称翻成真门牌
官方很直白：directory 是为了让你能把 ID 复制到别的命令里，尤其是消息发送那类命令。
先找，再贴
先查到 `user:U012ABCDEF` 这种真门牌，再贴进 `message send --target ...`。
人名不等于机器名
人会记 `#general`、`@jane`，机器更喜欢精确编号。
很多通道是“配置出来的目录”
不是所有目录都像活的电话簿，有些更像系统先登记好的名单。
一句话
directory 不是终点，它是给别的命令铺路。
第四站
🏷️ 不同通道的门牌长得不一样，所以它才要先给你一张翻译表
官方特地列了各个通道常见的 ID 形状。这个部分很像“不同学校的学生证格式不一样”。
WhatsApp
像电话号码，或者群的门牌号。
Telegram
像 `@username` 或数字 chat id，群还是数字门牌。
Slack / Discord
像 `user:...`、`channel:...` 这种精确标签。
Matrix / Teams / Zalo
每个通道都有自己的门牌形状。你要先认它的格式，门才找得到。
最后总结
🎈 把 openclaw directory 压成一句话
openclaw directory 就像一个小地图盒：把昵称、群名、房间名翻成真门牌，再把这些门牌交给 `message send` 之类的命令继续跑。
如果你下一页只想继续看一页，我建议看 /cli/security。那页是“体检和报警器”，和这里的“找门牌”刚好相邻。