directory

openclaw directory

对支持目录功能的渠道进行查找（联系人/对等方、群组和”我”）。

通用参数

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

说明

• directory 用于帮助你查找可粘贴到其他命令中的 ID（特别是 openclaw message send --target ...）。
• 对于许多渠道，结果来源于配置（允许列表/已配置的群组），而非实时的提供商目录。
• 默认输出为以制表符分隔的 id（有时包含 name）；脚本中请使用 --json。

将结果用于 message send

“`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
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` 或数字聊天 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`）

## Self（"我"）

```bash  theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw directory self --channel zalouser

Peers（联系人/用户）

“`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
openclaw directory peers list –channel zalouser
openclaw directory peers list –channel zalouser –query “name”
openclaw directory peers list –channel zalouser –limit 50

## 群组

```bash  theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw directory groups list --channel zalouser
openclaw directory groups list --channel zalouser --query "work"
openclaw directory groups members --channel zalouser --group-id <id>