SkillFoxx
Telegram

openclaw-skill-max-bot (MAX)

openclaw-skill-max-bot

Скилл OpenClaw подключает агента к мессенджеру MAX: Long Polling, расшифровка голосовых через Whisper, индикатор набора и публикация в каналы

  • 0 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

  • Токен бота MAX открывает переписку с ботом, а режим open пускает к агенту любого пользователя
  • Агент OpenClaw исполняет запросы из мессенджера, поэтому круг пользователей ограничивают списком
Все причины и проверки
Российский стек

sc32br/openclaw-skill-max-botАвтор:SC32br

Установка

Работает в
Сервисы

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/openclaw-skill-max-bot

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Токен бота MAX открывает переписку с ботом, а режим open пускает к агенту любого пользователя
  • Агент OpenClaw исполняет запросы из мессенджера, поэтому круг пользователей ограничивают списком

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл `max-bot` вместе с плагином `openclaw-max-channel` на Node.js связывает агента OpenClaw с мессенджером MAX (max.ru). Плагин держит Long Polling к `platform-api.max.ru`, передает агенту текст сообщений и возвращает ответы, а на время ответа показывает индикатор набора. Голосовые сообщения скачиваются и расшифровываются локально командой `whisper` без ключа OpenAI, модель `tiny`, `base`, `small` или `medium` выбирается под память сервера. Автоматическая установка запускается фразой «подключи MAX бот»: агент клонирует репозиторий, ставит зависимости через `npm install`, запрашивает токен бота, записывает `MAX_TOKEN` в `~/.openclaw/.env`, обновляет `openclaw.json` и перезапускает шлюз. Затем он помогает найти собственный `user_id` в MAX, который отличается от идентификатора Telegram. Доступ задается списком `allowFrom` и политикой `dmPolicy`: `allowlist` пускает только перечисленных пользователей, `open` пускает всех. Скрипт `scripts/max_send.py` нужен для публикации в каналы MAX.

Для кого. Пользователям OpenClaw, у которых есть юрлицо или ИП для регистрации бота в MAX и которые хотят общаться с агентом в российском мессенджере, в том числе голосом.

Подходит, если

  • Агент OpenClaw отвечает сотрудникам в MAX, а не в Telegram
  • Голосовые сообщения превращаются в текст локально, без отправки аудио внешнему сервису
  • Результаты работы агента публикуются в канал MAX скриптом
  • Доступ к боту ограничен несколькими известными идентификаторами пользователей

Не подходит, если

  • У вас нет юрлица или ИП: без них бота в MAX на business.max.ru не зарегистрировать
  • Агент работает не на OpenClaw: плагин написан под его конфигурацию `openclaw.json`
  • Сервер слабый: даже модель Whisper `small` просит около 2 ГБ памяти

Пример запроса к агенту

подключи MAX бот

Ограничения

Регистрация бота в MAX требует российского юрлица или ИП, физлица такого права не имеют. Нужны Node.js 18, шлюз OpenClaw и, для голосовых, установленный командой `pip install openai-whisper` Whisper. Модель `small` занимает около 462 МБ и просит около 2 ГБ памяти, `medium` просит около 5 ГБ.

Идентификатор пользователя в MAX отдельный от Telegram, его находят в логах шлюза после первого сообщения боту. В режиме `open` бот отвечает всем, поэтому оставляйте `allowlist`. Если бот молчит, причина чаще всего в токене, пустом `allowFrom` или плагине, не внесенном в `plugins.allow`.

Как отключить. Уберите `openclaw-max-channel` из `plugins.allow` и `plugins.entries` в `openclaw.json`, удалите `MAX_TOKEN` из `~/.openclaw/.env` и перезапустите шлюз.

Частые вопросы

Как подключить MAX к OpenClaw?

Скажите агенту «подключи MAX бот» и пришлите токен бота из business.max.ru. Агент сам склонирует плагин, поставит зависимости и обновит `openclaw.json`.

Кто может зарегистрировать бота в MAX?

Только юрлицо или ИП: регистрация идет на business.max.ru. Физические лица бота зарегистрировать не могут.

Нужен ли ключ OpenAI для голосовых?

Нет. Расшифровка идет локально командой `whisper`, ключ OpenAI не требуется. Установка: `pip install openai-whisper`.

