Skip to content

openclaw directory

支持目录查找的频道的目录查询(联系人/对等方、群组和"我")。

常用标志

  • --channel <name>: 频道 ID/别名(配置多个频道时需要;仅配置一个时自动选择)
  • --account <id>: 账户 ID(默认:频道默认值)
  • --json: 输出 JSON

注意事项

  • directory 旨在帮助您找到可以粘贴到其他命令中的 ID(特别是 openclaw message send --target ...)。
  • 对于许多频道,结果是配置支持的(允许列表 / 配置的群组),而不是实时的提供商目录。
  • 默认输出是 id(有时是 name),用制表符分隔;使用 --json 进行脚本编写。

message send 一起使用结果

bash
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

自身("me")

bash
openclaw directory self --channel zalouser

对等方(联系人/用户)

bash
openclaw directory peers list --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory peers list --channel zalouser --limit 50

群组

bash
openclaw directory groups list --channel zalouser
openclaw directory groups list --channel zalouser --query "work"
openclaw directory groups members --channel zalouser --group-id <id>