openclaw message

Jedno polecenie wychodzące do wysyłania wiadomości i wykonywania działań kanałów w Discord, Google Chat, iMessage, Matrix, Mattermost (plugin), Microsoft Teams, Signal, Slack, Telegram i WhatsApp.

openclaw message <subcommand> [flags]

Wybór kanału

• --channel <name> jest wymagane, jeśli skonfigurowano więcej niż jeden kanał; jeśli skonfigurowano dokładnie jeden kanał, jest on kanałem domyślnym.
• Wartości: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (Mattermost wymaga pluginu).
• Cele z prefiksem kanału (na przykład discord:channel:123) wskazują plugin będący właścicielem bez jawnego podawania --channel.

Formaty celu (-t, --target)

Wyszukiwanie nazw kanałów: w przypadku dostawców z katalogiem (Discord/Slack/itp.) nazwy takie jak Help lub #help są rozwiązywane za pomocą pamięci podręcznej katalogu, a w razie braku wpisu w pamięci podręcznej wykonywane jest wyszukiwanie w aktywnym katalogu, jeśli dostawca je obsługuje.

Wspólne flagi

Każde działanie akceptuje: --channel <name>, --account <id>, --json, --dry-run, --verbose. Działania wymagające miejsca docelowego akceptują również -t, --target <dest>.

Rozwiązywanie SecretRef

openclaw message rozwiązuje odwołania SecretRef kanałów przed wykonaniem działania, z możliwie najwęższym zakresem:

• zakres kanału, gdy ustawiono --channel (lub wywnioskowano go z celu z prefiksem)
• zakres konta, gdy ustawiono również --account
• wszystkie skonfigurowane kanały, gdy nie ustawiono żadnej z tych opcji

Nierozwiązane odwołania SecretRef w niepowiązanych kanałach nigdy nie blokują działania skierowanego do konkretnego celu; nierozwiązane odwołanie SecretRef w wybranym kanale lub koncie powoduje bezpieczne przerwanie działania.

Działania

Podstawowe

Wysyłanie

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

• --media <path-or-url>: dołącza obraz, plik audio, film lub dokument (ścieżkę lokalną albo URL).
• --presentation <json>: współdzielony ładunek z blokami text, context, divider, chart, table, buttons i select, renderowany zgodnie z możliwościami kanału. Zobacz Prezentacja wiadomości.
• --delivery <json>: ogólne preferencje dostarczania, na przykład {"pin": true}. --pin jest skrótem dla przypiętego dostarczenia, jeśli kanał je obsługuje.
• --reply-to <id>, --thread-id <id> (temat forum Telegram; znacznik czasu wątku Slack, to samo pole co --reply-to).
• --force-document (Telegram, WhatsApp): wysyła obrazy, pliki GIF i filmy jako dokumenty, aby uniknąć kompresji kanału.
• --silent (Telegram, Discord): wysyła bez powiadomienia.
• --gif-playback (tylko WhatsApp): traktuje materiał wideo jako odtwarzany plik GIF.

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 renderuje obsługiwane bloki wykresów natywnie; pozostałe kanały otrzymują te same dane w postaci czytelnego tekstu:

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 renderuje również natywnie jawne bloki tabel. Inne kanały otrzymują podpis i każdy wiersz jako deterministyczny 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}]}'

Przyciski Mini App w Telegramie używają webApp (web_app jest nadal obsługiwane podczas analizy starszego formatu JSON) i są renderowane wyłącznie w prywatnych czatach między użytkownikiem a botem:

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

Ankieta

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>: powtórz od 2 do 12 razy.
• --poll-multi: zezwala na wybór wielu opcji.
• 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

Wątki

• thread create: kanały Discord. Wymagane: --thread-name, --target (identyfikator kanału). Opcjonalne: --message-id, --message, --auto-archive-min.
• thread list: kanały Discord. Wymagane: --guild-id. Opcjonalne: --channel-id, --include-archived, --before, --limit.
• thread reply: kanały Discord. Wymagane: --target (identyfikator wątku), --message. Opcjonalne: --media, --reply-to.

Emoji

• emoji list: Discord (--guild-id), Slack (bez dodatkowych flag).
• emoji upload: Discord. Wymagane: --guild-id, --emoji-name, --media. Opcjonalne: --role-ids (można powtarzać).

Naklejki

• sticker send: Discord. Wymagane: --target, --sticker-id (można powtarzać). Opcjonalne: --message.
• sticker upload: Discord. Wymagane: --guild-id, --sticker-name, --sticker-desc, --sticker-tags, --media.

Role, kanały, komunikacja głosowa i wydarzenia (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: wymagane --guild-id, --event-name, --start-time; opcjonalne --end-time, --desc, --channel-id, --location, --event-type, --image <url-or-path>.

Moderacja (Discord)

• timeout: --guild-id, --user-id; opcjonalne --duration-min lub --until (pomiń oba, aby usunąć ograniczenie czasowe), --reason.
• kick: --guild-id, --user-id, --reason.
• ban: --guild-id, --user-id, --delete-days, --reason.

Rozsyłanie

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

Wysyła jeden ładunek do wielu celów. Opcja --targets przyjmuje listę rozdzieloną spacjami. Użyj --channel all, aby objąć każdy skonfigurowany moduł dostawcy.

Powiązane

• Dokumentacja CLI
• Wysyłanie przez agenta
• Prezentacja wiadomości