SkillFoxx

openclaw-skill-max-bot (MAX)

openclaw-skill-max-bot

An OpenClaw skill that connects an agent to the MAX messenger: Long Polling, voice transcription through Whisper, typing indicator and channel publishing

  • 0 ★ on the repository
  • Last commit
  • MIT
Skill

Extended access

Why this level

  • The MAX bot token opens correspondence with the bot and the open mode lets any user reach the agent
  • The OpenClaw agent executes requests from the messenger, so the user circle is limited by a list
All reasons and checks
Russian stack

sc32br/openclaw-skill-max-botAuthor:SC32br

Install

Works in

In your terminal, with SkillFoxx CLI

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

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The MAX bot token opens correspondence with the bot and the open mode lets any user reach the agent
  • The OpenClaw agent executes requests from the messenger, so the user circle is limited by a list

This is third-party code. Review the repository files before installing.

What it does

The `max-bot` skill together with the Node.js plugin `openclaw-max-channel` links an OpenClaw agent with the MAX messenger (max.ru). The plugin holds Long Polling to `platform-api.max.ru`, passes message text to the agent and returns replies, showing a typing indicator while the answer is prepared. Voice messages are downloaded and transcribed locally with the `whisper` command and no OpenAI key, with a `tiny`, `base`, `small` or `medium` model chosen to fit server memory. Automatic installation starts with the phrase "подключи MAX бот": the agent clones the repository, installs dependencies with `npm install`, asks for the bot token, writes `MAX_TOKEN` to `~/.openclaw/.env`, updates `openclaw.json` and restarts the gateway. It then helps find your own `user_id` in MAX, which differs from the Telegram identifier. Access is set by the `allowFrom` list and the `dmPolicy` policy: `allowlist` admits only listed users and `open` admits everyone. The `scripts/max_send.py` script serves publishing to MAX channels.

Who it is for. OpenClaw users who have a legal entity or sole proprietorship to register a bot in MAX and want to talk to the agent in a Russian messenger, including by voice.

Good fit when

  • An OpenClaw agent answers employees in MAX instead of Telegram
  • Voice messages become text locally with no audio sent to an outside service
  • Agent results are published to a MAX channel with a script
  • Bot access is limited to a few known user identifiers

Not a fit when

  • You have no legal entity or sole proprietorship: a bot cannot be registered in MAX at business.max.ru without one
  • The agent does not run on OpenClaw: the plugin is written for its `openclaw.json` configuration
  • The server is weak: even the Whisper `small` model needs about 2 GB of memory

Example request

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

Limitations

Registering a bot in MAX requires a Russian legal entity or sole proprietor and individuals have no such right. Node.js 18, an OpenClaw gateway and, for voice, Whisper installed with `pip install openai-whisper` are needed. The `small` model takes about 462 MB and needs about 2 GB of memory, while `medium` needs about 5 GB.

A user identifier in MAX is separate from Telegram and is found in the gateway logs after the first message to the bot. In `open` mode the bot answers everyone, so keep `allowlist`. If the bot is silent the cause is most often the token, an empty `allowFrom` or a plugin missing from `plugins.allow`.

How to disable. Remove `openclaw-max-channel` from `plugins.allow` and `plugins.entries` in `openclaw.json`, delete `MAX_TOKEN` from `~/.openclaw/.env` and restart the gateway.

FAQ

How do I connect MAX to OpenClaw?

Tell the agent "подключи MAX бот" and send the bot token from business.max.ru. The agent clones the plugin, installs dependencies and updates `openclaw.json` itself.

Who can register a bot in MAX?

Only a legal entity or sole proprietor: registration is at business.max.ru. Individuals cannot register a bot.

Is an OpenAI key needed for voice?

No. Transcription runs locally with the `whisper` command and no OpenAI key is required. Install it with `pip install openai-whisper`.

How do I find my identifier in MAX?

Write any message to the bot and find the `[MAX] Inbound from` line in the gateway logs, and the number after `from` is the `user_id`. Add it to `allowFrom`.

How do I limit bot access?

Keep `dmPolicy` at `allowlist` and put the allowed identifiers in `allowFrom`. The `open` value opens the bot to everyone.

Discussion

No questions or reviews yet.

All MAX messenger tools

MAX plugin for OpenClaw

openclaw-max-plus

Russian stack

A channel plugin that connects the OpenClaw AI assistant to the MAX messenger via the official Bot API: text, media, buttons, streaming, multiple accounts

PluginExtended access
Russian stack

A channel plugin that connects the OpenClaw AI assistant to the MAX messenger: text, attachments, buttons, pinning and webhooks

PluginExtended access7

MAX channel for Claude Code

claude-max-messenger-plugin

Russian stack

A Claude Code channel plugin for MAX messenger via Bot API: message the bot and Claude answers from the terminal, with pairing-code access

PluginBroad access5

MAX AI secretary guide

clawbot-max-guide

Russian stack

A set of simplified Python examples for assembling a personal AI secretary in the MAX messenger via the Bot API, User API and MCP

WorkflowBroad access2
Russian stack

A robust daemon and bridge plugin: talk to your Claude Code session from the MAX messenger, with photos, voice and buttons

PluginBroad access
Russian stack

MCP server for MAX messenger Bot API: messages, media, chats, participants and buttons from an agent

MCP serverExtended access12

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialRepository starsMain difference
openclaw-skill-max-bot (MAX) (this card)no0
MAX plugin for OpenClawno7another MAX plugin for OpenClaw without skill auto-install and voice transcription
Hermes MAX Gatewayno17a MAX gateway for Hermes rather than OpenClaw

README in short

The README shows the message flow architecture, automatic and manual installation, a settings reference, voice messages with Whisper model choice, finding a user identifier and troubleshooting.

README badge

Original 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

Report a problem