`openclaw message`

Eén uitgaande opdracht voor het verzenden van berichten en kanaalacties via Discord, Google Chat, iMessage, Matrix, Mattermost (Plugin), Microsoft Teams, Signal, Slack, Telegram en WhatsApp.

openclaw message <subcommand> [flags]

Kanaalselectie

--channel <name> is vereist als er meer dan één kanaal is geconfigureerd; als er precies één kanaal is geconfigureerd, is dat kanaal de standaard.
Waarden: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (voor Mattermost is de Plugin vereist).
Doelen met een kanaalvoorvoegsel (bijvoorbeeld discord:channel:123) vinden de bijbehorende Plugin zonder een expliciete --channel.

Doelindelingen (`-t, --target`)

Kanaal	Indeling
Discord	`channel:<id>`, `user:<id>`, `<@id>`-vermelding of een kale numerieke id (behandeld als een kanaal-id)
Google Chat	`spaces/<spaceId>` of `users/<userId>`
iMessage	handle, `chat_id:<id>`, `chat_guid:<guid>` of `chat_identifier:<id>`
Mattermost (Plugin)	`channel:<id>`, `user:<id>`, `@username` of een kale id (behandeld als een kanaal)
Matrix	`@user:server`, `!room:server` of `#alias:server`
Microsoft Teams	`conversation:<id>` (`19:...@thread.tacv2`), een kale gespreks-id of `user:<aad-object-id>`
Signal	`+E.164`, `group:<id>`, `uuid:<id>`, `username:<name>`/`u:<name>` of een van deze met het voorvoegsel `signal:`
Slack	`channel:<id>` of `user:<id>` (een kale id wordt behandeld als een kanaal)
Telegram	chat-id, `@username` of een forumonderwerpdoel: `<chatId>:topic:<topicId>` (of `--thread-id <topicId>`)
WhatsApp	E.164, groeps-JID (`...@g.us`) of kanaal-/nieuwsbrief-JID (`...@newsletter`)

Kanaalnamen opzoeken: voor providers met een directory (Discord/Slack/etc.) worden namen zoals Help of #help gevonden via de directorycache. Als deze niet in de cache staan, wordt teruggevallen op een live directoryzoekopdracht wanneer de provider dit ondersteunt.

Algemene vlaggen

Elke actie accepteert: --channel <name>, --account <id>, --json, --dry-run, --verbose. Acties met een bestemming accepteren ook -t, --target <dest>.

SecretRef-resolutie

openclaw message resolveert SecretRefs van kanalen voordat de actie wordt uitgevoerd, met een zo beperkt mogelijk bereik:

kanaalgebonden wanneer --channel is ingesteld (of afgeleid van een doel met voorvoegsel)
accountgebonden wanneer --account ook is ingesteld
alle geconfigureerde kanalen wanneer geen van beide is ingesteld

Onopgeloste SecretRefs voor niet-gerelateerde kanalen blokkeren een gerichte actie nooit; een onopgeloste SecretRef voor het geselecteerde kanaal/account laat de actie veilig mislukken.

Acties

Kern

Actie	Kanalen	Vereist	Opmerkingen
`send`	Discord, Google Chat, iMessage, Matrix, Mattermost (Plugin), Microsoft Teams, Signal, Slack, Telegram, WhatsApp	`--target`, plus een van `--message`/`--media`/`--presentation`	Zie Verzenden hieronder.
`poll`	Discord, Matrix, Microsoft Teams, Telegram, WhatsApp	`--target`, `--poll-question`, `--poll-option` (herhalen)	Zie Peiling hieronder.
`react`	Discord, Matrix, Nextcloud Talk, Signal, Slack, Telegram, WhatsApp	`--message-id`, `--target`	`--emoji`, `--remove` (vereist `--emoji`; laat dit weg om waar ondersteund eigen reacties te wissen, zie Reacties). WhatsApp: `--participant`, `--from-me`. Voor reacties in Signal-groepen is `--target-author` of `--target-author-uuid` vereist. Nextcloud Talk voegt alleen reacties toe; `--remove` geeft een fout.
`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` leest een specifiek tijdstempel; combineer dit met `--thread-id` voor een exact antwoord in een thread.
`edit`	Discord, Matrix, Microsoft Teams, Slack, Telegram	`--message-id`, `--message`, `--target`	Telegram-forumthreads gebruiken `--thread-id`.
`delete`	Discord, Matrix, Microsoft Teams, Slack, Telegram	`--message-id`, `--target`
`pin` / `unpin`	Discord, Matrix, Microsoft Teams, Slack	`--message-id`, `--target`	`unpin` accepteert ook `--pinned-message-id` (Microsoft Teams: de resource-id voor vastmaken/vastgemaakte items weergeven, niet de bericht-id van de chat).
`pins` (lijst)	Discord, Matrix, Microsoft Teams, Slack	`--target`	`--limit`.
`permissions`	Discord, Matrix	`--target`	Matrix: alleen beschikbaar wanneer versleuteling is ingeschakeld en verificatieacties zijn toegestaan.
`search`	Discord	`--guild-id`, `--query`	`--channel-id`, `--channel-ids` (herhalen), `--author-id`, `--author-ids` (herhalen), `--limit`.
`member info`	Discord, Matrix, Microsoft Teams, Slack	`--user-id`	`--guild-id` (Discord).

