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 standaardwaarde.
• Waarden: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (Mattermost vereist de Plugin).
• Doelen met een kanaalvoorvoegsel (bijvoorbeeld discord:channel:123) worden zonder expliciete --channel gekoppeld aan de bijbehorende Plugin.

Doelindelingen (-t, --target)

Kanaalnamen opzoeken: bij providers met een directory (Discord/Slack/enzovoort) worden namen zoals Help of #help via de directorycache gevonden. Als ze niet in de cache staan, wordt teruggevallen op een live directoryzoekopdracht als 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 kanaal-SecretRefs voordat de actie wordt uitgevoerd, met een zo beperkt mogelijk bereik:

• kanaalbereik wanneer --channel is ingesteld (of wordt afgeleid uit een doel met voorvoegsel)
• accountbereik wanneer ook --account is ingesteld
• alle geconfigureerde kanalen wanneer geen van beide is ingesteld

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

Acties

Kern

Verzenden

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

• --media <path-or-url>: voeg een afbeelding, audiobestand, video of document toe (lokaal pad of URL).
• --presentation <json>: gedeelde payload met blokken van het type text, context, divider, chart, table, buttons en select, weergegeven volgens de mogelijkheden van elk kanaal. Zie Berichtpresentatie.
• --delivery <json>: algemene afleveringsvoorkeuren, bijvoorbeeld {"pin": true}. --pin is een verkorte schrijfwijze voor vastgezette aflevering wanneer het kanaal dit ondersteunt.
• --reply-to <id>, --thread-id <id> (Telegram-forumonderwerp; Slack-threadtijdstempel, hetzelfde veld als --reply-to).
• --force-document (Telegram, WhatsApp): verzend afbeeldingen, GIF's en 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 "Choose:" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Approve","value":"approve","style":"success"},{"label":"Decline","value":"decline","style":"danger"}]}]}'

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

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

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

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

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

Knoppen voor Telegram Mini Apps 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 "Open app:" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Launch","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":"Status update","blocks":[{"type":"text","text":"Build completed"}]}'

Peiling

openclaw message poll --channel discord \  --target channel:123 \  --poll-question "Snack?" \  --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

Discussies

• thread create: kanaal Discord. Vereist: --thread-name, --target (kanaal-id). Optioneel: --message-id, --message, --auto-archive-min.
• thread list: kanaal Discord. Vereist: --guild-id. Optioneel: --channel-id, --include-archived, --before, --limit.
• thread reply: kanaal Discord. Vereist: --target (discussie-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 (herhaalbaar).

Stickers

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

Rollen, kanalen, spraak en evenementen (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 op te heffen), --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]

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

Gerelateerd

• CLI-referentie
• Verzenden door agent
• Berichtpresentatie