max - SKILL.md Agent Skill

name: MAX description: Канал-плагин для подключения OpenClaw к мессенджеру MAX (max.ru). Поддерживает отправку и получение текстовых сообщений, медиа, inline-кнопки, форматирование. Работает в режимах long polling и webhook. Используй когда нужно отправить сообщение через мессенджер MAX или обработать входящие сообщения из MAX.

MAX — плагин для OpenClaw

Канал-плагин для интеграции OpenClaw с мессенджером MAX (бывший VK Teams / Mail.ru для бизнеса).

Что делает

Плагин позволяет OpenClaw отправлять и получать сообщения через мессенджер MAX, поддерживая полный набор возможностей платформы:

Текстовые сообщения — отправка и получение текстов
Медиа — фото, видео, документы, голосовые сообщения
Inline-кнопки — интерактивные кнопки под сообщениями
Форматирование — поддержка Markdown/HTML разметки
Long polling — получение сообщений через постоянное соединение
Webhook — получение сообщений через HTTP-запросы
Мультиаккаунт — работа с несколькими ботами одновременно

Установка

openclaw plugin install openclaw-max

Или вручную:

cd ~/.openclaw/extensions
git clone https://github.com/openclaw/max openclaw-max

Настройка

1. Получение токена

Создайте бота в MAX Bot API
Скопируйте полученный токен

2. Конфигурация

Добавьте в ~/.openclaw/config.yaml:

plugins:
  channels:
    max:
      - name: my_max_bot
        token: YOUR_BOT_TOKEN
        mode: polling  # или webhook
        webhook_url: https://your-domain.com/webhook/max  # для webhook режима

3. Переменные окружения

export MAX_BOT_TOKEN=your_token_here

Требования

OpenClaw >= 0.5.0
Node.js >= 18.0.0
Доступ к MAX Bot API

Примеры использования

Отправка сообщения

openclaw message send --channel max --target "user@max.ru" --message "Привет из OpenClaw!"

Отправка с кнопками

openclaw message send \
  --channel max \
  --target "user@max.ru" \
  --message "Выберите действие:" \
  --buttons '[{"text": "Да", "callback": "yes"}, {"text": "Нет", "callback": "no"}]'

Отправка файла

openclaw message send \
  --channel max \
  --target "user@max.ru" \
  --media /path/to/file.pdf \
  --caption "Документ во вложении"

Использование в Python-скриптах

from openclaw import OpenClaw

claw = OpenClaw()
await claw.message.send(
    channel="max",
    target="user@max.ru",
    message="Привет!",
    buttons=[
        {"text": "Кнопка 1", "callback": "btn1"},
        {"text": "Кнопка 2", "callback": "btn2"}
    ]
)

Обработка входящих сообщений

from openclaw import plugin

@plugin.on_message(channel="max")
async def handle_max_message(message):
    print(f"Сообщение от {message.from_user}: {message.text}")
    await message.reply("Получено!")

Лицензия

MIT License

Поддержка

Issues: https://github.com/openclaw/max/issues
Telegram: @Helpdesk_VP_bot, @KotBanzaiBot