release architecture security clawhub breaking-changes performance

OpenClaw 3.22: Cirugía arquitectónica — 12 cambios incompatibles, 30+ parches de seguridad, la mayor versión hasta la fecha

OpenClaws.io Team

OpenClaws.io Team

@openclaws

March 22, 2026

15 min de lectura

OpenClaw 3.22: Cirugía arquitectónica — 12 cambios incompatibles, 30+ parches de seguridad, la mayor versión hasta la fecha

9 días desde la 3.13. La pausa más larga entre versiones de OpenClaw en meses. Cuando por fin cayó el changelog, todo cobró sentido: 12 cambios incompatibles, más de 30 parches de seguridad, más de 100 correcciones de estabilidad, 7 nuevos proveedores de modelos y un giro radical en cómo se descubren e instalan los plugins.

No es una actualización incremental. Es la versión en la que OpenClaw arrancó sus tuberías heredadas y reconstruyó los cimientos.

Vamos por partes.

ClawHub: la gran migración del ecosistema de plugins

El cambio estrella de la 3.22 parece sencillo: openclaw plugins install ahora consulta ClawHub antes que npm.

Esa frase reescribe la economía de plugins. ClawHub es el registro de paquetes nativo de OpenClaw — diseñado expresamente para descubrimiento, versionado y verificación de confianza. npm siempre fue una casa prestada; ClawHub es la primera que OpenClaw posee de verdad.

