`openclaw message`

Ein einziger ausgehender Befehl zum Senden von Nachrichten und Ausführen von Kanalaktionen über Discord, Google Chat, iMessage, Matrix, Mattermost (Plugin), Microsoft Teams, Signal, Slack, Telegram und WhatsApp.

openclaw message <subcommand> [flags]

Kanalauswahl

--channel <name> ist erforderlich, wenn mehr als ein Kanal konfiguriert ist; bei genau einem konfigurierten Kanal wird dieser standardmäßig verwendet.
Werte: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (Mattermost erfordert das Plugin).
Ziele mit Kanalpräfix (zum Beispiel discord:channel:123) lösen das zuständige Plugin ohne explizites --channel auf.

Zielformate (`-t, --target`)

Kanal	Format
Discord	`channel:<id>`, `user:<id>`, `<@id>`-Erwähnung oder eine einfache numerische ID (wird als Kanal-ID behandelt)
Google Chat	`spaces/<spaceId>` oder `users/<userId>`
iMessage	Handle, `chat_id:<id>`, `chat_guid:<guid>` oder `chat_identifier:<id>`
Mattermost (Plugin)	`channel:<id>`, `user:<id>`, `@username` oder eine einfache ID (wird als Kanal behandelt)
Matrix	`@user:server`, `!room:server` oder `#alias:server`
Microsoft Teams	`conversation:<id>` (`19:...@thread.tacv2`), eine einfache Konversations-ID oder `user:<aad-object-id>`
Signal	`+E.164`, `group:<id>`, `uuid:<id>`, `username:<name>`/`u:<name>` oder eine dieser Angaben mit vorangestelltem `signal:`
Slack	`channel:<id>` oder `user:<id>` (eine einfache ID wird als Kanal behandelt)
Telegram	Chat-ID, `@username` oder ein Forenthemenziel: `<chatId>:topic:<topicId>` (oder `--thread-id <topicId>`)
WhatsApp	E.164, Gruppen-JID (`...@g.us`) oder Kanal-/Newsletter-JID (`...@newsletter`)

Suche nach Kanalnamen: Bei Providern mit einem Verzeichnis (Discord/Slack usw.) werden Namen wie Help oder #help über den Verzeichnis-Cache aufgelöst. Bei einem Cache-Fehlschlag wird, sofern vom Provider unterstützt, auf eine Live-Verzeichnissuche zurückgegriffen.

Allgemeine Flags

Jede Aktion akzeptiert: --channel <name>, --account <id>, --json, --dry-run, --verbose. Aktionen mit einem Ziel akzeptieren außerdem -t, --target <dest>.

SecretRef-Auflösung

openclaw message löst Kanal-SecretRefs vor der Ausführung der Aktion auf, mit einem möglichst engen Geltungsbereich:

kanalbezogen, wenn --channel festgelegt ist (oder aus einem Ziel mit Präfix abgeleitet wird)
kontobezogen, wenn zusätzlich --account festgelegt ist
alle konfigurierten Kanäle, wenn keines von beiden festgelegt ist

Nicht aufgelöste SecretRefs in nicht betroffenen Kanälen blockieren niemals eine gezielte Aktion; ein nicht aufgelöster SecretRef im ausgewählten Kanal/Konto lässt die Aktion sicher fehlschlagen.

Aktionen

Kernfunktionen

Aktion	Kanäle	Erforderlich	Hinweise
`send`	Discord, Google Chat, iMessage, Matrix, Mattermost (Plugin), Microsoft Teams, Signal, Slack, Telegram, WhatsApp	`--target` sowie eines von `--message`/`--media`/`--presentation`	Siehe nachfolgend Senden.
`poll`	Discord, Matrix, Microsoft Teams, Telegram, WhatsApp	`--target`, `--poll-question`, `--poll-option` (wiederholen)	Siehe nachfolgend Umfrage.
`react`	Discord, Matrix, Nextcloud Talk, Signal, Slack, Telegram, WhatsApp	`--message-id`, `--target`	`--emoji`, `--remove` (erfordert `--emoji`; lassen Sie es weg, um eigene Reaktionen zu entfernen, sofern unterstützt, siehe Reaktionen). WhatsApp: `--participant`, `--from-me`. Signal-Gruppenreaktionen erfordern `--target-author` oder `--target-author-uuid`. Nextcloud Talk fügt nur Reaktionen hinzu; `--remove` verursacht einen Fehler.
`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` liest einen bestimmten Zeitstempel; kombinieren Sie es mit `--thread-id` für eine exakte Thread-Antwort.
`edit`	Discord, Matrix, Microsoft Teams, Slack, Telegram	`--message-id`, `--message`, `--target`	Telegram-Forenthreads verwenden `--thread-id`.
`delete`	Discord, Matrix, Microsoft Teams, Slack, Telegram	`--message-id`, `--target`
`pin` / `unpin`	Discord, Matrix, Microsoft Teams, Slack	`--message-id`, `--target`	`unpin` akzeptiert auch `--pinned-message-id` (Microsoft Teams: die Ressourcen-ID für Anheften/Auflistung angehefteter Elemente, nicht die Chatnachrichten-ID).
`pins` (Liste)	Discord, Matrix, Microsoft Teams, Slack	`--target`	`--limit`.
`permissions`	Discord, Matrix	`--target`	Matrix: nur verfügbar, wenn die Verschlüsselung aktiviert ist und Verifizierungsaktionen zulässig sind.
`search`	Discord	`--guild-id`, `--query`	`--channel-id`, `--channel-ids` (wiederholen), `--author-id`, `--author-ids` (wiederholen), `--limit`.
`member info`	Discord, Matrix, Microsoft Teams, Slack	`--user-id`	`--guild-id` (Discord).

