openclaw message

Єдина команда для надсилання вихідних повідомлень і виконання дій у каналах Discord, Google Chat, iMessage, Matrix, Mattermost (Plugin), Microsoft Teams, Signal, Slack, Telegram і WhatsApp.

openclaw message <subcommand> [flags]

Вибір каналу

• --channel <name> є обов’язковим, якщо налаштовано більше одного каналу; якщо налаштовано рівно один канал, він використовується за замовчуванням.
• Значення: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (для Mattermost потрібен Plugin).
• Цілі з префіксом каналу (наприклад, discord:channel:123) визначають Plugin-власник без явного зазначення --channel.

Формати цілей (-t, --target)

Пошук за назвою каналу: для постачальників із каталогом (Discord/Slack тощо) назви на кшталт Help або #help визначаються за кешем каталогу, а якщо відповідного запису в кеші немає — виконується пошук у каталозі наживо, якщо постачальник це підтримує.

Спільні прапорці

Кожна дія приймає: --channel <name>, --account <id>, --json, --dry-run, --verbose. Дії, які потребують місця призначення, також приймають -t, --target <dest>.

Визначення SecretRef

openclaw message визначає SecretRef каналів перед виконанням дії, обмежуючи область якомога точніше:

• каналом, коли задано --channel (або його визначено з цілі з префіксом);
• обліковим записом, коли також задано --account;
• усіма налаштованими каналами, коли не задано жодного з них.

Невизначені SecretRef у непов’язаних каналах ніколи не блокують цільову дію; невизначений SecretRef у вибраному каналі чи обліковому записі спричиняє безпечну відмову дії.

Дії

Основні

Надсилання

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

• --media <path-or-url>: прикріпити зображення, аудіо, відео або документ (локальний шлях чи URL).
• --presentation <json>: спільне корисне навантаження з блоками text, context, divider, chart, table, buttons і select, яке відтворюється відповідно до можливостей каналу. Див. Представлення повідомлень.
• --delivery <json>: загальні параметри доставлення, наприклад {"pin": true}. --pin — скорочений запис для закріпленого доставлення, якщо канал його підтримує.
• --reply-to <id>, --thread-id <id> (тема форуму Telegram; часова позначка гілки Slack, те саме поле, що й --reply-to).
• --force-document (Telegram, WhatsApp): надсилати зображення, GIF-файли та відео як документи, щоб уникнути стиснення каналом.
• --silent (Telegram, Discord): надсилати без сповіщення.
• --gif-playback (лише WhatsApp): відтворювати відеомедіа як 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 відтворює підтримувані блоки діаграм у нативному вигляді; інші канали отримують ті самі дані у вигляді читабельного тексту:

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 також нативно відображає явні табличні блоки. Інші канали отримують підпис і кожен рядок як детермінований текст:

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 використовують webApp (web_app досі розпізнається для застарілого JSON) і відображаються лише в приватних чатах між користувачем і ботом:

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

Опитування

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 разів.
• --poll-multi: дозволяє вибирати кілька варіантів.
• 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

Гілки

• thread create: канали Discord. Обов’язкові: --thread-name, --target (ідентифікатор каналу). Необов’язкові: --message-id, --message, --auto-archive-min.
• thread list: канали Discord. Обов’язковий: --guild-id. Необов’язкові: --channel-id, --include-archived, --before, --limit.
• thread reply: канали Discord. Обов’язкові: --target (ідентифікатор гілки), --message. Необов’язкові: --media, --reply-to.

Емодзі

• emoji list: Discord (--guild-id), Slack (без додаткових прапорців).
• emoji upload: Discord. Обов’язкові: --guild-id, --emoji-name, --media. Необов’язковий: --role-ids (можна повторювати).

Стікери

• sticker send: Discord. Обов’язкові: --target, --sticker-id (можна повторювати). Необов’язковий: --message.
• sticker upload: Discord. Обов’язкові: --guild-id, --sticker-name, --sticker-desc, --sticker-tags, --media.

Ролі, канали, голосові функції та події (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: обов’язкові --guild-id, --event-name, --start-time; необов’язкові --end-time, --desc, --channel-id, --location, --event-type, --image <url-or-path>.

Модерація (Discord)

• timeout: --guild-id, --user-id; необов’язкові --duration-min або --until (не вказуйте жоден із них, щоб скасувати обмеження), --reason.
• kick: --guild-id, --user-id, --reason.
• ban: --guild-id, --user-id, --delete-days, --reason.

Розсилка

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

Надсилає одні й ті самі дані кільком адресатам. --targets приймає розділений пробілами список. Використовуйте --channel all, щоб охопити всіх налаштованих постачальників.

Пов’язані матеріали

• Довідник CLI
• Надсилання агентом
• Подання повідомлень