Skip to main content

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;
  • усіма налаштованими каналами, коли не задано жодного з них.
Невизначені SecretRef у непов’язаних каналах ніколи не блокують цільову дію; невизначений SecretRef у вибраному каналі чи обліковому записі спричиняє безпечну відмову дії.

Дії

Основні

Надсилання

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

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