Senden

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

--media <path-or-url>: Bild/Audio/Video/Dokument anhängen (lokaler Pfad oder URL).
--presentation <json>: gemeinsame Nutzlast mit text-, context-, divider-, chart-, table-, buttons- und select-Blöcken, die entsprechend den Kanalfunktionen gerendert wird. Siehe Nachrichtendarstellung.
--delivery <json>: allgemeine Zustellungspräferenzen, zum Beispiel {"pin": true}. --pin ist eine Kurzform für angeheftete Zustellung, sofern der Kanal sie unterstützt.
--reply-to <id>, --thread-id <id> (Telegram-Forenthema; Slack-Thread- Zeitstempel, dasselbe Feld wie --reply-to).
--force-document (Telegram, WhatsApp): Bilder/GIFs/Videos als Dokumente senden, um die Kanalkomprimierung zu vermeiden.
--silent (Telegram, Discord): ohne Benachrichtigung senden.
--gif-playback (nur WhatsApp): Videomedien als GIF-Wiedergabe behandeln.

openclaw message send --channel discord \
  --target channel:123 --message "Auswählen:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Genehmigen","value":"approve","style":"success"},{"label":"Ablehnen","value":"decline","style":"danger"}]}]}'

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

Slack stellt unterstützte Diagrammblöcke nativ dar; andere Kanäle erhalten dieselben Daten als lesbaren Text:

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

Slack stellt auch explizite Tabellenblöcke nativ dar. Andere Kanäle erhalten die Beschriftung und jede Zeile als deterministischen Text:

openclaw message send --channel slack --target channel:C123 \
  --presentation '{"title":"Pipeline-Bericht","blocks":[{"type":"table","caption":"Offene Pipeline","headers":["Konto","Phase","ARR"],"rows":[["Acme","Won",125000],["Globex","Review",82000]],"rowHeaderColumnIndex":0}]}'

Telegram-Mini-App-Schaltflächen verwenden webApp (web_app wird für Legacy- JSON weiterhin geparst) und werden nur in privaten Chats zwischen einem Benutzer und dem Bot dargestellt:

openclaw message send --channel telegram --target 123456789 --message "App öffnen:" \
  --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":"Statusaktualisierung","blocks":[{"type":"text","text":"Build abgeschlossen"}]}'

Umfrage

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>: 2-12-mal wiederholen.
--poll-multi: Mehrfachauswahl zulassen.
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 "Mittagessen?" \
  --poll-option Pizza --poll-option Sushi \
  --poll-duration-seconds 120 --silent

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

Threads

thread create: Kanäle Discord. Erforderlich: --thread-name, --target (Kanal-ID). Optional: --message-id, --message, --auto-archive-min.
thread list: Kanäle Discord. Erforderlich: --guild-id. Optional: --channel-id, --include-archived, --before, --limit.
thread reply: Kanäle Discord. Erforderlich: --target (Thread-ID), --message. Optional: --media, --reply-to.

Emojis

emoji list: Discord (--guild-id), Slack (keine zusätzlichen Flags).
emoji upload: Discord. Erforderlich: --guild-id, --emoji-name, --media. Optional: --role-ids (wiederholen).

Sticker

sticker send: Discord. Erforderlich: --target, --sticker-id (wiederholen). Optional: --message.
sticker upload: Discord. Erforderlich: --guild-id, --sticker-name, --sticker-desc, --sticker-tags, --media.

Rollen, Kanäle, Sprache und Ereignisse (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: erforderlich --guild-id, --event-name, --start-time; optional --end-time, --desc, --channel-id, --location, --event-type, --image <url-or-path>.

Moderation (Discord)

timeout: --guild-id, --user-id; optional --duration-min oder --until (beide weglassen, um das Timeout aufzuheben), --reason.
kick: --guild-id, --user-id, --reason.
ban: --guild-id, --user-id, --delete-days, --reason.

Rundsendung

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

Sendet eine Nutzlast an mehrere Ziele. --targets akzeptiert eine durch Leerzeichen getrennte Liste. Verwenden Sie --channel all, um jeden konfigurierten Provider anzusprechen.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Nachricht

`openclaw message`

Kanalauswahl

Zielformate (`-t, --target`)

Allgemeine Flags

SecretRef-Auflösung

Aktionen

Kernfunktionen

Senden

Umfrage

Threads

Emojis

Sticker

Rollen, Kanäle, Sprache und Ereignisse (Discord)

Moderation (Discord)

Rundsendung

Verwandte Themen

​openclaw message

​Kanalauswahl

​Zielformate (-t, --target)

​Allgemeine Flags

​SecretRef-Auflösung

​Aktionen

​Kernfunktionen

​Senden

​Umfrage

​Threads

​Emojis

​Sticker

​Rollen, Kanäle, Sprache und Ereignisse (Discord)

​Moderation (Discord)

​Rundsendung

​Verwandte Themen

`openclaw message`

Kanalauswahl

Zielformate (`-t, --target`)

Allgemeine Flags

SecretRef-Auflösung

Aktionen

Kernfunktionen

Senden

Umfrage

Threads

Emojis

Sticker

Rollen, Kanäle, Sprache und Ereignisse (Discord)

Moderation (Discord)

Rundsendung

Verwandte Themen