openclaw directory¶

為支援此功能的頻道提供目錄查詢（聯絡人／peers、群組，以及「me」）。

常用旗標¶

• --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）、1234567890-1234567890@g.us（群組）
• 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>