English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

CLI commands

Mensagem

openclaw message

Comando único de saída para enviar mensagens e ações de canal (Discord/Google Chat/iMessage/Matrix/Mattermost (plugin)/Microsoft Teams/Signal/Slack/Telegram/WhatsApp).

Uso

Code
openclaw message <subcommand> [flags]

Seleção de canal:

  • --channel é obrigatório se mais de um canal estiver configurado.
  • Se exatamente um canal estiver configurado, ele se torna o padrão.
  • Valores: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (Mattermost requer plugin)
  • openclaw message resolve o canal selecionado para o plugin proprietário dele quando --channel ou um destino com prefixo de canal está presente; caso contrário, carrega plugins de canal configurados para inferir o canal padrão.

Formatos de destino (--target):

  • WhatsApp: E.164, JID de grupo ou JID de Canal/Newsletter do WhatsApp (...@newsletter)
  • Telegram: id de chat, @username ou destino de tópico de fórum (-1001234567890:topic:42, ou --thread-id 42)
  • Discord: channel:<id> ou user:<id> (ou menção <@id>; ids numéricos brutos são tratados como canais)
  • Google Chat: spaces/<spaceId> ou users/<userId>
  • Slack: channel:<id> ou user:<id> (id bruto de canal é aceito)
  • Mattermost (plugin): channel:<id>, user:<id> ou @username (ids sem prefixo são tratados como canais)
  • Signal: +E.164, group:<id>, signal:+E.164, signal:group:<id> ou username:<name>/u:<name>
  • iMessage: identificador, chat_id:<id>, chat_guid:<guid> ou chat_identifier:<id>
  • Matrix: @user:server, !room:server ou #alias:server
  • Microsoft Teams: id de conversa (19:...@thread.tacv2) ou conversation:<id> ou user:<aad-object-id>

Consulta por nome:

  • Para provedores compatíveis (Discord/Slack/etc), nomes de canal como Help ou #help são resolvidos pelo cache de diretório.
  • Em caso de ausência no cache, o OpenClaw tentará uma consulta ao diretório ao vivo quando o provedor oferecer suporte.

Flags comuns

  • --channel <name>
  • --account <id>
  • --target <dest> (canal ou usuário de destino para send/poll/read/etc)
  • --targets <name> (repetir; somente broadcast)
  • --json
  • --dry-run
  • --verbose

Comportamento de SecretRef

  • openclaw message resolve SecretRefs de canais compatíveis antes de executar a ação selecionada.
  • A resolução fica restrita ao destino da ação ativa quando possível:
    • com escopo de canal quando --channel está definido (ou inferido a partir de destinos com prefixo, como discord:...)
    • com escopo de conta quando --account está definido (globais do canal + superfícies da conta selecionada)
    • quando --account é omitido, o OpenClaw não força um escopo de SecretRef de conta default
  • SecretRefs não resolvidos em canais não relacionados não bloqueiam uma ação de mensagem direcionada.
  • Se o SecretRef do canal/conta selecionado não for resolvido, o comando falha fechado para essa ação.

Ações

