@aspalagin/openclaw-max 0.7.3 → 0.8.1

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "openclaw-max",
   "name": "MAX",
-  "description": "MAX messenger channel plugin (max.ru Bot API via platform-api2.max.ru, long polling or webhook)",
-  "version": "0.7.3",
+  "description": "MAX messenger (max.ru) channel for OpenClaw: private and group chats over webhook or long polling; media, voice messages with transcription and voice replies; inline keyboards and command menus; message edits and pins; several bot accounts",
+  "version": "0.8.1",
   "categories": [
     "channels"
   ],
@@ -51,6 +51,10 @@
               },
               "systemPrompt": {
                 "type": "string"
+              },
+              "disableAudioPreflight": {
+                "type": "boolean",
+                "description": "Do not transcribe a captionless voice message to look for a configured mention pattern in this group."
               }
             },
             "additionalProperties": false
@@ -68,7 +72,106 @@
                 "type": "object"
               },
               "botToken": {
-                "type": "string"
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "oneOf": [
+                      {
+                        "type": "object",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "env"
+                          },
+                          "provider": {
+                            "type": "string",
+                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "provider",
+                          "id"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "store"
+                          },
+                          "provider": {
+                            "type": "string",
+                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "provider",
+                          "id"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "file"
+                          },
+                          "provider": {
+                            "type": "string",
+                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                          },
+                          "id": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "provider",
+                          "id"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "exec"
+                          },
+                          "provider": {
+                            "type": "string",
+                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                          },
+                          "id": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "provider",
+                          "id"
+                        ],
+                        "additionalProperties": false
+                      }
+                    ]
+                  }
+                ],
+                "description": "MAX Bot API token, or a SecretRef to it ({ source: env|file|exec|store, provider, id }) resolved by the gateway before the account starts. Alternatives: tokenFile, MAX_BOT_TOKEN (default account)."
               },
               "tokenFile": {
                 "type": "string"
@@ -81,7 +184,7 @@
                   "open",
                   "disabled"
                 ],
-                "default": "pairing"
+                "description": "Who may message the bot in direct chats (default pairing). Named accounts inherit the channel-level value."
               },
               "allowFrom": {
                 "$ref": "#/definitions/allowList"
@@ -96,7 +199,7 @@
                   "open",
                   "disabled"
                 ],
-                "default": "allowlist"
+                "description": "Which group chats the bot answers in (default allowlist: only chats listed in groups). Named accounts inherit the channel-level value."
               },
               "groups": {
                 "type": "object",
@@ -104,6 +207,32 @@
                   "$ref": "#/definitions/groupConfig"
                 }
               },
+              "mentionPatterns": {
+                "type": "object",
+                "properties": {
+                  "mode": {
+                    "type": "string",
+                    "enum": [
+                      "allow",
+                      "deny"
+                    ]
+                  },
+                  "allowIn": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "denyIn": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Where core mention patterns (messages.groupChat / agent groupChat mentionPatterns) apply in MAX groups: mode allow (default) or deny, with allowIn / denyIn group chat ids."
+              },
               "transport": {
                 "type": "string",
                 "enum": [
@@ -117,8 +246,106 @@
                 "description": "Public HTTPS URL (port 443, trusted CA) MAX posts updates to; its path is served on the gateway HTTP server."
               },
               "webhookSecret": {
-                "type": "string",
-                "description": "X-Max-Bot-Api-Secret value, 5-256 of A-Z a-z 0-9 _ -. Prefer webhookSecretFile; generated and kept in the account state file when neither is set."
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "oneOf": [
+                      {
+                        "type": "object",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "env"
+                          },
+                          "provider": {
+                            "type": "string",
+                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "provider",
+                          "id"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "store"
+                          },
+                          "provider": {
+                            "type": "string",
+                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "provider",
+                          "id"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "file"
+                          },
+                          "provider": {
+                            "type": "string",
+                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                          },
+                          "id": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "provider",
+                          "id"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "exec"
+                          },
+                          "provider": {
+                            "type": "string",
+                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                          },
+                          "id": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "provider",
+                          "id"
+                        ],
+                        "additionalProperties": false
+                      }
+                    ]
+                  }
+                ],
+                "description": "X-Max-Bot-Api-Secret value, 5-256 of A-Z a-z 0-9 _ -. Prefer webhookSecretFile; generated and kept in the account state file when neither is set. Accepts a SecretRef."
               },
               "webhookSecretFile": {
                 "type": "string",
@@ -164,6 +391,156 @@
                   "block"
                 ]
               },
