MensajeríaMAX

Seguridad y privacidad de la CLI de MAX

Consulta los permisos, las credenciales, el almacenamiento local y las confirmaciones de la CLI de MAX.

Elige lo que puede hacer tu agente y conoce dónde se guardan los datos de acceso y mensajes. Aquí se explican las protecciones, sus límites y los ajustes que puedes comprobar antes de permitir envíos u otros cambios.

Lea esta página antes de darle acceso a un agente o script de IA a su cuenta MAX a través de max, o cuando quiera saber qué almacena max en su computadora. Ella explica dónde se almacena la entrada, qué escribe max en el disco, con qué servidores contacta, qué detiene el envío no deseado y qué hacer si se filtra el token. Después de leerlo, podrás evaluar lo que puede hacer alguien con acceso a esta computadora, o un agente con acceso a max.

Palabras que aparecen en la página:

  • Token es una cadena que te mantiene en tu cuenta MAX. Quien la tiene usa la cuenta.
  • Archivo local compartida: una base de datos en su computadora donde max y tg almacenan los mensajes leídos. Es común a ambas herramientas y no está cifrado.
  • Protección contra envío: verifica que cada cambio se realice antes de ingresar a MAX: derechos, lista de destinatarios permitidos y límite de envío por hora.

Lo común a max y tg (el archivo local de las conversaciones, la protección de envíos, los permisos del agente, el texto ajeno en pantalla, lo que ven otros en el comando y cómo informar de una vulnerabilidad) se describe en la página común de seguridad. Aquí está lo que afecta solo a MAX.

Resumen: qué protege

Lo que protege cualquier herramienta de WireCat está en la página común. Particularidades de MAX:

  • El servidor en segundo plano también aplica los límites del perfil. Los permisos, los destinatarios y el límite por hora se comprueban en el comando y en max personal serve, incluso para programas que conectan directamente a su socket (abajo).
  • Token. max no guarda un token de MAX_TOKEN ni lo pasa al servidor. El servidor no entrega tokens a los clientes del socket (abajo).
  • Red. Los archivos se descargan por HTTP(S) mediante el transporte de red normal, incluida la red local, dentro del límite de tamaño configurado. Los frames MAX y los datos descomprimidos tienen límites; las conexiones tienen tiempos de espera (abajo).
  • Cuenta. max no es una aplicación oficial, y las condiciones de MAX no permiten este tipo de programas sin consentimiento de la empresa (abajo).

Dónde se guarda el token

En el almacén de claves del sistema, servicio max-cli, entrada con nombre del perfil. No se guarda en configuración, argumentos, variables de shell ni historial.

Si no hay almacén, se guarda en ~/.config/max-cli/credentials.json con 0600 y se avisa por stderr. max personal doctor también indica que procede de archivo.

MAX_TOKEN tiene prioridad sobre el almacén, para CI. El token de la variable permanece solo en ella:

  • Si MAX renueva el token, max no lo guarda en almacén ni archivo; avisa por stderr. Así no queda un token activo en archivos de compilación que puedan acabar en cachés o artefactos.
  • Con MAX_TOKEN no inicia max personal serve ni le transmite la variable; evita que un token de un comando siga activo quince minutos en segundo plano.

El token de max sales bot está separado en el servicio max-cli, entrada bot:<профиль>; sin almacén, en el mismo archivo con 0600. MAX_BOT_TOKEN tiene prioridad, igual que MAX_TOKEN. max sales bot auth set valida a qué bot pertenece antes de guardar, para no sustituir un token válido por una errata. Nunca guarda el de MAX_BOT_TOKEN.

La configuración no admite secretos: no hay campos para token, teléfono ni identificador de chat.

Otros datos en disco

