CLI commands

Каталог

openclaw directory

Поиск в каталогах для каналов, которые его поддерживают: контакты/пользователи, группы и «я» (собственная учётная запись).

Результаты предназначены для вставки в другие команды, особенно в openclaw message send --target ....

Общие флаги

  • --channel <name>: идентификатор/псевдоним канала (обязателен, если настроено несколько каналов; выбирается автоматически, если настроен только один)
  • --account <id>: идентификатор учётной записи (по умолчанию: значение канала по умолчанию)
  • --json: вывод в формате JSON

По умолчанию вывод (не в формате JSON) содержит id (а иногда и name), разделённые символом табуляции.

Примечания

  • Для многих каналов результаты берутся из конфигурации (списки разрешённых сущностей / настроенные группы), а не из актуального каталога поставщика.
  • Уже установленный плагин канала может не поддерживать каталог. В этом случае команда сообщает о неподдерживаемой операции; она не пытается переустановить или обновить плагин для добавления поддержки.

Использование результатов с message send

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

Форматы идентификаторов по каналам

Канал Формат идентификатора получателя
WhatsApp +15551234567 (личная переписка), 1234567890-1234567890@g.us (группа), 120363123456789@newsletter (канал/рассылка, только исходящие сообщения)
Signal Настроенные псевдонимы преобразуются в получателей личных сообщений в формате E.164/UUID или групповых получателей group:<id>
Telegram @username или числовой идентификатор чата; для групп используются числовые идентификаторы
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 (плагин) Идентификатор пользователя (Bot API)
Zalo Personal / zalouser (плагин) Идентификатор ветки (личная переписка/группа) из zca (me, friend list, group list)

Собственная учётная запись («я»)

bash
openclaw directory self --channel zalouser

Пользователи (контакты/пользователи)

bash
openclaw directory peers list --channel zalouseropenclaw directory peers list --channel zalouser --query "name"openclaw directory peers list --channel zalouser --limit 50

Группы

bash
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?
On this page

On this page