Lo que se entrega junto con ello:

  • Flujos nativos de install/search/update: openclaw skills search|install|update más openclaw plugins install clawhub: con metadatos de actualización rastreados
  • Soporte de bundles Claude/Codex/Cursor: Descubrimiento e instalación de bundles compatibles, mapeo de skills de bundle a skills de OpenClaw, aplicación de los valores por defecto de settings.json del bundle al Pi integrado
  • Registro de marketplace de Claude: Instalación plugin@marketplace, listado y actualizaciones
  • Renovación del Plugin SDK: La nueva superficie pública es openclaw/plugin-sdk/* — el antiguo openclaw/extension-api monolítico se elimina sin capa de compatibilidad. Los plugins empaquetados deben usar el runtime inyectado para operaciones del lado host
  • Superficie de testing del Plugin SDK: Superficie pública openclaw/plugin-sdk/testing con helpers de test para autores de plugins
  • Soporte de system-prompt para el plugin Memory: El plugin de memoria activo ahora puede registrar su propia sección de system-prompt

El cambio del Plugin SDK es el prerequisito estructural de todo lo demás. Al estandarizar en subpaths estrechos de openclaw/plugin-sdk/* en lugar de una raíz monolítica, cada plugin obtiene un contrato de API más pequeño y estable. La superficie de testing significa que los autores de plugins por fin pueden escribir tests serios sin hurgar en las entrañas del framework.

12 cambios incompatibles: saldando la deuda técnica de un golpe

Doce breaking changes en una sola versión. Suena agresivo. Pero leídos en conjunto cuentan una historia coherente: OpenClaw está quemando los últimos puentes hacia su arquitectura pre-1.0.

Ecosistema de plugins (4)

  1. 1.ClawHub reemplaza a npm como fuente de instalación de plugins por defecto. El fallback a npm permanece, pero ClawHub tiene prioridad para nombres npm-safe
  2. 2.Superficie del Plugin SDK cambiada a openclaw/plugin-sdk/* — el viejo openclaw/extension-api desaparece sin shim de compatibilidad
  3. 3.Relay de extensión Chrome MCP eliminado — ruta de relay, assets de extensión empaquetados y driver: "extension" eliminados. Ejecuta openclaw doctor --fix para migrar
  4. 4.Generación de imágenes estandarizada — documentación/ejemplos de nano-banana-pro eliminados. Usa agents.defaults.imageGenerationModel

Limpieza de legado (3)

  1. 5.Variables de entorno heredadas eliminadas: CLAWDBOT_ y MOLTBOT_ eliminadas del runtime, instaladores y herramientas de test. Usa OPENCLAW_*
  2. 6.Directorio de estado heredado eliminado: .moltbot y la detección automática de moltbot.json eliminados. Migra a ~/.openclaw o configura OPENCLAW_STATE_DIR
  3. 7.Adaptador de descubrimiento de mensajes cambiado: Se requiere ChannelMessageActionAdapter.describeMessageTool(...) — los métodos heredados listActions, getCapabilities y getToolSchema se eliminan

Seguridad y sandbox (3)

  1. 8.Sandbox de entorno exec ampliado: Bloquea inyección JVM (MAVEN_OPTS, SBT_OPTS, GRADLE_OPTS, ANT_OPTS), explotación de tunables glibc (GLIBC_TUNABLES) y secuestro de dependencias .NET (DOTNET_ADDITIONAL_DEPS)
  2. 9.Wrapper time transparente: time se trata como wrapper de despacho transparente durante la evaluación de allowlist
  3. 10.Endurecimiento de webhooks de llamadas de voz: Rechaza cabeceras de firma ausentes antes de leer el body, presupuesto pre-auth reducido a 64 KB / 5s

Protocolos de plataforma (2)

  1. 11.Discord Carbon reconcile: El despliegue nativo de comandos cambia a Carbon reconcile por defecto
  2. 12.Plugin de Matrix reescrito: Nuevo plugin basado en el matrix-js-sdk oficial, con guía de migración

Doce breaking changes en una versión. Parece radical. Pero mirando atrás, cada corte llegaba con retraso.

Seguridad: más de 30 parches, de SMB a SSRF a Hangul

La sección de seguridad en 3.22 es masiva. No 3 elementos como en 3.13 — más de treinta. Agrupados por superficie de ataque:

Capa de red y protocolos

  • Fuga de credenciales SMB en Windows bloqueada: Se bloquean URLs de medios file:// de hosts remotos y rutas UNC/red antes de la resolución del sistema de archivos local
  • Pinning SSRF endurecido: El pinning SSRF de proxy explícito traduce hints de transporte a túneles proxy HTTPS y falla cerrado para fetches HTTP plano protegidos
  • Alcance de autenticación del Gateway endurecido: Ignora saltos loopback falsificados en cadenas de reenvío de confianza
  • Descubrimiento del Gateway fail-closed: Endpoints Bonjour y DNS-SD no resueltos fallan cerrado
  • Límites del body de errores de medios: Los snippets aplican los mismos límites de streaming que las descargas exitosas

Capa de sandbox y ejecución

  • Manifiestos de marketplace de plugins sandboxeados: Rechaza entradas que expanden la instalación fuera del repo marketplace clonado
  • jq eliminado de la whitelist safe-bin: jq -n env ya no puede volcar secretos del host sin ruta de confianza explícita
  • Verificación HMAC de exec en macOS: Comparación timing-safe, firmas malformadas fallan cerrado
  • Sandbox de entorno exec: Bloquea vectores de inyección JVM, glibc y .NET
  • Gates para hooks de workspace: Los hooks locales del repo permanecen deshabilitados hasta habilitación explícita

Capa de identidad y autenticación

  • Emparejamiento de dispositivos vinculado a perfil: Códigos de configuración iOS vinculados al perfil de nodo previsto
  • Vinculación de user_id en Synology Chat: Entrega de respuestas vinculada a user_id numérico estable por defecto
  • Aplicación de proxy de nodo del navegador: nodeHost.browserProxy.allowProfiles aplicado en parámetros de query y body
  • Rotación de tokens de dispositivo endurecida: Fallos públicos genéricos, razones de denegación internas registradas
  • Limpieza de scopes de proxy de confianza: Scopes auto-declarados limpiados para sesiones Control UI sin dispositivo

Capa de codificación e inyección

  • Escape de Hangul filler: Los code points Hangul filler en blanco se escapan en prompts de aprobación — el padding Unicode visualmente vacío ya no puede ocultar texto de comandos
  • Política pre-cripto de DM de Nostr: Política de DM entrante aplicada antes del descifrado
  • Escape de contexto de archivos OpenResponses endurecido
  • Parsing de webhooks LINE: Body crudo verificado forzado para parsing de webhooks Express
  • Sanitización de metadatos de webhooks de email: Metadatos de remitente y asunto sanitizados antes del wrapping de contenido externo
Superficie de ataqueCorrecciones
Red y protocolos5
Sandbox y ejecución5
Identidad y autenticación5+
Codificación e inyección5+
Específicas de plataforma10+
Total30+

Estos parches no aparecerán en pósters publicitarios. Pero determinan quién se atreve a meter OpenClaw en producción. Ser confiable es más difícil que ser útil.

Rendimiento: el arranque en frío del Gateway renace

La mejora de rendimiento más perceptible: el Gateway ya no recompila TypeScript de extensiones empaquetadas en cada arranque. Los arranques en frío de la clase WhatsApp pasan de decenas de segundos (o más) a segundos.

Otros cambios:

  • Precalentamiento de modelos: El modelo primario configurado se precalienta antes del arranque de canales, con un reintento transitorio
  • Carga perezosa en toda la pila: Rutas de add de canales, resolución de fallback de plugins/proveedores, runtime de Discord, comprensión de medios/enlaces — todo con carga perezosa
  • Caché del catálogo de modelos del Agent: Cacheado por estado de config y auth-file
  • Barrido de caché de sesiones: Entradas expiradas barridas oportunísticamente

Nuevas funciones de un vistazo

Ecosistema de búsqueda

Tres nuevos plugins de búsqueda web empaquetados:

  • Exa: Filtros de fecha nativos, selección de modo de búsqueda, extracción de contenido opcional
  • Tavily: Herramientas dedicadas tavily_search y tavily_extract
  • Firecrawl: Herramientas firecrawl_search y firecrawl_scrape con fallback base-URL/env

Sandbox y herramientas

  • Backends de sandbox conectables: OpenShell (modo espejo y workspace remoto) y SSH (clave, certificado y known_hosts respaldados por secrets)
  • Perfiles de navegador Chromium: browser.profiles..userDataDir soporta Brave, Edge y otros navegadores basados en Chromium

Experiencia de interacción

  • /btw preguntas laterales: Respuestas rápidas sin herramientas sobre la sesión actual sin alterar el contexto futuro
  • Expansión a canvas en Control UI: Botón de expansión en las burbujas de chat del asistente
  • Slider de redondez: Ajusta el radio de las esquinas en la configuración de apariencia
  • Valores por defecto de thinking/reasoning/fast por Agent: Reversión automática de overrides de modelo no permitidos

CLI y configuración

  • Ampliación de CLI config set: Modos SecretRef y provider builder, asignación JSON/batch, validación --dry-run
  • Monitor de salud del Gateway: Umbrales de eventos configurables y límites de reinicio
  • Instalación desde GitHub main: openclaw update --tag main

Proveedores de modelos: la carrera armamentística continúa

ProveedorCambios
OpenAIModelo por defecto cambia a openai/gpt-5.4. Compatibilidad anticipada con gpt-5.4-mini y gpt-5.4-nano
Anthropic VertexNuevo soporte de proveedor core para Claude vía Google Vertex AI
ChutesNuevo proveedor empaquetado con auth OAuth/API-key propia del plugin
MiniMaxM2.7 y M2.7-highspeed añadidos, por defecto actualizado de M2.5 a M2.7
xAICatálogo Grok sincronizado con IDs Pi actuales
Z.AICatálogo GLM sincronizado incluyendo familias 4.5/4.6
XiaomiCambio a endpoint /v1 compatible con OpenAI. MiMo V2 Pro y V2 Omni añadidos
MistralMetadatos por defecto sincronizados con precios Pi actuales
GitHub CopilotIDs de modelo dinámicos con compatibilidad anticipada

Mejoras en todas las plataformas

Android

  • Tema oscuro según el sistema: Desde onboarding hasta la pantalla principal
  • Migración de voz Talk: Síntesis de voz trasladada detrás de gateway talk.speak
  • Búsqueda de registro de llamadas y búsqueda de SMS con permisos compartidos
  • Corrección de búsqueda de contactos: Escape de % y _ literales en consultas de nombres
  • Corrección de memoria de cámara: Reciclaje de bitmaps de snapshots

Telegram

  • Endpoints de Bot API personalizados: Soporte por cuenta para despliegues de Telegram auto-hospedados
  • Renombrado automático de temas DM: Etiquetas generadas por LLM en el primer mensaje
  • Acción de edición de temas: Renombrado de temas de foro y actualización de iconos
  • Respuestas de error silenciosas: Ajuste channels.telegram.silentErrorReplies desactivado por defecto
  • Estabilidad de red: Fallback IPv4 sticky preservado entre reinicios de polling

Feishu (Lark)

  • Tarjetas interactivas de aprobación y acciones rápidas con enrutamiento de contexto de callback
  • Vinculación de sesiones ACP y subagentes
  • Stream de razonamiento: Tokens de pensamiento renderizados como bloques de cita markdown
  • Cabeceras y pies de tarjeta con identidad
  • Superficie de acciones ampliada: Lectura/edición de mensajes, respuestas en hilos, fijado

Matrix

  • Plugin completamente reescrito basado en el matrix-js-sdk oficial
  • Política de sala allowBots: Comunicación entre bots configurados permitida
  • Opt-in de red privada: allowPrivateNetwork por cuenta
  • Deduplicación durable de eventos entre reinicios del Gateway
  • Corrección de binding mention-gated: Bindings ACP y de sesión inactivos expiran normalmente

Discord

  • Carbon reconcile para despliegue nativo de comandos
  • Autenticación estricta de whitelist de componentes DM
  • Reenvío de abort ACP: Trabajos Discord expirados cancelan el turno en ejecución

WhatsApp

  • Corrección de reconexión: Filtro de recencia append restaurado en el monitor de inbox
  • Singleton de listener activo: Singleton globalThis garantiza mapa de listeners compartido
  • Corrección de login: Espera la escritura de credenciales antes de reabrir tras reinicio de emparejamiento

Más de 100 correcciones de estabilidad: la tabla habla

ÁreaCorrecciones clave
Compactación de AgentReparación de tool_result huérfanos post-compact, recuperación de overflow, resúmenes de frontera, truncación JSONL opt-in
Runtime de AgentDeduplicación de tool call ID, eliminación de campos prompt_cache, salida de error en texto plano para timeouts, sanitización de bloques de replay
Runtime de pluginsEstado singleton compartido entre grafos de módulos duplicados, semánticas de delegación de context engine, corrección de TDZ del bundler
GatewayTimeout de handshake WS subido a 10s, recuperación de runs huérfanos en reinicio, serialización de arranque de canales por cuenta
Control UIClaves de configuración por ruta de gateway, preservación de prefijo de proveedor al cambiar modelo, persistencia de dropdown de locale
TelegramHard-timeout de getUpdates atascados, enrutamiento de claves de sesión de temas DM, grupos mention-gated por defecto en setup

Datos de un vistazo

Métrica3.133.22
Breaking Changes012
Correcciones de seguridad330+
Parches de estabilidad70+100+
Nuevos proveedores de modelos07
Nuevos plugins de búsqueda web03
Fuente de pluginsnpmClawHub
Arranque en frío del GatewayDecenas de segundosSegundos
Timeout de Agent por defecto600s48h
Contribuidores agradecidos~1080+

---

3.22 no es de esas versiones que salen en titulares por una función nueva y brillante. Es una cirugía — abrir el pecho, cambiar el motor, cerrar y correr más rápido que antes.

12 cambios incompatibles no son caos. Son quemar los mapas viejos. ClawHub en producción, superficie de seguridad blindada, arranque en frío del Gateway renacido — estas tres cosas juntas significan que OpenClaw ha pasado de ser un "proyecto open source de iteración rápida" a "infraestructura en la que se puede confiar de verdad."

La langosta ha mudado otra vez. Esta vez, hasta el esqueleto es nuevo.

Mantente al día

Recibe novedades sobre nuevas funciones e integraciones. Sin spam, cancela cuando quieras.