ContenidoUbicaciónPermisos
estado del perfil: dispositivo, accesos y viewerId~/.local/share/max-cli/profiles/<профиль>.json0600
configuración~/.config/max-cli/config.jsoncarpeta 0700, archivo 0600; doctor nombra los abiertos
registros de ejecución, de cada ejecución: las correctas 7 días, las fallidas 30 (record false deja solo las fallidas): palabras del comando, identificadores, tiempos y código de error; la línea de comandos tal como la escribiste, sin secretos (record_input false oculta lo escrito, diagnóstico)~/.local/share/max-cli/runs/…carpeta 0700, archivos 0600
registro de envíos, siempre: chat, hora, identificador, longitud y resultado, sin texto~/.local/share/max-cli/sends/<профиль>.jsonlcarpeta 0700, archivos 0600
destinatarios permitidos, si está activo~/.local/share/max-cli/profiles/<профиль>.recipients.json0600
reglas de moderación tras el primer chats rules set~/.local/share/max-cli/profiles/<профиль>.moderation.json0600
bot: chats vistos, envíos, destinatarios y punto de watch~/.local/share/max-cli/bots/…carpeta 0700, archivos 0600
copia compartida de mensajes de cuenta personal, bot y tg, con textos, transcripciones, rutas de adjuntos descargados y su texto extraído~/.local/share/WireCat/wirecat.dbcarpeta 0700, archivo 0600
socket y registro de max personal serve~/.local/share/max-cli/profiles/<профиль>.sock, .serve.log0600
copia anterior del perfil; ya no se abre~/.cache/max-cli/<профиль>.db y sus -wal, -shmcarpeta 0700, archivos 0600
exportación, solo max personal store export --outputdestino indicado0600
archivos descargados, max personal messages download o max personal attachments extract --download --output-dircarpeta actual o --output0600
informe, solo max personal doctor reports createcarpeta actual o --output0600
modelos de voz, solo tras max personal models download~/.local/share/WireCat/models/audio/…carpeta 0700, archivos 0600

⚠ La copia compartida contiene texto de mensajes y transcripciones de voz: sirve para responder sin red. max personal session end no la elimina. max personal store clear --left --allow-dangerous solo borra datos de chats abandonados; no hay una orden que elimine toda la copia compartida.

Los archivos antiguos de caché del perfil ya no se abren. Si quedan, max personal doctor muestra su ruta; puedes borrarlos aparte sin afectar a la copia compartida.

También hay contenido de conversaciones en la copia del bot, exportaciones y descargas; la lista de chats del bot contiene títulos. El resto no contiene conversaciones.

Si el comando cae en otras manos

Frente a quien extrae el disco solo protege el cifrado completo del disco: consulta la página común. En Windows, el acceso a los archivos depende de los permisos del directorio del usuario y de los directorios MAX_*_DIR elegidos; los permisos numéricos de la tabla corresponden a Unix.

Protección de envíos

Por qué hace falta la protección de envíos y cómo funciona se explica en la página común. Antes de cada escritura (mensajes, reacciones, ediciones, reenvíos, eliminaciones), max comprueba todo lo que figura en la tabla de abajo y después escribe una línea en el registro.

En los ejemplos de abajo, agent es el nombre de un perfil que creaste aparte para el agente; pon el tuyo.

ComprobaciónCómo activarDenegación
prohibir escrituras en mensajes salvo autorizaciones más específicasmax agent config set permissions.messages readonly; limita otros recursos por separadocódigo 5, sin conexión
permitir envíos y prohibir otras escrituras en mensajesprimero max agent config set permissions.messages readonly y después max agent config set permissions.messages.send allow; conserva otros recursos y reglas más específicascódigo 5 para acciones prohibidas, sin conexión
destinatarios permitidosmax <профиль> recipients add <чат>; desactivar con recipients clearcódigo 7
máximo por hora: mensajes, reenvíos, ediciones, fijados con aviso, eliminados y personas añadidas; no reaccionessends_per_hour, predeterminado 30código 8, indica cuándo reintentar
prohibir cualquier escritura en todo el proceso, permitan lo que permitan los niveles y las opcionesMAX_READ_ONLY=1 en el entornocódigo 5, sin conexión
registro de cada intento, sin textosiempre; max personal sends list—

