openclaw message

Einheitlicher 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; ist genau ein Kanal konfiguriert, 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) ermitteln das zuständige Plugin ohne explizites --channel.

Zielformate (-t, --target)

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-Fehltreffer wird auf eine Live-Verzeichnissuche zurückgegriffen, sofern der Provider diese unterstützt.

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 SecretRefs des Kanals vor der Ausführung der Aktion auf, wobei der Geltungsbereich so eng wie möglich gefasst wird:

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

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

Aktionen

Kernfunktionen

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 Fähigkeiten des jeweiligen Kanals dargestellt werden. Siehe Nachrichtendarstellung.
• --delivery <json>: allgemeine Zustellungseinstellungen, zum Beispiel {"pin": true}. --pin ist eine Kurzform für angeheftete Zustellung, wenn der Kanal dies 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 "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 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":"Quarterly revenue","categories":["Q1","Q2"],"series":[{"name":"Revenue","values":[120,145]}],"xLabel":"Quarter"}]}'

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 report","blocks":[{"type":"table","caption":"Open pipeline","headers":["Account","Stage","ARR"],"rows":[["Acme","Won",125000],["Globex","Review",82000]],"rowHeaderColumnIndex":0}]}'

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

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

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- bis 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 "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: Kanal Discord. Erforderlich: --thread-name, --target (Kanal-ID). Optional: --message-id, --message, --auto-archive-min.
• thread list: Kanal Discord. Erforderlich: --guild-id. Optional: --channel-id, --include-archived, --before, --limit.
• thread reply: Kanal 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 (wiederholbar).

Sticker

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

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

Moderation (Discord)

• timeout: --guild-id, --user-id; optional --duration-min oder --until (lassen Sie beide weg, 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 alle konfigurierten Provider anzusprechen.

Verwandte Themen

• CLI-Referenz
• Agent-Versand
• Nachrichtendarstellung