Núcleo

  • send

    • Canais: WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (plugin)/Signal/iMessage/Matrix/Microsoft Teams
    • Obrigatório: --target, mais --message, --media ou --presentation
    • Opcional: --media, --presentation, --delivery, --pin, --reply-to, --thread-id, --gif-playback, --force-document, --silent
    • Payloads de apresentação compartilhados: --presentation envia blocos semânticos (text, context, divider, buttons, select) que o núcleo renderiza pelas capacidades declaradas do canal selecionado. Consulte Apresentação de mensagens.
    • Preferências genéricas de entrega: --delivery aceita dicas de entrega como { "pin": true }; --pin é um atalho para entrega fixada quando o canal oferece suporte.
    • Telegram + WhatsApp: --force-document (enviar imagens, GIFs e vídeos como documentos para evitar compressão do canal)
    • Somente Telegram: --thread-id (id do tópico do fórum)
    • Somente Slack: --thread-id (timestamp da thread; --reply-to usa o mesmo campo)
    • Telegram + Discord: --silent
    • Somente WhatsApp: --gif-playback; Canais/Newsletters do WhatsApp são endereçados com o JID nativo @newsletter.

  • poll

    • Canais: WhatsApp/Telegram/Discord/Matrix/Microsoft Teams
    • Obrigatório: --target, --poll-question, --poll-option (repetir)
    • Opcional: --poll-multi
    • Somente Discord: --poll-duration-hours, --silent, --message
    • Somente Telegram: --poll-duration-seconds (5-600), --silent, --poll-anonymous / --poll-public, --thread-id

  • react

    • Canais: Discord/Google Chat/Matrix/Nextcloud Talk/Signal/Slack/Telegram/WhatsApp
    • Obrigatório: --message-id, --target
    • Opcional: --emoji, --remove, --participant, --from-me, --target-author, --target-author-uuid
    • Observação: --remove requer --emoji (omita --emoji para limpar as próprias reações onde houver suporte; consulte /tools/reactions)
    • Somente WhatsApp: --participant, --from-me
    • Reações em grupo do Signal: --target-author ou --target-author-uuid obrigatório
    • Nextcloud Talk: somente adicionar reações; --remove é rejeitado com um erro claro (consulte /tools/reactions)

  • reactions

    • Canais: Discord/Google Chat/Slack/Matrix
    • Obrigatório: --message-id, --target
    • Opcional: --limit

  • read

    • Canais: Discord/Slack/Matrix
    • Obrigatório: --target
    • Opcional: --limit, --message-id, --before, --after
    • Somente Slack: --message-id lê um timestamp de mensagem específico do Slack; combine com --thread-id para ler uma resposta exata de thread.
    • Somente Discord: --around

  • edit

    • Canais: Discord/Slack/Matrix
    • Obrigatório: --message-id, --message, --target

  • delete

    • Canais: Discord/Slack/Telegram/Matrix
    • Obrigatório: --message-id, --target

  • pin / unpin

    • Canais: Discord/Slack/Matrix
    • Obrigatório: --message-id, --target

  • pins (listar)

    • Canais: Discord/Slack/Matrix
    • Obrigatório: --target

  • permissions

    • Canais: Discord/Matrix
    • Obrigatório: --target
    • Somente Matrix: disponível quando a criptografia do Matrix está habilitada e as ações de verificação são permitidas

  • search

    • Canais: Discord
    • Obrigatório: --guild-id, --query
    • Opcional: --channel-id, --channel-ids (repetir), --author-id, --author-ids (repetir), --limit

Threads

  • thread create

    • Canais: Discord
    • Obrigatório: --thread-name, --target (id do canal)
    • Opcional: --message-id, --message, --auto-archive-min

  • thread list

    • Canais: Discord
    • Obrigatório: --guild-id
    • Opcional: --channel-id, --include-archived, --before, --limit

  • thread reply

    • Canais: Discord
    • Obrigatório: --target (id da thread), --message
    • Opcional: --media, --reply-to

Emojis

  • emoji list

    • Discord: --guild-id
    • Slack: nenhuma flag extra

  • emoji upload

    • Canais: Discord
    • Obrigatório: --guild-id, --emoji-name, --media
    • Opcional: --role-ids (repetir)

Stickers

  • sticker send

    • Canais: Discord
    • Obrigatório: --target, --sticker-id (repetir)
    • Opcional: --message

  • sticker upload

    • Canais: Discord
    • Obrigatório: --guild-id, --sticker-name, --sticker-desc, --sticker-tags, --media

Funções / Canais / Membros / Voz

  • role info (Discord): --guild-id
  • role add / role remove (Discord): --guild-id, --user-id, --role-id
  • channel info (Discord): --target
  • channel list (Discord): --guild-id
  • member info (Discord/Slack): --user-id (+ --guild-id para Discord)
  • voice status (Discord): --guild-id, --user-id

Eventos

  • event list (Discord): --guild-id
  • event create (Discord): --guild-id, --event-name, --start-time
    • Opcional: --end-time, --desc, --channel-id, --location, --event-type