La prohibición por nivel o por MAX_READ_ONLY actúa antes de conectarse a MAX. El chat no se busca, así que la línea de la negativa en el registro es más corta: la clave del comando (messages.send) y el tipo de escritura, y el chat solo si el comando indica su id numérico. --dry-run con MAX_READ_ONLY da la misma negativa y no escribe en el registro.

Los bots tienen claves propias bot.*, como bot.messages.send. Usan los mismos niveles. Los ajustes comunes y las capas bot.defaults/bot.profiles se resuelven en el mismo orden; config show --bot muestra los permisos efectivos.

Cada bot tiene destinatarios (max <имя> bot recipients add <чат>) y registro (max <имя> bot sends list) propios. Toda escritura pasa por ellos, incluidos messages send, messages pin y bot api, para evitar eludir controles con API genérica. Edición y eliminación reciben primero el chat; max consulta el mensaje y rechaza si pertenece a otro. No hace esa comprobación para user:<id>. Registra chat, tipo, resultado y longitud, nunca texto. No hay límite por hora de bots hasta definirlo en bot: max <имя> config set --bot sends_per_hour 200.

El servidor en segundo plano max personal serve realiza las mismas comprobaciones para todo lo que pasa por él, incluidas las solicitudes de programas conectados directamente a su socket en lugar de mediante max. Solo acepta solicitudes que conoce max, con la forma en que las envía max; por ejemplo, rechaza eliminar un chat completo. Los cambios mediante config set se aplican de inmediato sin reiniciar el servidor.

Contactos, perfil, carpetas y sesiones también respetan solo lectura. No usan destinatarios ni límite por hora porque no envían a chats. Se registran como account y acción, sin nombres, teléfonos ni títulos.

La lista es opcional: sin destinatarios añadidos, cualquier chat; activa pero vacía significa ninguno. Si está activa, chats create <название> <люди…> y chats members add solo admiten personas cuyo chat individual esté permitido. Un nuevo miembro no ve mensajes anteriores salvo con --history. Un mensaje programado cuenta en la hora del envío. Dos comandos simultáneos no superan juntos el límite: se reserva desde la comprobación hasta la respuesta. Eliminar datos de chats abandonados no modifica el registro de envíos.

⚠ Limitaciones de los controles. Están dentro de max: un agente con shell puede quitarlos por sí mismo. Qué límite poner desde fuera se explica en la página común. Para max: MAX_PROFILE_LOCK fija el perfil, MAX_PROFILE no; --file y bot uploads put rechazan archivos y carpetas conocidos de credenciales, los directorios de max y el almacén de mensajes mientras no se indique --allow-any-file. Se permiten las carpetas de trabajo ocultas normales; MCP no permite eludir esta protección.

Qué no hace la herramienta

  • No marca como leído sin preguntar. “Obtener historial” y “marcar como leído” son operaciones de protocolo diferentes. El segundo lo envían únicamente max personal chats mark-read; leerlo no lo envía.
  • No envía cambios sin que se soliciten. Las operaciones que cambian el estado remoto son messages send|edit|delete|forward|pin|unpin|press, reactions add|remove, polls vote|close|create, contacts add|remove|import|rename|block|unblock, account update, account sessions end, session end, chats join|leave|create|update|start|app, chats members|admins …, chats requests confirm|reject, chats links reset, chats folders create|update|delete|order, chats moderate (dentro de las reglas del grupo) y chats mark-read. Cada una realiza la acción indicada. max commands --json las identifica mediante effects.remote: "write".
  • La eliminación por defecto requiere confirmación. El nivel ask para messages.delete requiere una respuesta en el terminal o --allow-dangerous; explícito allow realiza la eliminación sin lugar a dudas. Para eliminar a todos también necesitas --for-everyone; La herramienta MCP general no lo permite.
  • No toma el número de teléfono de la línea de comando. contacts lookup lo solicita o lo lee desde la tubería, contacts import - desde el archivo: la línea de comando es vista por ps y el historial del shell. No hay ningún número en los errores, el registro de envío y los registros de inicio, y max personal session start y max personal account show lo muestran oculto.
  • No escribe mensajes en el registro. Ni en forma recortada ni en hash - consulte diagnóstico. Excepción: el texto que tú mismo escribiste en la línea de comandos puede quedar en el argv del registro de ejecución mientras record_input no esté desactivado (lo que escribiste).
  • No pasa por intermediarios. Donde se conecta exactamente el max es en el apartado “Qué entra a la red”. max no tiene telemetría propia; max personal serve envía MAX un evento de servicio, como una pestaña oculta de la versión web; consulte en el mismo lugar.
  • Mantiene la conexión sólo en max personal serve. Se inicia en segundo plano con el primer comando que necesita MAX; se detiene solo después de 15 minutos sin nada que hacer. No ejecutar - max personal config set serve false.

