CLI commands
目錄
openclaw directory
查詢支援目錄功能之頻道的目錄：聯絡人／對等端、群組，以及「我」（自己）。
查詢結果可貼到其他命令中使用，尤其是 openclaw message send --target ...。
通用旗標
--channel <name>：頻道 ID／別名（設定多個頻道時為必填；僅設定一個頻道時會自動選取）--account <id>：帳號 ID（預設：頻道預設值）--json：輸出 JSON
預設（非 JSON）輸出為 id（有時也包含 name），以定位字元分隔。
注意事項
- 對許多頻道而言，結果來自設定（允許清單／已設定的群組），而非即時的供應商目錄。
- WhatsApp 群組清單為即時資料。閘道查詢會重複使用其擁有的連線；獨立命令僅會在沒有其他程序擁有該帳號時開啟已連結的工作階段，否則會回報即時群組無法使用。
- 已安裝的頻道外掛可能不支援目錄功能。在此情況下，命令會回報不支援的操作；不會嘗試重新安裝或升級外掛以新增支援。
搭配 message send 使用結果
openclaw directory peers list --channel slack --query "U0"openclaw message send --channel slack --target user:U012ABCDEF --message "hello"各頻道的 ID 格式
| 頻道 | 目標 ID 格式 |
|---|---|
+15551234567（私訊）、1234567890-1234567890@g.us（群組）、120363123456789@newsletter（頻道／電子報，僅限傳出） |
|
| Signal | 已設定的別名會解析為 E.164／UUID 私訊目標或 group:<id> 群組目標 |
| 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（外掛） |
執行緒 ID（私訊／群組），來自 zca（me、friend list、group list） |
自己（「我」）
openclaw directory self --channel zalouser對等端（聯絡人／使用者）
openclaw directory peers list --channel zalouseropenclaw directory peers list --channel zalouser --query "name"openclaw directory peers list --channel zalouser --limit 50群組
openclaw directory groups list --channel zalouseropenclaw directory groups list --channel zalouser --query "work"openclaw directory groups members --channel zalouser --group-id <id>相關內容
Was this useful?
