CLI commands

Diretório

openclaw directory

Consultas de diretório para canais compatíveis: contatos/pares, grupos e "eu" (o próprio usuário).

Os resultados devem ser colados em outros comandos, especialmente openclaw message send --target ....

Opções comuns

  • --channel <name>: id/alias do canal (obrigatório quando vários canais estão configurados; selecionado automaticamente quando apenas um está configurado)
  • --account <id>: id da conta (padrão: conta padrão do canal)
  • --json: gera a saída em JSON

A saída padrão (não JSON) é id (e, às vezes, name) separado por uma tabulação.

Observações

  • Para muitos canais, os resultados são baseados na configuração (listas de permissões/grupos configurados), e não em um diretório em tempo real do provedor.
  • Um plugin de canal já instalado pode não oferecer suporte a diretórios. Nesse caso, o comando informa que a operação não é compatível; ele não tenta reinstalar nem atualizar o plugin para adicionar esse suporte.

Como usar os resultados com message send

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

Formatos de ID por canal

Canal Formato do id de destino
WhatsApp +15551234567 (mensagem direta), 1234567890-1234567890@g.us (grupo), 120363123456789@newsletter (canal/boletim, somente saída)
Signal Aliases configurados são resolvidos para destinos de mensagem direta E.164/UUID ou destinos de grupo group:<id>
Telegram @username ou id numérico do chat; grupos usam ids numéricos
Slack user:U… e channel:C…
Discord user:<id> e channel:<id>
Matrix (plugin) user:@user:server, room:!roomId:server ou #alias:server
Microsoft Teams (plugin) user:<id> e conversation:<id>
Zalo (plugin) Id do usuário (API do bot)
Zalo Personal / zalouser (plugin) Id da conversa (mensagem direta/grupo), obtido de zca (me, friend list, group list)

O próprio usuário ("eu")

bash
openclaw directory self --channel zalouser

Pares (contatos/usuários)

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

Grupos

bash
openclaw directory groups list --channel zalouseropenclaw directory groups list --channel zalouser --query "work"openclaw directory groups members --channel zalouser --group-id <id>

Conteúdo relacionado

Was this useful?
On this page

On this page