4.17 directory命令

openclaw directory 命令用于在支持的聊天渠道中查找目录信息（联系人/对等点、群组和"我"）。

概述

该命令用于在支持目录功能的渠道中进行查找，包括联系人、群组和当前用户信息。

常用标志

标志	说明
--channel	渠道 ID/别名（配置了多个渠道时必需；只有一个渠道时自动选择）
--account	账户 ID（默认：渠道默认账户）
--json	以 JSON 格式输出

使用说明

• directory 命令旨在帮助您找到可以粘贴到其他命令中的 ID（特别是 openclaw message send --target ...）
• 对于许多渠道，结果是基于配置的（白名单/配置的群组），而不是来自提供商的实时目录
• 默认输出是用制表符分隔的 id（有时还有 name）；使用 --json 进行脚本编程

与消息发送配合使用

# 查找 Slack 联系人
openclaw directory peers list --channel slack --query "U0"

# 向找到的用户发送消息
openclaw message send --channel slack --target user:U012ABCDEF --message "hello"

各渠道的 ID 格式

渠道	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
Teams	user:<id> 和 conversation:<id>
Zalo	用户 ID（Bot API）
Zalo Personal	线程 ID（私聊/群组）来自 zca

查询自己

# 查询当前用户信息
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>