CLI commands
目錄
openclaw directory
查詢支援此功能之頻道的目錄:聯絡人/對等端、群組,以及「我」(自己)。
查詢結果可貼入其他命令中使用,尤其是 openclaw message send --target ...。
常用旗標
--channel <name>:頻道 ID/別名(設定多個頻道時為必填;僅設定一個頻道時會自動選取)--account <id>:帳戶 ID(預設值:頻道預設帳戶)--json:輸出 JSON
預設(非 JSON)輸出為 id(有時也包含 name),並以定位字元分隔。
注意事項
- 對許多頻道而言,查詢結果來自設定(允許清單/已設定的群組),而非服務提供者的即時目錄。
- 已安裝的頻道外掛可能不支援目錄功能。在此情況下,命令會回報不支援此操作;不會嘗試重新安裝或升級外掛以新增支援。
將結果搭配 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(外掛) |
來自 zca(me、friend list、group list)的討論串 ID(私訊/群組) |
自己(「我」)
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?