openclaw message
Єдина команда для надсилання вихідних повідомлень і виконання дій у каналах
Discord, Google Chat, iMessage, Matrix, Mattermost (Plugin), Microsoft Teams,
Signal, Slack, Telegram і WhatsApp.
Вибір каналу
--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; - усіма налаштованими каналами, коли не задано жодного з них.
Дії
Основні
Надсилання
--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.
webApp (web_app досі розпізнається для застарілого
JSON) і відображаються лише в приватних чатах між користувачем і ботом:
Опитування
--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.
Гілки
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.
Розсилка
--targets приймає розділений пробілами
список. Використовуйте --channel all, щоб охопити всіх налаштованих постачальників.