Texto ajeno en pantalla

Los nombres, títulos y textos de otras personas no controlan la terminal: los caracteres de control e invisibles aparecen como texto, los nombres se imprimen en una línea y el autocompletado solo introduce números. Más detalles en la página común.

Qué ven otros procesos

El token no se pasa como argumento, pero el texto de un mensaje sí, y se ve en ps y en el historial de la shell (página común). Los archivos de estado y el socket del servidor en segundo plano están protegidos con permisos 0600 y carpetas 0700. config set escribe config.json con permisos 0600; un archivo de una versión anterior puede seguir con 0644 hasta que se reescriba, y max doctor nombra ese archivo y el comando chmod que lo corrige. Al mover archivos o redirigir la salida, comprueba los permisos por separado.

Qué sale por la red

DestinoCuándo
wss://api.oneme.ru/websocket, cabecera Origin: https://web.max.rucomandos que necesitan MAX
servidores de archivos de MAX, dirección indicada por MAXmessages send --file, messages download
https://web.max.ru en perfil Chromium temporalsession start qr-chrome, session start sms, `setup --method qr-chrome
Hugging Face y GitHub para modelos de vozsolo max personal models download; la voz se procesa localmente
Hugging Face, archivos del modelo de textoSolo max personal models download; el modelo local no envía mensajes
Servicio externo de vectores configuradoconversations embed envía texto de conversaciones tras el consentimiento; search conversations, incluido MCP, envía la pregunta al seleccionar un servicio externo
Servicio compatible con OpenAI o Anthropic configuradoconversations links rebuild --analyze --chat envía lotes limitados tras el consentimiento para la cuenta, el chat y el servicio
https://platform-api2.max.ru, Bot API oficial, token en Authorizationsolo max sales bot
registro npm para comprobar versionesmax upgrade y una vez al día desde terminal; se desactiva con update_check: false

max personal messages download usa HTTP(S) y redirecciones normales sin comprobar las direcciones DNS. El comando no prohíbe VPN, proxies ni direcciones locales. Límite de archivos: 4 GiB; voz para transcripción: 32 MiB.

Las solicitudes de max sales bot se identifican como max-cli/<версия>: MAX ya conoce al bot por su token. El certificado de platform-api2.max.ru está firmado por una raíz del Ministerio de Desarrollo Digital ausente en Node. En Node, max la añade a los certificados de confianza de todo el proceso: desde la primera solicitud del bot, todas las conexiones TLS de esa ejecución de max confían en ella, no solo las de Bot API. En Bun se añade únicamente para las solicitudes de Bot API. El sistema no cambia.

