OpenClaw Qué versión seguir y cómo actualizar
Xiao Zhou instaló OpenClaw en un pequeño servidor de su empresa, funcionaba sin problemas y no lo tocó durante un mes. Un día, alguien reenvió un mensaje en el grupo: "OpenClaw tiene una vulnerabilidad crítica, actualiza cuanto antes." Abrió GitHub y descubrió que en una semana se habían publicado varias versiones, además de una línea llamada extended-stable, y no supo a cuál actualizar ni cómo revertir si algo salía mal.
Esta lección sigue el orden real del proceso:
- 1?
- 2?
- 3?
- 4?
- 5?
- 6?
Haz clic uno por uno, en orden.
OpenClaw Tiene cuatro canales de actualización: stable, extended-stable, beta y dev. La mayoría sigue stable; quienes quieren menos complicaciones y lo ejecutan a largo plazo en servidores pueden seguir extended-stable; beta y dev son para quienes quieren probar novedades y para desarrolladores. Cuando aparece un boletín de seguridad, se actualiza a la versión de corrección indicada en el boletín o a una más reciente dentro del propio canal.
Qué podrás hacer al terminar
- Explicar las diferencias entre los cuatro canales y elegir uno para tu máquina
- Leer un boletín de seguridad de OpenClaw y determinar si te afecta
- Usar
openclaw updatepara simular, actualizar y verificar, y revertir si es necesario
Primero atiende este boletín
2026-11-19, OpenClaw publicó un boletín de gravedad alta, GHSA-pw3x-g8v8-fvj2 (CVSS 8.8). Afecta a la versión de referencia de este tutorial, 2026.10.9, así que primero la conclusión:
| Campo del boletín | Contenido |
|---|---|
| Título | OpenClaw delegation could skip approval for restricted agents |
| Problema | Cuando la política de herramientas prohíbe ejecutar comandos y escribir archivos, la herramienta openclaw aún puede escribir en la configuración persistente sin aprobación, lo que permite a un agente restringido abrir la ejecución de comandos del host |
| Versiones afectadas | ≥ 2026.9.2 y < 2026.10.33; ≥ 2026.11.1 y < 2026.11.4 |
| Versiones corregidas | la primera versión corregida de stable es 2026.11.4; los usuarios de extended-stable deben actualizar a 2026.10.33 |
| Mitigación previa a la actualización | establecer tools.exec.mode en ask para rechazar cambios de delegación no confiables |
Texto original del boletín: https://github.com/openclaw/openclaw/security/advisories/GHSA-pw3x-g8v8-fvj2. Todos los boletines de seguridad de OpenClaw están en la página Security → Advisories del repositorio: https://github.com/openclaw/openclaw/security/advisories.
BuscarMi versión actual es…
Toca uno para ver.
En el boletín hay una frase fácil de pasar por alto: esta vulnerabilidad "no cambia el modelo de confianza de OpenClaw"; el impacto depende de tu configuración y de si las entradas de baja confianza pueden llegar a esta ruta. Es decir, un Gateway usado por una sola persona y sin canales externos tiene menor riesgo, pero aun así deberías actualizar.
- Usé
openclaw --versionpara ver mi versión y sé si me afecta
En qué se diferencian los cuatro canales
La definición oficial de los cuatro canales:
| Canal | Etiqueta npm correspondiente | Descripción |
|---|---|---|
| stable | latest | Recomendado para la mayoría de los usuarios |
| extended-stable | extended-stable | el texto oficial es "trailing supported-month package channel", es decir, una línea de versiones que va por detrás de la más reciente y se mantiene mes a mes; solo admite instalación por paquetes (npm, etc.), no por git; la instalación solo puede hacerse en primer plano; con update.checkOnStart activado solo muestra avisos de actualización de solo lectura, nunca instala automáticamente |
| beta | beta | toma la que tenga número de versión más reciente entre beta y latest; una beta antigua no reemplaza a una stable más reciente |
| dev | ninguna (la rama main de git) | puede contener funciones inacabadas o cambios disruptivos, no usar en un Gateway de producción |
El posicionamiento de extended-stable está expresado con toda claridad en las notas de lanzamiento de 2026.10.33: "gateway-only extended-stable release, which is our current equivalent to LTS". Es el OpenClaw de finales de octubre (mes 10), más correcciones de seguridad críticas, correcciones de fiabilidad y rendimiento y soporte para nuevos modelos. Solo publica el Gateway: el paquete npm principal, los complementos oficiales de npm asociados y la imagen Docker del Gateway, sin incluir la App nativa. En cuanto a los números de versión, extended-stable usa números de parche mensuales a partir de 33 (por ejemplo, 2026.9.33 a 2026.9.37, 2026.10.33), con una numeración separada de la de stable.
A 2026-11-20, las últimas versiones de las tres líneas:
| Canal | Versión | Fecha |
|---|---|---|
| stable | 2026.11.6 | 2026-11-19 |
| extended-stable | 2026.10.33 | 2026-11-18 |
| beta | 2026.11.10-beta.1 | 2026-11-19 |
Pon a prueba tus conocimientosEl OpenClaw de Xiaozhou está instalado con npm en un servidor y solo corre el Gateway; no quiere seguir los cambios cada semana, pero no quiere perderse ni una corrección de seguridad. ¿Qué canal le conviene más?
- Ya elegí el canal que voy a seguir
Paso 1: comprobar la versión y el canal actuales
Por qué: antes de actualizar hay que conocer el punto de partida, sobre todo qué instalación está ejecutando realmente el servicio del Gateway.
openclaw --version
openclaw update statusDeberías ver: el primer comando imprime el número de versión de la CLI. El segundo muestra el canal actual y la fuente que lo determina (configuración, tag de git, rama de git, versión instalada o valor por defecto), el método de instalación (git o paquete), la versión actual y si hay actualizaciones disponibles.
La verificación previa a la actualización oficial también advierte: openclaw --version reporta la versión de la línea de comandos, y el servicio Gateway puede apuntar a otra instalación. Vuelve a comprobarlo con openclaw status y openclaw gateway status --deep.
- Conozco mi versión, canal y forma de instalación
Paso 2: si no puedes actualizar de inmediato, aplica primero una mitigación temporal
Por qué: la mitigación indicada en el anuncio consiste en hacer que la ejecución pase por confirmación manual, bloqueando antes de la actualización la ruta más peligrosa.
En ~/.openclaw/openclaw.json:
{
tools: {
exec: { mode: "ask" },
},
}Tras modificarlo, reinicia el Gateway. Esto es solo una mitigación; la primera recomendación del anuncio sigue siendo actualizar.
- En las máquinas que aún no se pueden actualizar, ya configuré
tools.exec.modecomoask
Paso 3: haz una copia de seguridad y luego un ensayo
Por qué: la documentación oficial dice que lo que openclaw update guarda automáticamente es solo una copia de la configuración previa a la actualización, no el estado completo. Una degradación tampoco revierte las migraciones de configuración y base de datos; para volver de verdad a la versión anterior, lo que se necesita es una copia de seguridad previa a la actualización.
mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verifyDeberías ver: un paquete de respaldo adicional en el directorio de copias de seguridad. El paquete puede contener credenciales y estado de canales; protégelo igual que protegerías ~/.openclaw.
Luego haz un ensayo para ver qué piensa hacer:
openclaw update --channel stable --dry-run
# 想跟 extended-stable 的改成:
openclaw update --channel extended-stable --dry-runDeberías ver: en el informe aparecen el canal vigente, la versión de destino, las acciones previstas y si se requiere confirmación de degradación. --dry-run no modifica nada.
- Tengo una copia de seguridad con
--verifyy ya revisé el resultado del ensayo
Paso 4: actualizar y verificar
Por qué: --channel ejecuta la actualización y, tras completarse con éxito la del núcleo, escribe la selección en update.channel de la configuración, de modo que en el futuro basta con openclaw update para seguir usando esa línea.
openclaw update --channel stable
# 或
openclaw update --channel extended-stableDeberías ver: la actualización completada. Para el servicio Gateway gestionado, tras un cambio exitoso se refresca el servicio y se comprueba su disponibilidad; si el cambio se rechaza o se revierte tras la verificación, se restaura el servicio anterior.
Verifica una vez más:
openclaw --version
openclaw gateway status --deepDeberías ver: el número de versión es 2026.11.4 o más reciente (stable), o 2026.10.33 (extended-stable).
Algunos puntos a tener en cuenta:
Las instalaciones git no pueden usar extended-stable. OpenClaw se mantiene tal cual, para que cambies a la instalación por paquete.
Cambiar de 2026.11.1 ~ 11.3 a extended-stable 2026.10.33 es, por número de versión, una degradación, y mostrará una confirmación de degradación. La degradación no revierte las migraciones ya realizadas; en este caso, actualizar por la línea stable a 2026.11.4 o superior es más estable.
Si solo quieres instalar una versión concreta una sola vez sin cambiar de canal, usa
--tag, por ejemploopenclaw update --tag 2026.4.1-beta.1de la documentación oficial.--tagsolo funciona con instalaciones del paquete npm; las instalaciones git lo ignoran.La versión que muestra
openclaw --versionya está fuera del rango afectado
Paso 5: revertir si algo sale mal
Por qué: a veces las versiones nuevas entran en conflicto con tu entorno. La recomendación oficial es revertir con openclaw update, y no sobrescribir manualmente con npm i -g, porque esto último no conserva el paquete anterior ni ejecuta el proceso de recuperación.
openclaw update --tag <已知可用的版本> --dry-run
openclaw update --tag <已知可用的版本>El actualizador comprueba la compatibilidad y te pide confirmar la degradación. Si tu canal guardado es extended-stable, la documentación oficial indica que hay que añadir --channel stable para poder especificar la versión exacta.
Deberías ver: el servicio se reinicia y la versión en ejecución vuelve a la que especificaste. Si la versión antigua no puede leer el estado actual, el actualizador lo rechaza; en ese caso hay que restaurar con la copia de seguridad del paso 3 junto con la versión antigua correspondiente. No esquives rechazos del tipo "configuración o base de datos escrita por una versión nueva".
Además, hay dos redes de seguridad más:
- Cuando falla la verificación de un paquete recién activado,
openclaw updaterevierte automáticamente a la versión anterior si se cumplen las condiciones. A partir de 2026.11.5, un fallo de arranque de Doctor o del Gateway también revierte la actualización activada. - Si te atascas, ejecuta
openclaw triageen la máquina donde está el Gateway; entregará la información de diagnóstico al agente de programación local para que te ayude a repararlo.
::: advertencia No reviertas a una versión afectada Porque al revertir por GHSA-pw3x, la versión de destino debe ser 2026.11.4 o superior, o 2026.10.33. Volver a 2026.10.9 equivale a reinstalar la vulnerabilidad. :::
- He anotado un número de versión "que sé que funciona y no está afectado por el anuncio"
Punto de control
- Puedo mencionar dos diferencias entre stable y extended-stable (por ejemplo, el ritmo de actualizaciones o si incluye la App nativa)
- Puedo encontrar en un anuncio las versiones afectadas, las versiones corregidas y la mitigación temporal
- Mi Gateway ya está actualizado a 2026.11.4 o superior, o a 2026.10.33
- Sé que antes de actualizar hay que hacer primero
openclaw backup create --verifyy luego--dry-run
Malentendidos frecuentes
Creer que extended-stable se actualiza solo. Nunca se instala automáticamente; como mucho, da un aviso durante la comprobación de arranque. Quien siga esta línea debe revisar periódicamente los anuncios por su cuenta y ejecutar openclaw update manualmente.
Creer que la degradación lo revierte todo. La documentación oficial deja claro que el paquete de degradación no revierte las migraciones de configuración y base de datos. Cuando el estado ya se migró a un formato que la versión antigua no puede leer, la única vía soportada es restaurar la copia de seguridad previa a la actualización.
Creer que beta, por ser más "nueva" que stable, es más segura. beta es una versión candidata; las correcciones de seguridad llegan a stable y extended-stable. En producción usa stable o extended-stable; respecto a dev, la recomendación oficial dice claramente que no se use en un Gateway de producción.
Sección siguiente
Los comandos y opciones de configuración más usados están resumidos enReferencia rápida de comandos y configuración de la CLI; los cambios de cada versión se encuentran enRegistro de cambios.