+              "streaming": {
+                "type": "object",
+                "properties": {
+                  "mode": {
+                    "type": "string",
+                    "enum": [
+                      "off",
+                      "partial",
+                      "block",
+                      "progress"
+                    ]
+                  },
+                  "chunkMode": {
+                    "type": "string",
+                    "enum": [
+                      "length",
+                      "newline"
+                    ]
+                  },
+                  "preview": {
+                    "type": "object",
+                    "properties": {
+                      "chunk": {
+                        "type": "object",
+                        "properties": {
+                          "minChars": {
+                            "type": "integer",
+                            "exclusiveMinimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "maxChars": {
+                            "type": "integer",
+                            "exclusiveMinimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "breakPreference": {
+                            "anyOf": [
+                              {
+                                "type": "string",
+                                "const": "paragraph"
+                              },
+                              {
+                                "type": "string",
+                                "const": "newline"
+                              },
+                              {
+                                "type": "string",
+                                "const": "sentence"
+                              }
+                            ]
+                          }
+                        },
+                        "additionalProperties": false
+                      },
+                      "toolProgress": {
+                        "type": "boolean"
+                      },
+                      "commandText": {
+                        "type": "string",
+                        "enum": [
+                          "raw",
+                          "status"
+                        ]
+                      }
+                    },
+                    "additionalProperties": false
+                  },
+                  "progress": {
+                    "type": "object",
+                    "properties": {
+                      "label": {
+                        "anyOf": [
+                          {
+                            "type": "string"
+                          },
+                          {
+                            "type": "boolean",
+                            "const": false
+                          }
+                        ]
+                      },
+                      "labels": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "maxLines": {
+                        "type": "integer",
+                        "exclusiveMinimum": 0,
+                        "maximum": 9007199254740991
+                      },
+                      "maxLineChars": {
+                        "type": "integer",
+                        "exclusiveMinimum": 0,
+                        "maximum": 9007199254740991
+                      },
+                      "toolProgress": {
+                        "type": "boolean"
+                      },
+                      "commandText": {
+                        "type": "string",
+                        "enum": [
+                          "raw",
+                          "status"
+                        ]
+                      },
+                      "commentary": {
+                        "type": "boolean"
+                      },
+                      "narration": {
+                        "type": "boolean"
+                      }
+                    },
+                    "additionalProperties": false
+                  },
+                  "block": {
+                    "type": "object",
+                    "properties": {
+                      "enabled": {
+                        "type": "boolean"
+                      },
+                      "coalesce": {
+                        "type": "object",
+                        "properties": {
+                          "minChars": {
+                            "type": "integer",
+                            "exclusiveMinimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "maxChars": {
+                            "type": "integer",
+                            "exclusiveMinimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "idleMs": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                          }
+                        },
+                        "additionalProperties": false
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Core streaming settings; streaming.mode wins over streamMode. \"progress\" shows one turn-status message edited while the agent works (streaming.progress: label, labels, toolProgress, commandText, maxLines, maxLineChars) and deleted once the answer landed; \"partial\"/\"block\" as streamMode. Default off."
+              },
               "blockStreamingCoalesce": {
                 "type": "object",
                 "properties": {
@@ -186,9 +563,171 @@
                 "type": "number",
                 "exclusiveMinimum": 0
               },
+              "webhookQueue": {
+                "type": "object",
+                "properties": {
+                  "mode": {
+                    "type": "string",
+                    "enum": [
+                      "durable",
+                      "memory"
+                    ]
+                  },
+                  "maxPending": {
+                    "type": "integer",
+                    "minimum": 1
+                  },
+                  "overflow": {
+                    "type": "string",
+                    "enum": [
+                      "reject",
+                      "drop"
+                    ]
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Webhook queue. mode \"durable\" (default): every accepted update is written to the plugin state directory before MAX gets its 200, so a gateway restart or crash does not lose it; handled updates are deleted. mode \"memory\": the 0.7 in-memory queue. maxPending (default 5000) bounds accepted but unhandled updates; when full, overflow \"reject\" (default) answers 503 so MAX redelivers later, \"drop\" acknowledges and drops."
+              },
+              "maxEventAgeMinutes": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Messages, edits, button presses and bot_started older than this many minutes (by MAX event time) are skipped instead of answered, so after a long outage the bot does not reply to hours-old messages (webhook, the queue recovered after a restart and long polling). Default 60; 0 answers any age."
+              },
+              "logMessagePreview": {
+                "type": "boolean",
+                "description": "Debug logs of inbound messages include a 50-character text preview, for debugging. Off by default: logs carry the message type, text length and ids, never message text, captions or transcripts."
+              },
+              "mediaMaxCount": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Most media attachments (images, stickers, video, audio, files) downloaded per inbound message (default 12), forwarded ones included; the agent gets a note about the rest. Size is limited separately by mediaMaxMb. Named accounts inherit the channel-level value."
+              },
               "markSeen": {
                 "type": "boolean"
               },
+              "actionScope": {
+                "type": "string",
+                "enum": [
+                  "admitted",
+                  "current",
+                  "off"
+                ],
+                "description": "Chats message-tool actions (send, sendAttachment, sticker, edit, delete, pin, unpin) may act in. admitted (default): the current chat, owner requests and chats admitted by dmPolicy/allowFrom/pairing and groupPolicy/groups; current: non-owner turns only in their own chat; off: no plugin check. Named accounts inherit the channel-level value."
+              },
+              "notify": {
+                "type": "boolean",
+                "description": "Default push notification for sent messages (MAX notify, default true). false sends silently; an explicit value of the call (core silent flag, channelData.max.notify) wins. MAX channels always notify. Named accounts inherit the channel-level value."
+              },
+              "disableLinkPreview": {
+                "type": "boolean",
+                "description": "Default: send messages without link previews (MAX disable_link_preview). Unset: previews on, except tool summaries (verbose mode), which go without them; a set value applies to all sends. channelData.max.disableLinkPreview overrides it per message. Named accounts inherit the channel-level value."
+              },
+              "apiBaseUrl": {
+                "type": "string",
+                "description": "MAX Bot API base URL (default https://platform-api2.max.ru), e.g. a test stand; a path prefix is kept. https only; http is accepted just for loopback hosts, so the bot token never travels unencrypted. A bad value stops the account at start with an error. Named accounts inherit the channel-level value."
+              },
+              "httpProxy": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "oneOf": [
+                      {
+                        "type": "object",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "env"
+                          },
+                          "provider": {
+                            "type": "string",
+                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "provider",
+                          "id"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "store"
+                          },
+                          "provider": {
+                            "type": "string",
+                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "provider",
+                          "id"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "file"
+                          },
+                          "provider": {
+                            "type": "string",
+                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                          },
+                          "id": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "provider",
+                          "id"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "exec"
+                          },
+                          "provider": {
+                            "type": "string",
+                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                          },
+                          "id": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "provider",
+                          "id"
+                        ],
+                        "additionalProperties": false
+                      }
+                    ]
+                  }
+                ],
+                "description": "HTTP(S) proxy for all outbound MAX traffic of the account: Bot API calls, file uploads and media downloads, e.g. http://user:pass@proxy.example:3128. MAX TLS (Russian Trusted CA included) is verified inside the tunnel; loopback targets bypass the proxy. Credentials are never logged. Named accounts inherit the channel-level value; \"\" turns an inherited proxy off. Accepts a SecretRef (e.g. when the URL carries credentials)."
+              },
               "actions": {
                 "type": "object",
                 "additionalProperties": {
@@ -249,8 +788,444 @@
           }
         }
       },
