openclaw directory

为支持通讯录的频道提供目录查询功能（联系人/对等方、群组和"我"）。

通用标志

• --channel <name>：频道 ID/别名（配置了多个频道时必填；只有一个频道时自动选择）
• --account <id>：账号 ID（默认：频道默认账号）
• --json：输出 JSON

说明

• directory 的主要用途是帮你找到可粘贴到其他命令的 ID（尤其是 openclaw message send --target ...）。
• 许多频道的结果来自配置（允许列表/已配置的群组），而非实时 provider 目录。
• 默认输出为 id（有时附带 name），以 tab 分隔；脚本使用请加 --json。

配合 message send 使用

openclaw directory peers list --channel slack --query "U0"
openclaw message send --channel slack --target user:U012ABCDEF --message "hello"

各频道 ID 格式

• WhatsApp：+15551234567（私聊），1234567890-1234567890@g.us（群组）
• Telegram：@username 或数字 chat 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（插件）：来自 zca 的线程 ID（me、friend list、group list）

查询自己（"me"）

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>

小技巧：先用 directory 查出对方的 ID，再传给 message send——让你的龙虾精准发消息，不用猜 ID 格式。