OpenClaw

OpenClaw 2.0: qué cambia y cómo actualizar sin romper tu Claw

Autorangel cruz
Publicado
Lectura10 min de lectura
OpenClaw 2.0: qué cambia y cómo actualizar sin romper tu Claw

OpenClaw 2.0 es la versión v2026.8.1, publicada el 31 de agosto de 2026, y trae tres breaking changes: desaparece el plugin OpenProse con su comando /prose, las referencias de modelo codex/* y openai-codex/* pasan a openai/*, y los plugins externos tienen hasta el 1 de septiembre de 2026 para migrar sus imports del SDK. El comando que resuelve los dos primeros es openclaw doctor --fix.

Si vienes de una instalación que ya funcionaba, esa frase es el 90% de lo que necesitas. El otro 10% son los comportamientos que cambiaron de valor por defecto sin avisarte, y ahí es donde se pierde una tarde.

Si todavía no tienes OpenClaw instalado, empieza por la guía de instalación paso a paso y vuelve aquí después. Esta página asume que ya tienes un Claw corriendo.

Qué es OpenClaw 2.0 y por qué se llama v2026.8.1

OpenClaw versiona por fecha, así que el número que verás en la terminal es v2026.8.1. "OpenClaw 2.0" es el nombre con el que el proyecto presentó ese release, no un esquema de versionado nuevo.

Los números del anuncio, firmado por Hannes Rudolph el 30 de agosto de 2026, son estos: 933 contribuyentes, de los cuales 569 eran primerizos, y más de 16.000 pull requests. Ese último dato se puede contrastar: el repositorio acumula 30.823 pull requests fusionados en total al 31 de agosto de 2026, así que la afirmación del anuncio de que este release concentra "aproximadamente el 50% de todos los PR jamás fusionados" cuadra.

Para situar el proyecto: openclaw/openclaw se creó el 24 de noviembre de 2025, está escrito en TypeScript, es MIT (copyright de la OpenClaw Foundation) y al escribir esto ronda las 388.000 estrellas y los 81.000 forks en GitHub.

El anuncio también explica el silencio previo. Según Rudolph, el proyecto había publicado 106 releases en 230 días, casi siempre con uno o dos días de diferencia entre sí, y pasar siete semanas sin publicar no era su ritmo normal. La razón que da es que el equipo creció y el volumen de trabajo se comió tanto la base de código como el proceso de publicación, así que rehicieron los dos a la vez.

Los tres breaking changes de OpenClaw 2.0

1. OpenProse y el comando /prose se eliminaron

El plugin OpenProse que venía incluido y su comando /prose ya no existen. La documentación pide correr openclaw doctor --fix para limpiar la configuración que quedó huérfana y luego seguir la migración a Agent Skills que publica el propio proyecto upstream.

Tus archivos .prose no se tocan: siguen ahí como fuente.

2. Las rutas codex/* pasan a openai/*

Si tenías modelos referenciados como codex/* o openai-codex/* (en la configuración del proveedor, en sesiones guardadas o en rutas de automatizaciones), esas referencias hay que migrarlas.

De nuevo openclaw doctor --fix: reescribe la configuración del proveedor, las sesiones almacenadas y las rutas de automatización al formato openai/*, conservando la intención de usar el runtime de Codex y marcando los conflictos que encuentre en lugar de resolverlos a ciegas.

3. El gate del Plugin SDK: 1 de septiembre de 2026

Este solo te afecta si mantienes un plugin externo, y es el único con fecha límite. Los imports se reorganizan en tres frentes:

  • La configuración pasa a api.pluginConfig y a subrutas específicas de openclaw/plugin-sdk/.
  • Los imports de canales se consolidan en openclaw/plugin-sdk/channel-outbound y su variante inbound.
  • Los de infraestructura se mueven a helpers especializados como openclaw/plugin-sdk/delivery-queue-runtime o openclaw/plugin-sdk/diagnostic-runtime.

La documentación insiste en que son gates anunciados, no eliminaciones que ya ocurrieron, y remite a la guía de migración del SDK para el mapeo helper por helper.

Cómo actualizar OpenClaw a la versión 2.0

El procedimiento corto, sobre una instalación existente:

# 1. Actualiza
openclaw update
 
# 2. Aplica las migraciones y repara lo que quedó a medias
openclaw doctor --fix
 
# 3. Si faltan paquetes de proveedor que sí tenías configurados
openclaw update repair

Ese openclaw doctor --fix es el que hace el trabajo sucio. Según la documentación del release, se encarga de limpiar la configuración obsoleta de OpenProse, migrar las referencias codex/* a openai/*, recuperar los paquetes de proveedor configurados que falten, reparar los nombres de agente heredados junto con el historial de la sesión main, y aplicar las migraciones de configuración seguras.

Una nota sobre ese último punto que conviene conocer: las migraciones seguras del doctor ahora se aplican solas al arrancar el Gateway, antes de que empiece la operación normal. Es decir, parte del trabajo ocurre aunque no llames al comando.

Sobre las apps nativas al momento del release: en macOS hay ZIP firmado y notarizado de la v2026.8.1, con el DMG pendiente de finalizar. Las distribuciones de iOS y Android salen por separado, y en Android la vía es Google Play o releases anteriores con APK y checksums.

Los comportamientos por defecto que cambiaron en OpenClaw 2.0

Los breaking changes vienen anunciados y el doctor los arregla. Los valores por defecto no: cambian el comportamiento de tu Claw sin que tú toques nada. Estos son los que revisaría antes de actualizar:

Memoria y aprendizaje automático. Tres cosas se activan solas: la recuperación de conversaciones personales trae contexto acotado del mismo agente en instalaciones personales, la consolidación de memoria en segundo plano promueve material a memoria de largo plazo, y el autoaprendizaje captura y aplica skills aprobadas por el scanner. Las tres tienen control explícito para desactivarlas.

Las skills aprendidas se aplican sin pedir permiso. En el Skill Workshop, las acciones de aplicar, rechazar y poner en cuarentena que inicia el agente corren por defecto sin aprobación adicional. Si quieres que te pregunte, hay que poner skills.workshop.approvalPolicy: "pending".

Las sesiones ya no se cortan de noche. Si no configuraste una política de reset, las sesiones persisten entre periodos de inactividad y entre días. Las políticas diarias o por inactividad, y el /new manual, siguen mandando por encima.

La concurrencia sube. El número de agentes de primer nivel simultáneos ahora escala con el paralelismo de la CPU, acotado entre 8 y 16. En una máquina modesta eso se nota.

Los heartbeats cambian de destino. Las alertas ambientales van por defecto a un DM del owner que se pueda resolver. Si dependías de que aterrizaran en una conversación de grupo, hay que configurar el destino explícitamente.

La telemetría queda apagada. Las estadísticas de uso vienen desactivadas por defecto, con opt-in a través de la comprobación diaria de versión. Puedes inspeccionar qué se enviaría con openclaw telemetry show.

El modelo de OpenAI por defecto. Los setups nuevos con API key u OAuth usan exactamente openai/gpt-5.6-sol, y se eliminaron los alias duplicados. Además, la expansión de contexto largo de OpenAI ahora exige configuración explícita del modelo: el presupuesto de runtime se mantiene separado de la capacidad nativa.

Qué trae de nuevo OpenClaw 2.0

Las notas del release son larguísimas. Esto es lo que cambia la forma de usar OpenClaw:

Sesiones en la nube compartidas. Es el cambio que el propio equipo dice haber construido para sí mismo mientras hacía este release. Antes no había forma de meter a otra persona en un trabajo en curso sin perder lo que el Claw ya sabía. Ahora se define visibilidad y membresía de la sesión, se asignan owners y se controla quién puede ver, sugerir o contribuir, conservando la atribución de quien la creó.

Instalación que parte de lo que ya tienes. El primer arranque detecta suscripciones existentes de ChatGPT o Claude, API keys y modelos locales, en vez de pedirte que configures todo desde cero. El resto de la configuración se movió fuera del setup inicial: terminas de configurar el Claw hablando con él.

La app de navegador como experiencia principal. Es donde la mayoría se encuentra con OpenClaw por primera vez, y se rehízo entera. También hay búsqueda de conversaciones por palabra o frase exacta, con reapertura de los mensajes alrededor del resultado.

Credenciales sin exponerlas. El agente puede pedir credenciales por un prompt enmascarado, sin que el valor aparezca en el chat ni en el contexto del modelo, con proxy opcional limitado a destinos aprobados. Hay también un almacén de secretos compartido por equipo en SQLite, con valores de solo escritura, y un broker opcional de 1Password.

Permisos recurrentes. Se concede una vez para operaciones concretas, se puede inspeccionar y revocar después, y vuelve a pedir aprobación cuando el trabajo cambia.

Comandos nuevos. openclaw backup sqlite crea, lista, verifica y restaura snapshots de la base de datos, globales o por agente, siempre sobre destinos de restauración limpios. openclaw triage genera un volcado saneado para pedir ayuda con un bug sin filtrar tus datos. Y openclaw agent exec corre en modo headless contra el directorio que elijas, con estado temporal o retenido, fallbacks de modelo explícitos y salida legible por máquina.

Supervisión externa del Gateway. Con OPENCLAW_SUPERVISOR_MODE=external, un supervisor tuyo se queda con los reinicios y el ciclo de vida sin pelearse con el servicio nativo. Si corres OpenClaw bajo systemd o dentro de un contenedor, esta es la variable que buscabas.

Preguntas frecuentes

¿Qué versión es OpenClaw 2.0?

Es v2026.8.1, publicada el 31 de agosto de 2026. OpenClaw versiona por fecha; "2.0" es el nombre del release, no un número de versión que vayas a ver en la terminal.

¿Se me va a romper la instalación al actualizar a OpenClaw 2.0?

Depende de tres cosas: si usabas /prose u OpenProse, si tenías modelos referenciados como codex/*, y si mantienes plugins externos propios. Los dos primeros los arregla openclaw doctor --fix. El tercero requiere trabajo manual y tiene fecha: 1 de septiembre de 2026.

¿Cómo actualizo OpenClaw a la 2.0?

openclaw update, después openclaw doctor --fix, y openclaw update repair si echas en falta paquetes de proveedor que tenías configurados.

¿Qué pasó con el comando /prose?

Se eliminó junto con el plugin OpenProse que venía incluido. La ruta oficial es migrar a Agent Skills siguiendo la guía upstream. Tus archivos .prose se conservan.

¿Por qué OpenClaw tardó casi dos meses en publicar esta versión?

Según el anuncio del proyecto, el ritmo de publicación bajó mientras el desarrollo aceleraba: el equipo creció y el volumen de trabajo superó tanto la base de código como el proceso de release, así que rehicieron ambos antes de publicar. El resultado concentra alrededor de la mitad de todos los PR fusionados en la historia del repositorio.

¿OpenClaw sigue siendo gratis y open source?

Sí. El repositorio openclaw/openclaw es MIT, con copyright de la OpenClaw Foundation.

Lo que yo revisaría antes de darle a actualizar

El orden que seguiría: primero openclaw backup sqlite para tener de dónde volver, después mirar si uso /prose o rutas codex/*, y solo entonces openclaw update seguido de openclaw doctor --fix.

Y una vez dentro, los dos interruptores que revisaría antes que nada son la consolidación de memoria en segundo plano y el autoaprendizaje de skills. Los dos vienen activados, y los dos deciden qué acaba guardado en la memoria de largo plazo de tu Claw.

Fuentes