Moderação (Discord)

  • timeout: --guild-id, --user-id (--duration-min ou --until opcional; omita ambos para limpar o timeout)
  • kick: --guild-id, --user-id (+ --reason)
  • ban: --guild-id, --user-id (+ --delete-days, --reason)
    • timeout também aceita --reason

Transmissão

  • broadcast
    • Canais: qualquer canal configurado; use --channel all para direcionar a todos os provedores
    • Obrigatório: --targets <target...>
    • Opcional: --message, --media, --dry-run

Exemplos

Enviar uma resposta no Discord:

Code
openclaw message send --channel discord \  --target channel:123 --message "hi" --reply-to 456

Enviar uma mensagem com botões semânticos:

Code
openclaw message send --channel discord \  --target channel:123 --message "Choose:" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Approve","value":"approve","style":"success"},{"label":"Decline","value":"decline","style":"danger"}]}]}'

O core renderiza a mesma carga útil de presentation em componentes do Discord, blocos do Slack, botões inline do Telegram, props do Mattermost ou cards do Teams/Feishu dependendo da capacidade do canal. Consulte Apresentação de mensagens para ver o contrato completo e as regras de fallback.

Enviar uma carga útil de apresentação mais rica:

bash
openclaw message send --channel googlechat --target spaces/AAA... \  --message "Choose:" \  --presentation '{"title":"Deploy approval","tone":"warning","blocks":[{"type":"text","text":"Choose a path"},{"type":"buttons","buttons":[{"label":"Approve","value":"approve"},{"label":"Decline","value":"decline"}]}]}'

Criar uma enquete no Discord:

Code
openclaw message poll --channel discord \  --target channel:123 \  --poll-question "Snack?" \  --poll-option Pizza --poll-option Sushi \  --poll-multi --poll-duration-hours 48

Criar uma enquete no Telegram (fechamento automático em 2 minutos):

Code
openclaw message poll --channel telegram \  --target @mychat \  --poll-question "Lunch?" \  --poll-option Pizza --poll-option Sushi \  --poll-duration-seconds 120 --silent

Enviar uma mensagem proativa no Teams:

Code
openclaw message send --channel msteams \  --target conversation:19:abc@thread.tacv2 --message "hi"

Criar uma enquete no Teams:

Code
openclaw message poll --channel msteams \  --target conversation:19:abc@thread.tacv2 \  --poll-question "Lunch?" \  --poll-option Pizza --poll-option Sushi

Reagir no Slack:

Code
openclaw message react --channel slack \  --target C123 --message-id 456 --emoji "✅"

Reagir em um grupo do Signal:

Code
openclaw message react --channel signal \  --target signal:group:abc123 --message-id 1737630212345 \  --emoji "✅" --target-author-uuid 123e4567-e89b-12d3-a456-426614174000

Enviar botões inline do Telegram por meio de apresentação genérica:

Code
openclaw message send --channel telegram --target @mychat --message "Choose:" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Yes","value":"cmd:yes"},{"label":"No","value":"cmd:no"}]}]}'

Enviar um botão de Mini App do Telegram por meio de apresentação genérica:

Code
openclaw message send --channel telegram --target 123456789 --message "Open app:" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Launch","webApp":{"url":"https://example.com/app"}}]}]}'

Botões de app web do Telegram são compatíveis apenas em chats privados entre um usuário e o bot. Cargas úteis JSON antigas usando web_app ainda são analisadas, mas webApp é o campo canônico de apresentação.

Enviar um card do Teams por meio de apresentação genérica:

bash
openclaw message send --channel msteams \  --target conversation:19:abc@thread.tacv2 \  --presentation '{"title":"Status update","blocks":[{"type":"text","text":"Build completed"}]}'

Enviar uma imagem do Telegram ou WhatsApp como documento para evitar compressão:

bash
openclaw message send --channel telegram --target @mychat \  --media ./diagram.png --force-document

Relacionados

Was this useful?
On this page

On this page