Плагин MAX для OpenClaw
openclaw-max-plus
Канал-плагин, который подключает AI-ассистента OpenClaw к мессенджеру MAX через официальный Bot API: текст, медиа, кнопки, стриминг, мультиаккаунт
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Отправляет и редактирует сообщения от имени бота в реальных чатах MAX
- Хранит токен бота и, в режиме webhook, принимает входящие запросы на публичный адрес
Установка
Ручная установка
npm install && npm run buildСборка плагина перед подключением.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин добавляет MAX как канал OpenClaw наравне с Telegram: прием и отправка текста в markdown, вложения (фото, видео, файлы, стикеры, контакт, локация, включая inline-base64 для сгенерированных картинок), длинные подписи с автоматической разбивкой на follow-up-сообщения, inline-кнопки разных типов, reply, forward с атрибуцией, edit, delete, pin и unpin для админов групп, стриминг ответа с индикатором «печатает», long polling и webhook с проверкой секрета, мультиаккаунт и политики доступа в личных сообщениях и группах. С версии 0.6.3 плагин умеет регистрировать меню команд бота через PATCH /me/commands, автоматически или вручную с русскими описаниями. Для распознавания голосовых сообщений из мобильного MAX обязательно нужен webhook, а не long polling: иначе аудио приходит пустым.
Для кого. Для тех, кто уже использует OpenClaw и хочет дать своему ассистенту канал в MAX так же, как в Telegram.
Подходит, если
- Есть верифицированный бот MAX через business.max.ru и нужно подключить его к OpenClaw
- Нужны голосовые сообщения от пользователей: тогда обязательно настраивается webhook с движком распознавания
- Нужно несколько ботов MAX одновременно, например рабочий и личный
Не подходит, если
- Не используете OpenClaw: плагин работает только внутри этого фреймворка
- Нет юрлица или статуса ИП: создание бота MAX через business.max.ru требует верификации организации
- Нужны реакции или опросы: MAX Bot API их не поддерживает, это ограничение платформы
Пример запроса к агенту
Настрой канал MAX в OpenClaw с вебхуком для распознавания голосовых сообщенийОграничения
Требует OpenClaw 2026.9.3 или новее и Node.js 24.16+ либо 26.1+. Создание бота требует верифицированного юрлица или ИП и модерации MAX до 48 часов. Long polling не доставляет нативные голосовые из мобильного приложения, для них обязателен webhook с настроенным движком распознавания аудио. MAX Bot API не поддерживает реакции и опросы.
Как отключить. Установите channels.max.enabled в false в ~/.openclaw/openclaw.json или удалите плагин командой openclaw plugins remove openclaw-max-plus и перезапустите gateway.
Проверка безопасности
- Отправляет и редактирует сообщения от имени бота в реальных чатах MAX
- Хранит токен бота и, в режиме webhook, принимает входящие запросы на публичный адрес
Коротко о README
README подробно описывает пошаговый runbook для агента: сборку плагина, подключение к OpenClaw, настройку канала с токеном и политикой доступа, обязательную настройку интервала индикатора печати, перезапуск gateway и поиск своего user_id. Отдельно разобраны регистрация меню команд через PATCH /me/commands, таблица всех полей конфигурации канала, мультиаккаунт и краткая справка по методам MAX Bot API с пометкой об устаревании домена platform-api.max.ru.
Частые вопросы
Почему голосовые сообщения не распознаются?
При long polling нативные голосовые из мобильного MAX приходят без аудио, нужно настроить webhook с публичным HTTPS-адресом и движок распознавания вроде Whisper.
Можно ли подключить несколько ботов MAX?
Да, через секцию accounts в конфигурации канала, каждый аккаунт может иметь свою политику доступа.
Похожие
MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Awesome Claude Skills от Composio
Awesome Claude Skills
Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub