`openclaw message`

Comando de salida único para enviar mensajes y acciones de canal en Discord, Google Chat, iMessage, Matrix, Mattermost (plugin), Microsoft Teams, Signal, Slack, Telegram y WhatsApp.

openclaw message <subcommand> [flags]

Selección de canal

--channel <name> es obligatorio si hay más de un canal configurado; si hay exactamente un canal configurado, ese canal es el predeterminado.
Valores: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (Mattermost requiere el plugin).
Los destinos con prefijo de canal (por ejemplo, discord:channel:123) permiten resolver el plugin propietario sin especificar --channel de forma explícita.

Formatos de destino (`-t, --target`)

Canal	Formato
Discord	`channel:<id>`, `user:<id>`, mención `<@id>` o un id numérico sin prefijo (se trata como id de canal)
Google Chat	`spaces/<spaceId>` o `users/<userId>`
iMessage	identificador, `chat_id:<id>`, `chat_guid:<guid>` o `chat_identifier:<id>`
Mattermost (plugin)	`channel:<id>`, `user:<id>`, `@username` o un id sin prefijo (se trata como un canal)
Matrix	`@user:server`, `!room:server` o `#alias:server`
Microsoft Teams	`conversation:<id>` (`19:...@thread.tacv2`), un id de conversación sin prefijo o `user:<aad-object-id>`
Signal	`+E.164`, `group:<id>`, `uuid:<id>`, `username:<name>`/`u:<name>` o cualquiera de estos con el prefijo `signal:`
Slack	`channel:<id>` o `user:<id>` (un id sin prefijo se trata como un canal)
Telegram	id de chat, `@username` o un destino de tema de foro: `<chatId>:topic:<topicId>` (o `--thread-id <topicId>`)
WhatsApp	E.164, JID de grupo (`...@g.us`) o JID de canal/boletín (`...@newsletter`)

Búsqueda por nombre de canal: para proveedores con un directorio (Discord/Slack/etc.), los nombres como Help o #help se resuelven mediante la caché del directorio y, si no se encuentran en ella, se recurre a una búsqueda en tiempo real en el directorio cuando el proveedor lo admite.

Indicadores comunes

Todas las acciones aceptan: --channel <name>, --account <id>, --json, --dry-run, --verbose. Las acciones que requieren un destino también aceptan -t, --target <dest>.

Resolución de SecretRef

openclaw message resuelve los SecretRef del canal antes de ejecutar la acción, con el alcance más limitado posible:

alcance de canal cuando se establece --channel (o se deduce de un destino con prefijo)
alcance de cuenta cuando también se establece --account
todos los canales configurados cuando no se establece ninguno

Los SecretRef sin resolver de canales no relacionados nunca bloquean una acción dirigida; un SecretRef sin resolver del canal o la cuenta seleccionados hace que la acción falle de forma cerrada.

Acciones

Principales

Acción	Canales	Obligatorio	Notas
`send`	Discord, Google Chat, iMessage, Matrix, Mattermost (plugin), Microsoft Teams, Signal, Slack, Telegram, WhatsApp	`--target`, además de uno de `--message`/`--media`/`--presentation`	Véase Enviar a continuación.
`poll`	Discord, Matrix, Microsoft Teams, Telegram, WhatsApp	`--target`, `--poll-question`, `--poll-option` (repetible)	Véase Encuesta a continuación.
`react`	Discord, Matrix, Nextcloud Talk, Signal, Slack, Telegram, WhatsApp	`--message-id`, `--target`	`--emoji`, `--remove` (requiere `--emoji`; omítalo para borrar las reacciones propias cuando sea compatible; véase Reacciones). WhatsApp: `--participant`, `--from-me`. Las reacciones de grupo de Signal requieren `--target-author` o `--target-author-uuid`. Nextcloud Talk solo añade reacciones; `--remove` genera un error.
`reactions`	Discord, Matrix, Microsoft Teams, Slack	`--message-id`, `--target`	`--limit`.
`read`	Discord, Matrix, Microsoft Teams, Slack	`--target`	`--limit`, `--message-id`, `--before`, `--after`. Discord: `--around`, `--include-thread`. Slack: `--message-id` lee una marca de tiempo específica; combínelo con `--thread-id` para obtener una respuesta exacta del hilo.
`edit`	Discord, Matrix, Microsoft Teams, Slack, Telegram	`--message-id`, `--message`, `--target`	Los hilos de foros de Telegram usan `--thread-id`.
`delete`	Discord, Matrix, Microsoft Teams, Slack, Telegram	`--message-id`, `--target`
`pin` / `unpin`	Discord, Matrix, Microsoft Teams, Slack	`--message-id`, `--target`	`unpin` también acepta `--pinned-message-id` (Microsoft Teams: el id del recurso para fijar/listar elementos fijados, no el id del mensaje de chat).
`pins` (lista)	Discord, Matrix, Microsoft Teams, Slack	`--target`	`--limit`.
`permissions`	Discord, Matrix	`--target`	Matrix: disponible solo cuando el cifrado está habilitado y se permiten acciones de verificación.
`search`	Discord	`--guild-id`, `--query`	`--channel-id`, `--channel-ids` (repetible), `--author-id`, `--author-ids` (repetible), `--limit`.
`member info`	Discord, Matrix, Microsoft Teams, Slack	`--user-id`	`--guild-id` (Discord).

Enviar

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