Как узнать свой идентификатор в MAX?

Напишите боту любое сообщение и найдите в логах шлюза строку `[MAX] Inbound from`, число после `from` и есть `user_id`. Добавьте его в `allowFrom`.

Как ограничить доступ к боту?

Оставьте `dmPolicy` равным `allowlist` и впишите разрешенные идентификаторы в `allowFrom`. Значение `open` открывает бота всем.

Обсуждение

Вопросов и отзывов пока нет.

MAX — все инструменты
Российский стек

Канал-плагин, который подключает AI-ассистента OpenClaw к мессенджеру MAX через официальный Bot API: текст, медиа, кнопки, стриминг, мультиаккаунт

ПлагинРасширенный доступ
Российский стек

Канал-плагин, который подключает ИИ-ассистента OpenClaw к мессенджеру MAX: текст, вложения, кнопки, закрепление и вебхуки

ПлагинРасширенный доступ7

Канал MAX для Claude Code

claude-max-messenger-plugin

Российский стек

Плагин-канал Claude Code для мессенджера MAX через Bot API: пишете боту, Claude отвечает из терминала, доступ по коду сопряжения

ПлагинШирокий доступ5
Российский стек

Набор упрощенных примеров на Python, из которых можно собрать личного AI-секретаря в мессенджере MAX через Bot API, User API и MCP

ВоркфлоуШирокий доступ2
Российский стек

Надежный демон и плагин-мост: общайся со своей сессией Claude Code из мессенджера MAX, с фото, голосом и кнопками

ПлагинШирокий доступ
Российский стек

MCP-сервер для Bot API мессенджера MAX: сообщения, медиа, чаты, участники и кнопки из агента

MCP-серверРасширенный доступ12

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
openclaw-skill-max-bot (MAX) (эта карточка)нет0
Плагин MAX для OpenClawнет7другой плагин MAX для OpenClaw без автоустановки скиллом и расшифровки голосовых
MAX-шлюз для Hermes Agentнет17шлюз MAX для Hermes, а не для OpenClaw

Коротко о README

README показывает архитектуру потока сообщений, автоматическую и ручную установку, справочник настроек, голосовые сообщения с выбором модели Whisper, поиск идентификатора пользователя и устранение неполадок.

Бейдж для README

Исходный SKILL.md

---
name: max-bot
description: Full integration with MAX messenger (max.ru) via OpenClaw plugin. Use when you need to: connect a MAX bot to an OpenClaw agent, handle text and voice messages, show typing indicators, publish to MAX channels, configure allowlists, or set up the openclaw-max-channel plugin from scratch. Triggers on: MAX, max.ru, MAX bot, MAX channel, MAX plugin, голосовые MAX, typing MAX, openclaw-max-channel.
---

# MAX Bot — OpenClaw Plugin (Auto-installer)

MAX messenger (max.ru) — Russian messenger by VK/Mail.ru, 85M+ users.  
This skill covers the **full automated setup**: bot registration, plugin install, voice transcription via Whisper, typing indicators, and channel publishing.

---

## ⚠️ Important Prerequisites

> **MAX bot registration requires a Russian legal entity (юрлицо) or sole proprietor (ИП).**  
> Individual accounts cannot register bots on MAX.  
> Register at: [business.max.ru](https://business.max.ru/self)

---

## 🤖 Auto-Installation (for AI agent)

When user says "подключи MAX бот" or "setup MAX bot", follow these steps in order:

### Step 1 — Clone the plugin repository

```bash
git clone https://github.com/SC32br/openclaw-skill-max-bot ~/agents-workspace/plugins/openclaw-max-channel --depth=1 && cp -r ~/agents-workspace/plugins/openclaw-max-channel/plugins/openclaw-max-channel ~/agents-workspace/plugins/
```

### Step 2 — Install plugin dependencies

```bash
cd ~/agents-workspace/plugins/openclaw-max-channel && npm install
```

### Step 3 — Ask the user for their MAX bot token

Ask the user:
> "Перейди на business.max.ru → Чат-боты → [твой бот] → Интеграция → Токен.  
> Скопируй токен и пришли мне."

Wait for the token before proceeding.

### Step 4 — Add token to environment file

Сообщить о проблеме