Cómo solucionar el error 'Cannot find module' de OpenClaw después de una actualización

Problema: Módulo faltante después de la actualización de OpenClaw

Los usuarios que actualizan OpenClaw de la versión 2026.3.24 a la 2026.4.5 están encontrando un error Cannot find module '@buape/carbon'. Este problema supuestamente se solucionó en una solicitud de extracción hace más de una semana, pero algunas instalaciones aún experimentan el problema.

No se recomienda instalar manualmente el paquete faltante de forma global, ya que puede causar incompatibilidades de dependencias más adelante.

Solución: Ejecutar manualmente el script posterior a la instalación

La solución implica ejecutar manualmente un script posterior a la instalación que debería haberse ejecutado automáticamente durante el proceso de actualización.

Pasos para solucionarlo

1. Identificar la ubicación de instalación de OpenClaw:
   Ejecuta which openclaw para determinar qué gestor de paquetes (pnpm o npm) gestiona tu instalación.
2. Encontrar el directorio de instalación global:
   Ejecuta pnpm root -g o npm root -g según tu gestor de paquetes.
3. Navegar al directorio de OpenClaw:
   Ejecuta cd $(pnpm root -g)/openclaw o el equivalente de npm.
4. Ejecutar el script posterior a la instalación:
   Ejecuta node scripts/postinstall-bundled-plugins.mjs
5. Esperar a que finalice:
   El script se ejecuta sin mostrar registros. Espera a que termine.
6. Verificar la solución:
   Ejecuta openclaw doctor para confirmar que la instalación funciona correctamente.

Este enfoque garantiza que las dependencias se instalen correctamente sin crear incompatibilidades de versiones que pueden ocurrir con la instalación manual de paquetes.