directory

这个命令就像一个“通讯录查找器”，帮你找到在聊天软件里可以联系的人和群组。找到的“地址”（我们叫它 ID）可以复制下来，用在发消息的命令里。

使用前要知道的几件事：

1. 这个“通讯录”里的信息，很多是来自你事先设置好的名单，而不是软件里全部的、实时的联系人列表。
2. 命令默认会把找到的 ID（有时还有名字）简单地列出来。如果你想用电脑程序自动处理这些结果，可以加上 --json 这个“魔法词”，它会把结果变成一种电脑更容易读懂的格式。
3. 这个命令主要是为了帮你找到 ID，方便你复制粘贴到其他命令里去用。

怎么用这个“查找器”呢？ 你需要告诉它你想在哪个聊天软件里找，这就要用到 --channel 这个“开关”，后面跟上软件的名字，比如 slack。如果你只设置了一个聊天软件，电脑有时能自己猜到，但为了保险，最好还是告诉它。

常见的“找人”命令有这些：

1. 找“我自己”的地址：有时候你需要知道自己在某个软件里的 ID。你可以用 openclaw directory self --channel zalouser 这样的命令，它会告诉你“你”是谁。
2. 找朋友们的地址：想列出所有朋友，可以用 openclaw directory peers list --channel zalouser。如果朋友太多，你可以用 --limit 50 这个“开关”告诉电脑“只给我看前 50 个”。还可以用 --query “名字” 来搜索特定名字的朋友。
3. 找群组的地址：想列出所有群组，可以用 openclaw directory groups list --channel zalouser。同样，也可以用 --query “关键词” 来搜索群组名字。想知道一个群组里有哪些成员，可以用 openclaw directory groups members --channel zalouser --group-id <群组的ID>。

找到地址后怎么用？ 找到的 ID 可以直接用在发消息的命令里。比如，你先用 openclaw directory peers list --channel slack --query “U0” 找到了一个 Slack 朋友的 ID 是 user:U012ABCDEF，然后你就可以用 openclaw message send --channel slack --target user:U012ABCDEF --message “hello” 给他发消息说“你好”啦！

要小心的事情： 不同的聊天软件，ID 的样子长得完全不一样！就像不同国家的地址写法不同。比如：

• WhatsApp 里，个人是手机号（像 +15551234567），群组是一串奇怪的字母数字。
• Slack 里，个人 ID 像 user:U…，频道 ID 像 channel:C…。
• 其他软件也各有各的格式。所以你用的时候，一定要先看看上面这个“ID格式表”，确认你找到的 ID 样子是对的，再复制去用。