OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

Bericht

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.

bash
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

bash
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.
bash
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"}]}]}'
bash
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:

bash
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:

bash
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:

bash
openclaw message send --channel telegram --target 123456789 --message "App openen:" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Starten","webApp":{"url":"https://example.com/app"}}]}]}'
bash
openclaw message send --channel telegram --target @mychat \  --media ./diagram.png --force-document
bash
openclaw message send --channel msteams \  --target conversation:19:abc@thread.tacv2 \  --presentation '{"title":"Statusupdate","blocks":[{"type":"text","text":"Build voltooid"}]}'

Peiling

bash
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.
bash
openclaw message poll --channel telegram \  --target @mychat \  --poll-question "Lunch?" \  --poll-option Pizza --poll-option Sushi \  --poll-duration-seconds 120 --silent
bash
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

bash
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.

Gerelateerd

Was this useful?
On this page

On this page