Para las cuentas personales, las solicitudes de red no contienen el nombre de esta herramienta ni un user-agent propio: el user-agent y la descripción del dispositivo proceden del cliente web de MAX. Las tramas también usan la dirección, el formato binario y la compresión del cliente web. max personal serve reproduce la telemetría del cliente web tal como la envía una pestaña oculta: un evento «lista de chats mostrada» 20 segundos después de iniciar sesión, y nada más. Solo contiene el número de tu cuenta y la hora, sin mensajes ni nombres de chats. Los comandos de una sola ejecución no envían telemetría. Tras iniciar sesión, max personal serve solicita los mismos tipos de datos que la pestaña web: carpetas, banners, historial de llamadas, conjuntos de stickers y reacciones, y las fichas y el estado en línea de los contactos de chats personales. Tras el primer inicio también solicita historias, chats que faltan en las carpetas y la siguiente página de chats. Son peticiones de lectura; las respuestas no se muestran ni se guardan. Los comandos puntuales no las realizan. Hay diferencias: max no se suscribe a notificaciones push ni solicita emojis animados. La pestaña decide qué pedir según su caché del navegador, que max no tiene, por lo que el número de peticiones difiere. MAX puede distinguir max de su cliente web.

Condiciones de MAX y tu cuenta

max no es una aplicación oficial de MAX. El acuerdo de usuario de MAX (versión del 09/09/2026, apartado 4.3.7) no permite programas automatizados sin el consentimiento de la empresa. Por tanto, una cuenta usada con max puede sufrir restricciones, y esa cuenta también puede estar vinculada a servicios públicos y a la comunicación con tus seres queridos.

Prácticas recomendadas:

  • Usa MAX como siempre, en el navegador o en el teléfono, junto con max. Una cuenta que solo responde a solicitudes de max tiene un comportamiento distinto del de una cuenta usada por una persona.
  • No conviertas max en un flujo continuo de peticiones. Lee cuando lo necesites, no cada minuto por programación.

Se avisa una vez por stderr al iniciar sesión por primera vez con max personal setup o max personal session start.

Inicio de sesión con navegador

session start qr-chrome y sms abren un perfil temporal, separado de tus contraseñas y cookies. Contiene una sesión de web.max.ru y se elimina al terminar, cerrar ventana, alcanzar --timeout o pulsar Ctrl-C. El token se lee por canal de depuración entre proceso y navegador (--remote-debugging-pipe), sin puerto de red ni acceso de otros usuarios.

session start qr dibuja el QR en terminal; queda en el historial visual pero caduca en minutos. Si la terminal es estrecha, lo muestra en una página 127.0.0.1 con dirección aleatoria; no guarda el enlace en archivo ni texto. La página desaparece al terminar.

Cada acceso añade un dispositivo en la lista de sesiones de MAX; puedes cerrarlo allí.

Protocolo no oficial

MAX no publica una API para cuentas de usuario. Todo lo que se sabe sobre el protocolo aquí se midió en una conexión en vivo o se leyó en la ingeniería inversa de otra persona, y para cada operación se anota exactamente de dónde vino (descripción del protocolo, columna "De dónde vino").

Puede dejar de funcionar sin aviso. En ese caso el comando indica el problema por stderr, en lugar de devolver una lista vacía como si todo funcionase.

Uso personal

La herramienta guarda en tu comando conversaciones y contactos de otras personas, incluidos los textos de los mensajes. El acceso a la base local permite acceder a esos datos. Entregar una exportación (max personal store export) a otra persona también entrega el contenido de la conversación; sus enlaces a fotos pueden abrirse sin iniciar sesión. Antes de compartir, revisa el contenido y los destinatarios. Esta página describe el funcionamiento de la herramienta y no certifica el cumplimiento legal de tu caso de uso.

Los informes (max personal doctor reports create) se adjuntan a incidencias públicas de GitHub. No contienen texto, nombres ni teléfonos; los identificadores se sustituyen por etiquetas. Revísalos antes de enviarlos.

Si se filtra el token

max personal session end        # выйти из MAX и забыть локально

session end termina esta sesión en el servidor de MAX, por lo que un token filtrado deja de funcionar. Si MAX no responde, el comando lo indica y conserva el token; repite el comando.

max personal account sessions end --others --yes cierra todas las demás sesiones, también el móvil, donde tendrás que iniciar sesión otra vez. No permite cerrar una concreta: MAX no les da identificador. Si MAX renueva el token actual, max lo guarda antes de confirmar.

Siguiente paso