--media <path-or-url>: adjunta una imagen, un audio, un vídeo o un documento (ruta local o URL).
--presentation <json>: carga útil compartida con bloques text, context, divider, chart, table, buttons y select, representados según la capacidad de cada canal. Véase Presentación de mensajes.
--delivery <json>: preferencias genéricas de entrega, por ejemplo, {"pin": true}. --pin es una forma abreviada de solicitar una entrega fijada cuando el canal la admite.
--reply-to <id>, --thread-id <id> (tema de foro de Telegram; marca de tiempo del hilo de Slack, el mismo campo que --reply-to).
--force-document (Telegram, WhatsApp): envía imágenes, GIF y vídeos como documentos para evitar la compresión del canal.
--silent (Telegram, Discord): envía sin notificación.
--gif-playback (solo WhatsApp): trata el contenido de vídeo como reproducción GIF.

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

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

Slack representa de forma nativa los bloques de gráficos compatibles; los demás canales reciben los mismos datos como texto legible:

openclaw message send --channel slack --target channel:C123 \
  --presentation '{"blocks":[{"type":"chart","chartType":"bar","title":"Ingresos trimestrales","categories":["T1","T2"],"series":[{"name":"Ingresos","values":[120,145]}],"xLabel":"Trimestre"}]}'

Slack también representa de forma nativa los bloques de tablas explícitos. Los demás canales reciben el título y cada fila como texto determinista:

openclaw message send --channel slack --target channel:C123 \
  --presentation '{"title":"Informe del pipeline","blocks":[{"type":"table","caption":"Pipeline abierto","headers":["Cuenta","Etapa","ARR"],"rows":[["Acme","Won",125000],["Globex","Review",82000]],"rowHeaderColumnIndex":0}]}'

Los botones de Mini Apps de Telegram usan webApp (web_app aún se analiza para JSON heredado) y solo se representan en chats privados entre un usuario y el bot:

openclaw message send --channel telegram --target 123456789 --message "Abrir aplicación:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Iniciar","webApp":{"url":"https://example.com/app"}}]}]}'

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

openclaw message send --channel msteams \
  --target conversation:19:abc@thread.tacv2 \
  --presentation '{"title":"Actualización de estado","blocks":[{"type":"text","text":"Compilación completada"}]}'

Encuesta

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

--poll-option <choice>: repetir entre 2 y 12 veces.
--poll-multi: permitir varias selecciones.
Discord: --poll-duration-hours, --silent, --message.
Telegram: --poll-duration-seconds <n> (5-600), --silent, --poll-anonymous / --poll-public, --thread-id.

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

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

Hilos

thread create: canales Discord. Obligatorios: --thread-name, --target (id del canal). Opcionales: --message-id, --message, --auto-archive-min.
thread list: canales Discord. Obligatorio: --guild-id. Opcionales: --channel-id, --include-archived, --before, --limit.
thread reply: canales Discord. Obligatorios: --target (id del hilo), --message. Opcionales: --media, --reply-to.

Emojis

emoji list: Discord (--guild-id), Slack (sin indicadores adicionales).
emoji upload: Discord. Obligatorios: --guild-id, --emoji-name, --media. Opcional: --role-ids (repetir).

Stickers

sticker send: Discord. Obligatorios: --target, --sticker-id (repetir). Opcional: --message.
sticker upload: Discord. Obligatorios: --guild-id, --sticker-name, --sticker-desc, --sticker-tags, --media.

Roles, canales, voz y eventos (Discord)

role info: --guild-id.
role add / role remove: --guild-id, --user-id, --role-id.
channel info: --target.
channel list: --guild-id.
voice status: --guild-id, --user-id.
event list: --guild-id.
event create: obligatorios --guild-id, --event-name, --start-time; opcionales --end-time, --desc, --channel-id, --location, --event-type, --image <url-or-path>.

Moderación (Discord)

timeout: --guild-id, --user-id; opcional --duration-min o --until (omitir ambos para eliminar el tiempo de espera), --reason.
kick: --guild-id, --user-id, --reason.
ban: --guild-id, --user-id, --delete-days, --reason.

Difusión

openclaw message broadcast --targets <target...> [--channel all] [--message <text>] [--media <url>] [--dry-run]

Envía una carga útil a varios destinos. --targets acepta una lista separada por espacios. Usar --channel all para dirigirse a todos los proveedores configurados.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Mensaje

`openclaw message`

Selección de canal

Formatos de destino (`-t, --target`)

Indicadores comunes

Resolución de SecretRef

Acciones

Principales

Enviar

Encuesta

Hilos

Emojis

Stickers

Roles, canales, voz y eventos (Discord)

Moderación (Discord)

Difusión

Contenido relacionado

​openclaw message

​Selección de canal

​Formatos de destino (-t, --target)

​Indicadores comunes

​Resolución de SecretRef

​Acciones

​Principales

​Enviar

​Encuesta

​Hilos

​Emojis

​Stickers

​Roles, canales, voz y eventos (Discord)

​Moderación (Discord)

​Difusión

​Contenido relacionado

`openclaw message`

Selección de canal

Formatos de destino (`-t, --target`)

Indicadores comunes

Resolución de SecretRef

Acciones

Principales

Enviar

Encuesta

Hilos

Emojis

Stickers

Roles, canales, voz y eventos (Discord)

Moderación (Discord)

Difusión

Contenido relacionado