Verzenden

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

--media <path-or-url>: voeg een afbeelding/audio/video/document toe (lokaal pad of URL).
--presentation <json>: gedeelde payload met text, context, divider, chart, table, buttons en select-blokken, weergegeven volgens de mogelijkheden van het kanaal. Zie Berichtpresentatie.
--delivery <json>: algemene bezorgvoorkeuren, bijvoorbeeld {"pin": true}. --pin is een verkorte notatie voor vastgemaakte bezorging wanneer het kanaal dit ondersteunt.
--reply-to <id>, --thread-id <id> (Telegram-forumonderwerp; tijdstempel van Slack-thread, hetzelfde veld als --reply-to).
--force-document (Telegram, WhatsApp): verzend afbeeldingen/GIF’s/video’s als documenten om kanaalcompressie te voorkomen.
--silent (Telegram, Discord): verzend zonder melding.
--gif-playback (alleen WhatsApp): behandel videomedia als GIF-weergave.

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

openclaw message send --channel telegram --target @mychat --message "Kies:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Ja","value":"cmd:yes"},{"label":"Nee","value":"cmd:no"}]}]}'

Slack geeft ondersteunde grafiekblokken native weer; andere kanalen ontvangen dezelfde gegevens als leesbare tekst:

openclaw message send --channel slack --target channel:C123 \
  --presentation '{"blocks":[{"type":"chart","chartType":"bar","title":"Kwartaalomzet","categories":["Q1","Q2"],"series":[{"name":"Omzet","values":[120,145]}],"xLabel":"Kwartaal"}]}'

Slack geeft ook expliciete tabelblokken native weer. Andere kanalen ontvangen het bijschrift en elke rij als deterministische tekst:

openclaw message send --channel slack --target channel:C123 \
  --presentation '{"title":"Pijplijnrapport","blocks":[{"type":"table","caption":"Open pijplijn","headers":["Account","Fase","ARR"],"rows":[["Acme","Won",125000],["Globex","Review",82000]],"rowHeaderColumnIndex":0}]}'

Telegram Mini App-knoppen gebruiken webApp (web_app wordt nog steeds geparseerd voor verouderde JSON) en worden alleen weergegeven in privéchats tussen een gebruiker en de bot:

openclaw message send --channel telegram --target 123456789 --message "App openen:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Starten","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":"Statusupdate","blocks":[{"type":"text","text":"Build voltooid"}]}'

Peiling

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

--poll-option <choice>: herhaal 2-12 keer.
--poll-multi: sta meerdere selecties toe.
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 "Lunch?" \
  --poll-option Pizza --poll-option Sushi \
  --poll-duration-seconds 120 --silent

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

Threads

thread create: kanalen Discord. Vereist: --thread-name, --target (kanaal-id). Optioneel: --message-id, --message, --auto-archive-min.
thread list: kanalen Discord. Vereist: --guild-id. Optioneel: --channel-id, --include-archived, --before, --limit.
thread reply: kanalen Discord. Vereist: --target (thread-id), --message. Optioneel: --media, --reply-to.

Emoji’s

emoji list: Discord (--guild-id), Slack (geen extra vlaggen).
emoji upload: Discord. Vereist: --guild-id, --emoji-name, --media. Optioneel: --role-ids (herhalen).

Stickers

sticker send: Discord. Vereist: --target, --sticker-id (herhalen). Optioneel: --message.
sticker upload: Discord. Vereist: --guild-id, --sticker-name, --sticker-desc, --sticker-tags, --media.

Rollen, kanalen, spraak en gebeurtenissen (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: vereist --guild-id, --event-name, --start-time; optioneel --end-time, --desc, --channel-id, --location, --event-type, --image <url-or-path>.

Moderatie (Discord)

timeout: --guild-id, --user-id; optioneel --duration-min of --until (laat beide weg om de time-out te wissen), --reason.
kick: --guild-id, --user-id, --reason.
ban: --guild-id, --user-id, --delete-days, --reason.

Uitzending

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

Verstuurt één payload naar meerdere doelen. --targets accepteert een door spaties gescheiden lijst. Gebruik --channel all om elke geconfigureerde provider als doel te gebruiken.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Bericht

`openclaw message`

Kanaalselectie

Doelindelingen (`-t, --target`)

Algemene vlaggen

SecretRef-resolutie

Acties

Kern

Verzenden

Peiling

Threads

Emoji’s

Stickers

Rollen, kanalen, spraak en gebeurtenissen (Discord)

Moderatie (Discord)

Uitzending

Gerelateerd

​openclaw message

​Kanaalselectie

​Doelindelingen (-t, --target)

​Algemene vlaggen

​SecretRef-resolutie

​Acties

​Kern

​Verzenden

​Peiling

​Threads

​Emoji’s

​Stickers

​Rollen, kanalen, spraak en gebeurtenissen (Discord)

​Moderatie (Discord)

​Uitzending

​Gerelateerd

`openclaw message`

Kanaalselectie

Doelindelingen (`-t, --target`)

Algemene vlaggen

SecretRef-resolutie

Acties

Kern

Verzenden

Peiling

Threads

Emoji’s

Stickers

Rollen, kanalen, spraak en gebeurtenissen (Discord)

Moderatie (Discord)

Uitzending

Gerelateerd