Entorno objetivo: Ubuntu + nvm + systemd | Node ≥22 | A fecha de 2026-03
clawdbot (~/.clawdbot/) → moltbot (~/.moltbot/) → openclaw (~/.openclaw/)
⚠️ Problema conocido: GitHub Issue #5103 Una “instalación por sobrescritura” de clawdbot a OpenClaw no detiene ni elimina el servicio anterior, ni desinstala el paquete npm antiguo. Esto resulta en servicios duplicados ejecutándose simultáneamente, conflictos en el puerto 18789 e inconsistencias de tokens, dejando el sistema en un estado defectuoso. Debes limpiar manualmente el entorno anterior antes de instalar OpenClaw.
Requisitos previos
Verifica tu entorno actual antes de comenzar.
# Verificar la versión de Node.js (se requiere 22 o superior)
node -v
npm -v
# Verificar paquetes relacionados con claw instalados actualmente
npm list -g --depth=0 2>/dev/null | grep -E "claw|molt|openclaw"
# Verificar servicios en ejecución actualmente
systemctl --user list-units | grep -E "claw|molt|openclaw"
OpenClaw requiere Node ≥22. Si usas nvm, ejecuta nvm install 22, o si ya tienes Node 24, puedes usarlo directamente. Se ha confirmado que clawdbot también funciona con Node 24.
Detener el servicio de clawdbot
Detén y deshabilita el Gateway que se ejecuta como servicio de usuario de systemd.
① Detener y deshabilitar el servicio del Gateway
systemctl --user stop clawdbot-gateway.service
systemctl --user disable clawdbot-gateway.service
② Eliminar el archivo de servicio y recargar el daemon
rm -f ~/.config/systemd/user/clawdbot-gateway.service
systemctl --user daemon-reload
③ Forzar la terminación de procesos residuales
pkill -f clawdbot || true
Nota: No uses
sudo systemctl --user. No funciona correctamente con servicios de usuario. Siempre ejecutasystemctl --user(sin sudo).
Desinstalar clawdbot
Elimina los paquetes globales de npm. También elimina moltbot (el nombre intermedio) por precaución.
npm uninstall -g clawdbot
npm uninstall -g moltbot
# Verificar la eliminación
which clawdbot 2>/dev/null && echo "Todavía presente" || echo "OK: Eliminado"
which moltbot 2>/dev/null && echo "Todavía presente" || echo "OK: Eliminado"
Respaldar y eliminar archivos de configuración
Respalda los directorios de configuración anteriores antes de eliminarlos, en caso de que necesites migrar la configuración a OpenClaw.
Respaldo
# Crear directorio de respaldo
mkdir -p ~/claw-backup
# Copiar solo los directorios que existan
[ -d ~/.clawdbot ] && cp -r ~/.clawdbot ~/claw-backup/.clawdbot-bak
[ -d ~/.moltbot ] && cp -r ~/.moltbot ~/claw-backup/.moltbot-bak
# Respaldar también el workspace (si existe)
[ -d ~/clawd ] && cp -r ~/clawd ~/claw-backup/clawd-bak
echo "Contenido del respaldo:"
ls -la ~/claw-backup/
Eliminación
rm -rf ~/.clawdbot
rm -rf ~/.moltbot
~/.clawdbot/ contiene clawdbot.json (configuración), agents/ (configuración de agentes y sesiones), tokens del Gateway, entre otros. El directorio memory/ puede contener contexto de proyecto acumulado, así que revisa su contenido antes de decidir si respaldarlo.
Verificar que no queden procesos residuales
Confirma que el sistema esté en un estado limpio.
# Confirmar que no hay procesos relacionados con claw en ejecución
ps aux | grep -E "(clawdbot|moltbot)" | grep -v grep
# → Si no aparece nada, está bien
# Confirmar que el puerto 18789 está libre
ss -tlnp | grep 18789
# → Si no aparece nada, está bien
# Confirmar que no quedan servicios en systemd
systemctl --user list-units | grep -E "claw|molt"
# → Si no aparece nada, está bien
Si los tres comandos no producen ninguna salida, clawdbot se ha desinstalado completamente. Puedes proceder con la instalación de OpenClaw.
Instalar OpenClaw
El método oficialmente recomendado es la instalación global con npm.
npm install -g openclaw@latest
# Verificar la instalación
openclaw --version
which openclaw
Según la documentación oficial, clawdbot y moltbot se mantienen como alias válidos de OpenClaw. Sin embargo, para instalaciones nuevas, lo correcto es usar el comando openclaw.
Aunque aparezcan advertencias de deprecación, la instalación se ha completado correctamente. Si ves added NNN packages, todo está bien.
Configuración inicial de OpenClaw
# Iniciar el asistente de configuración (--install-daemon también registra el servicio de systemd)
openclaw onboard --install-daemon
El asistente te preguntará lo siguiente en orden:
① Consentimiento de seguridad — Reconocimiento de riesgos sobre los permisos de los agentes. Selecciona Yes para continuar.
② Modo de incorporación — Selecciona QuickStart (puedes ajustar la configuración después con openclaw configure).
③ Modelo predeterminado — Puedes continuar con el valor por defecto. Existe un mecanismo para sincronizar automáticamente la autenticación desde la CLI de Claude.
Nota: Cambio en OAuth de Anthropic En enero de 2026, Anthropic discontinuó el acceso OAuth de terceros. Si la sincronización de autenticación con la CLI de Claude no está disponible, necesitarás configurar una clave de API de Anthropic (pago por uso) en
~/.openclaw/openclaw.json.
④ Selección de canales — Configura los canales que necesites, o selecciona Skip for now. Si necesitas integración con Discord, puedes configurarla después con openclaw channels login.
⑤ Skills / Hooks — En la primera ejecución, lo más seguro es seleccionar No / Skip para completar el asistente.
Verificar el funcionamiento
# Confirmar versión y sincronización de autenticación
openclaw --version
# Verificar el inicio del Gateway
openclaw gateway
# → Si muestra: Control UI: http://127.0.0.1:18789/ es que funciona correctamente
# → Presiona Ctrl+C para detenerlo por ahora
# Verificar el estado del servicio de systemd
systemctl --user status openclaw-gateway.service
# Ejecutar una verificación de salud integral
openclaw doctor
Nota de seguridad: Enlace del Canvas Host El componente Canvas Host de OpenClaw se enlaza a
0.0.0.0por defecto (accesible desde todos los dispositivos en la red local). Se recomienda restringirlo a loopback añadiendo lo siguiente en~/.openclaw/openclaw.json:{ "gateway": { "bind": "loopback" } }
Migrar configuración anterior (opcional)
Si deseas conservar la configuración de la era de clawdbot. El formato del archivo de configuración es compatible.
# Copiar configuración desde el respaldo
cp -r ~/claw-backup/.clawdbot-bak/* ~/.openclaw/
# Verificar la consistencia de la configuración
openclaw doctor --fix
Los tokens del Gateway no se migran (se generan nuevos). Los tokens del lado del cliente utilizados para la Control UI o conexiones WebSocket también necesitarán ser actualizados.
Revocar tokens OAuth (opcional)
Los tokens OAuth de servicios externos conectados durante la era de clawdbot permanecen en los servidores del proveedor del servicio incluso después de desinstalar. Por seguridad, si ya no son necesarios, debes revocarlos manualmente en cada servicio.
- Google — Cuenta → Seguridad → Acceso de terceros
- Discord — Configuración de usuario → Aplicaciones autorizadas → Desautorizar
- Slack — slack.com/apps/manage → Buscar la aplicación y eliminarla
- GitHub — Settings → Applications → Authorized OAuth Apps
- Telegram — Revocar el token anterior a través de BotFather
Referencia rápida (listo para copiar y pegar)
Resumen consolidado de comandos para ejecución en un solo paso, asumiendo que comprendes todo lo anterior.
Fase 1: Eliminación completa de clawdbot
# Detener y eliminar servicio
systemctl --user stop clawdbot-gateway.service 2>/dev/null
systemctl --user disable clawdbot-gateway.service 2>/dev/null
rm -f ~/.config/systemd/user/clawdbot-gateway.service
systemctl --user daemon-reload
pkill -f clawdbot || true
# Respaldo
mkdir -p ~/claw-backup
[ -d ~/.clawdbot ] && cp -r ~/.clawdbot ~/claw-backup/.clawdbot-bak
[ -d ~/.moltbot ] && cp -r ~/.moltbot ~/claw-backup/.moltbot-bak
# Eliminar paquetes npm
npm uninstall -g clawdbot
npm uninstall -g moltbot
# Eliminar directorios de configuración
rm -rf ~/.clawdbot ~/.moltbot
Fase 2: Instalación nueva de OpenClaw
# Instalar
npm install -g openclaw@latest
# Configuración inicial (con registro de daemon)
openclaw onboard --install-daemon
# Verificación de salud
openclaw doctor
Referencias: openclaw/openclaw | Documentación oficial de desinstalación | Issue #5103 (Problema de migración)
Creado: 2026-03-14 | Última versión: v2026.3.11 | Objetivo: Entornos Ubuntu + nvm + systemd