+      "uiHints": {
+        "name": {
+          "label": "Account name",
+          "help": "Display name of the account. Own: not inherited by named accounts."
+        },
+        "enabled": {
+          "label": "Enabled",
+          "help": "false at channel level disables all accounts; in an account, disables that account."
+        },
+        "markdown": {
+          "label": "Markdown (no effect)",
+          "help": "Accepted for compatibility with the common channel config; has no effect in MAX.",
+          "advanced": true
+        },
+        "botToken": {
+          "label": "Bot token",
+          "help": "MAX Bot API token or a SecretRef to it. Own.",
+          "sensitive": true
+        },
+        "tokenFile": {
+          "label": "Token file",
+          "help": "Absolute path to a regular file with the bot token. Own.",
+          "placeholder": "/path/to/max-bot-token",
+          "advanced": true
+        },
+        "dmPolicy": {
+          "label": "DM policy",
+          "help": "Who may write in private dialogs: pairing (default), allowlist, open or disabled."
+        },
+        "allowFrom": {
+          "label": "Allowed DM senders",
+          "help": "MAX user ids allowed in private dialogs; \"*\" allows anyone (required with open)."
+        },
+        "groupAllowFrom": {
+          "label": "Allowed group senders",
+          "help": "User ids allowed in admitted groups when the group has no own allowFrom."
+        },
+        "groupPolicy": {
+          "label": "Group policy",
+          "help": "Which groups the bot answers in: allowlist (default), open or disabled."
+        },
+        "groups": {
+          "label": "Groups",
+          "help": "Allowed groups and per-group settings, keyed by chat id or \"*\"."
+        },
+        "mentionPatterns": {
+          "label": "Mention pattern scope",
+          "help": "Where core mention patterns apply in MAX groups: mode allow|deny, allowIn, denyIn.",
+          "advanced": true
+        },
+        "transport": {
+          "label": "Transport",
+          "help": "polling or webhook; default webhook when webhookUrl is set, else polling. Own."
+        },
+        "webhookUrl": {
+          "label": "Webhook URL",
+          "help": "Public HTTPS URL MAX posts updates to. Own.",
+          "placeholder": "https://bot.example.com/max/webhook"
+        },
+        "webhookSecret": {
+          "label": "Webhook secret",
+          "help": "Secret MAX sends with every webhook call; generated when unset. Plain value or SecretRef. Own.",
+          "sensitive": true,
+          "advanced": true
+        },
+        "webhookSecretFile": {
+          "label": "Webhook secret file",
+          "help": "File with the webhook secret (regular file, not a symlink). Own.",
+          "advanced": true
+        },
+        "webhookPath": {
+          "label": "Webhook path",
+          "help": "Gateway route path; default: the path of webhookUrl, else /max/webhook. Own.",
+          "placeholder": "/max/webhook",
+          "advanced": true
+        },
+        "historyLimit": {
+          "label": "Group history limit",
+          "help": "Read by OpenClaw core: recent turns of a group session the embedded agent runtime keeps in the prompt.",
+          "advanced": true
+        },
+        "dmHistoryLimit": {
+          "label": "DM history limit",
+          "help": "Read by OpenClaw core: recent turns of a private-dialog session kept in the prompt.",
+          "advanced": true
+        },
+        "dms": {
+          "label": "Per-user DM settings",
+          "help": "dms.<userId>.historyLimit, read by OpenClaw core before dmHistoryLimit.",
+          "advanced": true
+        },
+        "textChunkLimit": {
+          "label": "Text chunk limit",
+          "help": "Characters per outgoing message; values above MAX's 4000 (the default) are capped.",
+          "advanced": true
+        },
+        "blockStreaming": {
+          "label": "Block streaming (no effect)",
+          "help": "Accepted for compatibility; has no effect in MAX. Use streamMode or streaming.mode \"block\".",
+          "advanced": true
+        },
+        "streamMode": {
+          "label": "Stream mode",
+          "help": "off (default); partial: one draft edited while the answer streams; block: core block replies."
+        },
+        "streaming": {
+          "label": "Streaming",
+          "help": "Core streaming config; streaming.mode (off, partial, block, progress) wins over streamMode; streaming.progress configures turn status.",
+          "advanced": true
+        },
+        "blockStreamingCoalesce": {
+          "label": "Block streaming coalesce (no effect)",
+          "help": "Accepted for compatibility; has no effect in MAX. Core reads streaming.block.coalesce.",
+          "advanced": true
+        },
+        "responsePrefix": {
+          "label": "Response prefix",
+          "help": "Prefix of agent replies, applied by OpenClaw core (\"auto\": agent name).",
+          "advanced": true
+        },
+        "mediaMaxMb": {
+          "label": "Media size limit, MB",
+          "help": "Size limit for downloaded and uploaded media (default 20)."
+        },
+        "webhookQueue": {
+          "label": "Webhook queue",
+          "help": "mode durable (default) or memory, maxPending (5000), overflow reject (default) or drop.",
+          "advanced": true
+        },
+        "maxEventAgeMinutes": {
+          "label": "Max event age, minutes",
+          "help": "Skip messages, edits, button presses and bot starts older than this (default 60); 0: no limit.",
+          "advanced": true
+        },
+        "logMessagePreview": {
+          "label": "Log message preview",
+          "help": "Add a 50-character text preview to debug logs (default false).",
+          "advanced": true
+        },
+        "mediaMaxCount": {
+          "label": "Media per message",
+          "help": "Media attachments downloaded per incoming message, forwards included (default 12).",
+          "advanced": true
+        },
+        "markSeen": {
+          "label": "Mark as read",
+          "help": "Mark incoming messages as read (default true)."
+        },
+        "actionScope": {
+          "label": "Action scope",
+          "help": "Chats the message tool may act in: admitted (default), current or off.",
+          "advanced": true
+        },
+        "notify": {
+          "label": "Notify",
+          "help": "Push notifications for sends; false: silent (not possible in channels)."
+        },
+        "disableLinkPreview": {
+          "label": "Disable link previews",
+          "help": "Send messages without link previews."
+        },
+        "apiBaseUrl": {
+          "label": "API base URL",
+          "help": "Bot API base URL; https only, http just for loopback.",
+          "placeholder": "https://platform-api2.max.ru",
+          "advanced": true
+        },
+        "httpProxy": {
+          "label": "HTTP proxy",
+          "help": "HTTP(S) proxy for all MAX traffic; \"\" in an account turns an inherited proxy off. Plain value or SecretRef.",
+          "placeholder": "http://user:pass@proxy.example:3128",
+          "sensitive": true,
+          "advanced": true
+        },
+        "actions": {
+          "label": "Message tool actions",
+          "help": "false turns an action off: send, edit, delete, sticker, sendAttachment, pin, unpin.",
+          "advanced": true
+        },
+        "groups.*.requireMention": {
+          "label": "Require mention",
+          "help": "Answer only when the bot is mentioned, replied to or its button is pressed (default true)."
+        },
+        "groups.*.tools": {
+          "label": "Tool policy",
+          "help": "Core tool policy for this group.",
+          "advanced": true
+        },
+        "groups.*.skills": {
+          "label": "Skills",
+          "help": "Skills a turn in this group may load; [] for none.",
+          "advanced": true
+        },
+        "groups.*.enabled": {
+          "label": "Enabled",
+          "help": "false: ignore this group under any groupPolicy."
+        },
+        "groups.*.allowFrom": {
+          "label": "Allowed senders",
+          "help": "Senders allowed in this group (overrides groupAllowFrom)."
+        },
+        "groups.*.systemPrompt": {
+          "label": "System prompt",
+          "help": "Extra system prompt for turns in this group.",
+          "advanced": true
+        },
+        "groups.*.disableAudioPreflight": {
+          "label": "Disable audio preflight",
+          "help": "Do not transcribe captionless voice messages to look for a mention (default false).",
+          "advanced": true
+        },
+        "accounts": {
+          "label": "Accounts",
+          "help": "Named bot accounts; each inherits channel-level options except its own token, name and webhook."
+        },
+        "commands": {
+          "label": "Bot commands",
+          "help": "Commands registered in MAX (up to 32; name up to 64 characters without /, description up to 128).",
+          "advanced": true
+        },
+        "defaultAccount": {
+          "label": "Default account",
+          "help": "Accepted by the schema; the plugin always treats channel-level options as the \"default\" account.",
+          "advanced": true
+        },
+        "accounts.*.name": {
+          "label": "Account name",
+          "help": "Display name of the account. Own: not inherited by named accounts."
+        },
+        "accounts.*.enabled": {
+          "label": "Enabled",
+          "help": "false disables this account; a channel switched off switches off every account."
+        },
+        "accounts.*.markdown": {
+          "label": "Markdown (no effect)",
+          "help": "Accepted for compatibility with the common channel config; has no effect in MAX.",
+          "advanced": true
+        },
+        "accounts.*.botToken": {
+          "label": "Bot token",
+          "help": "MAX Bot API token or a SecretRef to it. Own.",
+          "sensitive": true
+        },
+        "accounts.*.tokenFile": {
+          "label": "Token file",
+          "help": "Absolute path to a regular file with the bot token. Own.",
+          "placeholder": "/path/to/max-bot-token",
+          "advanced": true
+        },
+        "accounts.*.dmPolicy": {
+          "label": "DM policy",
+          "help": "Who may write in private dialogs: pairing (default), allowlist, open or disabled."
+        },
+        "accounts.*.allowFrom": {
+          "label": "Allowed DM senders",
+          "help": "MAX user ids allowed in private dialogs; \"*\" allows anyone (required with open)."
+        },
+        "accounts.*.groupAllowFrom": {
+          "label": "Allowed group senders",
+          "help": "User ids allowed in admitted groups when the group has no own allowFrom."
+        },
+        "accounts.*.groupPolicy": {
+          "label": "Group policy",
+          "help": "Which groups the bot answers in: allowlist (default), open or disabled."
+        },
+        "accounts.*.groups": {
+          "label": "Groups",
+          "help": "Allowed groups and per-group settings, keyed by chat id or \"*\"."
+        },
+        "accounts.*.mentionPatterns": {
+          "label": "Mention pattern scope",
+          "help": "Where core mention patterns apply in MAX groups: mode allow|deny, allowIn, denyIn.",
+          "advanced": true
+        },
+        "accounts.*.transport": {
+          "label": "Transport",
+          "help": "polling or webhook; default webhook when webhookUrl is set, else polling. Own."
+        },
+        "accounts.*.webhookUrl": {
+          "label": "Webhook URL",
+          "help": "Public HTTPS URL MAX posts updates to. Own.",
+          "placeholder": "https://bot.example.com/max/webhook"
+        },
+        "accounts.*.webhookSecret": {
+          "label": "Webhook secret",
+          "help": "Secret MAX sends with every webhook call; generated when unset. Plain value or SecretRef. Own.",
+          "sensitive": true,
+          "advanced": true
+        },
+        "accounts.*.webhookSecretFile": {
+          "label": "Webhook secret file",
+          "help": "File with the webhook secret (regular file, not a symlink). Own.",
+          "advanced": true
+        },
+        "accounts.*.webhookPath": {
+          "label": "Webhook path",
+          "help": "Gateway route path; default: the path of webhookUrl, else /max/webhook. Own.",
+          "placeholder": "/max/webhook",
+          "advanced": true
+        },
+        "accounts.*.historyLimit": {
+          "label": "Group history limit",
+          "help": "Read by OpenClaw core: recent turns of a group session the embedded agent runtime keeps in the prompt.",
+          "advanced": true
+        },
+        "accounts.*.dmHistoryLimit": {
+          "label": "DM history limit",
+          "help": "Read by OpenClaw core: recent turns of a private-dialog session kept in the prompt.",
+          "advanced": true
+        },
+        "accounts.*.dms": {
+          "label": "Per-user DM settings",
+          "help": "dms.<userId>.historyLimit, read by OpenClaw core before dmHistoryLimit.",
+          "advanced": true
+        },
+        "accounts.*.textChunkLimit": {
+          "label": "Text chunk limit",
+          "help": "Characters per outgoing message; values above MAX's 4000 (the default) are capped.",
+          "advanced": true
+        },
+        "accounts.*.blockStreaming": {
+          "label": "Block streaming (no effect)",
+          "help": "Accepted for compatibility; has no effect in MAX. Use streamMode or streaming.mode \"block\".",
+          "advanced": true
+        },
+        "accounts.*.streamMode": {
+          "label": "Stream mode",
+          "help": "off (default); partial: one draft edited while the answer streams; block: core block replies."
+        },
+        "accounts.*.streaming": {
+          "label": "Streaming",
+          "help": "Core streaming config; streaming.mode (off, partial, block, progress) wins over streamMode; streaming.progress configures turn status.",
+          "advanced": true
+        },
+        "accounts.*.blockStreamingCoalesce": {
+          "label": "Block streaming coalesce (no effect)",
+          "help": "Accepted for compatibility; has no effect in MAX. Core reads streaming.block.coalesce.",
+          "advanced": true
+        },
+        "accounts.*.responsePrefix": {
+          "label": "Response prefix",
+          "help": "Prefix of agent replies, applied by OpenClaw core (\"auto\": agent name).",
+          "advanced": true
+        },
+        "accounts.*.mediaMaxMb": {
+          "label": "Media size limit, MB",
+          "help": "Size limit for downloaded and uploaded media (default 20)."
+        },
+        "accounts.*.webhookQueue": {
+          "label": "Webhook queue",
+          "help": "mode durable (default) or memory, maxPending (5000), overflow reject (default) or drop.",
+          "advanced": true
+        },
+        "accounts.*.maxEventAgeMinutes": {
+          "label": "Max event age, minutes",
+          "help": "Skip messages, edits, button presses and bot starts older than this (default 60); 0: no limit.",
+          "advanced": true
+        },
+        "accounts.*.logMessagePreview": {
+          "label": "Log message preview",
+          "help": "Add a 50-character text preview to debug logs (default false).",
+          "advanced": true
+        },
+        "accounts.*.mediaMaxCount": {
+          "label": "Media per message",
+          "help": "Media attachments downloaded per incoming message, forwards included (default 12).",
+          "advanced": true
+        },
+        "accounts.*.markSeen": {
+          "label": "Mark as read",
+          "help": "Mark incoming messages as read (default true)."
+        },
+        "accounts.*.actionScope": {
+          "label": "Action scope",
+          "help": "Chats the message tool may act in: admitted (default), current or off.",
+          "advanced": true
+        },
+        "accounts.*.notify": {
+          "label": "Notify",
+          "help": "Push notifications for sends; false: silent (not possible in channels)."
+        },
+        "accounts.*.disableLinkPreview": {
+          "label": "Disable link previews",
+          "help": "Send messages without link previews."
+        },
+        "accounts.*.apiBaseUrl": {
+          "label": "API base URL",
+          "help": "Bot API base URL; https only, http just for loopback.",
+          "placeholder": "https://platform-api2.max.ru",
+          "advanced": true
+        },
+        "accounts.*.httpProxy": {
+          "label": "HTTP proxy",
+          "help": "HTTP(S) proxy for all MAX traffic; \"\" in an account turns an inherited proxy off. Plain value or SecretRef.",
+          "placeholder": "http://user:pass@proxy.example:3128",
+          "sensitive": true,
+          "advanced": true
+        },
+        "accounts.*.actions": {
+          "label": "Message tool actions",
+          "help": "false turns an action off: send, edit, delete, sticker, sendAttachment, pin, unpin.",
+          "advanced": true
+        },
+        "accounts.*.groups.*.requireMention": {
+          "label": "Require mention",
+          "help": "Answer only when the bot is mentioned, replied to or its button is pressed (default true)."
+        },
+        "accounts.*.groups.*.tools": {
+          "label": "Tool policy",
+          "help": "Core tool policy for this group.",
+          "advanced": true
+        },
+        "accounts.*.groups.*.skills": {
+          "label": "Skills",
+          "help": "Skills a turn in this group may load; [] for none.",
+          "advanced": true
+        },
+        "accounts.*.groups.*.enabled": {
+          "label": "Enabled",
+          "help": "false: ignore this group under any groupPolicy."
+        },
+        "accounts.*.groups.*.allowFrom": {
+          "label": "Allowed senders",
+          "help": "Senders allowed in this group (overrides groupAllowFrom)."
+        },
+        "accounts.*.groups.*.systemPrompt": {
+          "label": "System prompt",
+          "help": "Extra system prompt for turns in this group.",
+          "advanced": true
+        },
+        "accounts.*.groups.*.disableAudioPreflight": {
+          "label": "Disable audio preflight",
+          "help": "Do not transcribe captionless voice messages to look for a mention (default false).",
+          "advanced": true
+        }
+      },
       "label": "MAX",
-      "description": "MAX messenger channel (max.ru Bot API)."
+      "description": "MAX messenger channel (max.ru Bot API): private and group chats over webhook or long polling."
     }
   },
   "configSchema": {