Skip to content

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:

OrdenarEl orden de una actualización de seguridad
  1. 1?
  2. 2?
  3. 3?
  4. 4?
  5. 5?
  6. 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 update para 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ínContenido
TítuloOpenClaw delegation could skip approval for restricted agents
ProblemaCuando 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 corregidasla 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ónestablecer 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 --version para ver mi versión y sé si me afecta

En qué se diferencian los cuatro canales ​

La definición oficial de los cuatro canales:

CanalEtiqueta npm correspondienteDescripción
stablelatestRecomendado para la mayoría de los usuarios
extended-stableextended-stableel 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
betabetatoma 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
devninguna (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:

CanalVersiónFecha
stable2026.11.62026-11-19
extended-stable2026.10.332026-11-18
beta2026.11.10-beta.12026-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.

bash
openclaw --version
openclaw update status

Deberí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:

json5
{
  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.mode como ask

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.

bash
mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verify

Deberí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:

bash
openclaw update --channel stable --dry-run
# 想跟 extended-stable 的改成:
openclaw update --channel extended-stable --dry-run

Deberí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 --verify y 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.

bash
openclaw update --channel stable
# 或
openclaw update --channel extended-stable

Deberí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:

bash
openclaw --version
openclaw gateway status --deep

Deberí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 ejemplo openclaw update --tag 2026.4.1-beta.1 de la documentación oficial. --tag solo funciona con instalaciones del paquete npm; las instalaciones git lo ignoran.

  • La versión que muestra openclaw --version ya 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.

bash
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 update revierte 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 triage en 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 --verify y 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.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.