SkillFoxx

MAX plugin for OpenClaw

openclaw-max-plus

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

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

Extended access

Why this level

  • Sends and edits messages as the bot in real MAX chats
  • Stores the bot token and, in webhook mode, accepts incoming requests on a public address
All reasons and checks
Russian stack

missial/openclaw-max-plusAuthor:Petr Alexeev

Install

Manual install

npm install && npm run build

Build the plugin before connecting it.

Access and checks

How we review

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

  • Sends and edits messages as the bot in real MAX chats
  • Stores the bot token and, in webhook mode, accepts incoming requests on a public address

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

What it does

The plugin adds MAX as an OpenClaw channel alongside Telegram: receiving and sending markdown text, attachments (photos, videos, files, stickers, contacts, locations, including inline base64 for generated images), long captions split automatically into follow-up messages, several inline-button types, reply, forward with attribution, edit, delete, and admin-only pin/unpin in groups, response streaming with a typing indicator, long polling and webhook with secret validation, multiple accounts, and access policies for direct messages and groups. Since version 0.6.3 the plugin can register the bot's command menu via PATCH /me/commands, either automatically or manually with Russian descriptions. Recognizing voice messages from the mobile MAX app requires a webhook rather than long polling, otherwise the audio arrives empty.

Who it is for. For people already using OpenClaw who want to give their assistant a MAX channel just like Telegram.

Good fit when

  • You have a verified MAX bot via business.max.ru and want to connect it to OpenClaw
  • You need voice messages from users: then a webhook with a recognition engine must be configured
  • You need several MAX bots at once, for example a work one and a personal one

Not a fit when

  • You do not use OpenClaw: the plugin only works inside that framework
  • You are not a legal entity, sole proprietor or self-employed Russian resident: creating a MAX bot via business.max.ru requires verification
  • You need reactions or polls: the MAX Bot API does not support them, a platform limitation

Example request

Set up the MAX channel in OpenClaw with a webhook for voice-message recognition

Limitations

Requires OpenClaw 2026.9.3 or newer and Node.js 24.16+ or 26.1+. Creating a bot requires a verified legal entity, sole proprietor or self-employed Russian resident and up to 48 hours of MAX moderation. Long polling does not deliver native voice messages from the mobile app; a webhook with a configured audio recognition engine is required for those. The MAX Bot API does not support reactions or polls.

How to disable. Set channels.max.enabled to false in ~/.openclaw/openclaw.json, or remove the plugin with openclaw plugins remove openclaw-max-plus and restart the gateway.

FAQ

Why aren't voice messages recognized?

With long polling, native voice messages from mobile MAX arrive without audio; you need a webhook with a public HTTPS address and a recognition engine like Whisper.

Can I connect several MAX bots?

Yes, via the accounts section in the channel config, each account can have its own access policy.

Discussion

No questions or reviews yet.

All MAX messenger tools
Russian stack

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

PluginExtended access7

openclaw-skill-max-bot (MAX)

openclaw-skill-max-bot

Russian stack

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

SkillExtended access

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
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

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

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

MCP serverExtended access12

README in short

The README gives a detailed agent runbook: building the plugin, connecting it to OpenClaw, configuring the channel with a token and access policy, the required typing-indicator interval setting, restarting the gateway, and finding your user_id. It separately covers registering the command menu via PATCH /me/commands, a full channel config field table, multiple accounts, and a quick MAX Bot API reference noting the deprecation of the platform-api.max.ru domain.

README badge

Report a problem