​

openclaw directory

​

常用旗標

• --channel <name>：頻道 ID／別名（當設定了多個頻道時為必填；僅設定一個時會自動選取）
• --account <id>：帳戶 ID（預設：頻道預設值）
• --json：輸出 JSON

​

注意事項

• directory 旨在協助你找到可貼到其他指令中的 ID（特別是 openclaw message send --target ...）。
• 對於許多通道，結果是基於設定（允許清單 / 已設定的群組），而非即時的供應商目錄。
• 預設輸出為以定位字元分隔的 id（有時還包含 name）；進行腳本處理時請使用 --json。

​

使用結果搭配 message send

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

​

ID formats（依頻道）

• WhatsApp：+15551234567（DM）、[email protected]（群組）
• Telegram：@username 或數字型聊天 ID；群組為數字 ID
• Slack：user:U… 與 channel:C…
• Discord：user:<id> 與 channel:<id>
• Matrix（plugin）：user:@user:server、room:!roomId:server 或 #alias:server
• Microsoft Teams（plugin）：user:<id> 與 conversation:<id>
• Zalo（plugin）：使用者 ID（Bot API）
• Zalo Personal／zalouser（plugin）：來自 zca 的執行緒 ID（DM／群組）（me、friend list、group list）

​

Self（「me」）

openclaw directory self --channel zalouser

​

Peers（聯絡人／使用者）

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>