OpenClaw Guía de desinstalación
Este artículo explica cómo desinstalar completamente OpenClaw, incluyendo la CLI, el servicio Gateway, los archivos de configuración y los datos del espacio de trabajo.
Hay dos situaciones para desinstalar OpenClaw:
- La CLI aún existe (método recomendado)
- La CLI se ha eliminado pero el servicio en segundo plano sigue en ejecución (limpieza manual)
I. Método recomendado (CLI aún existe)
Si el comando openclaw aún se puede ejecutar en el sistema, se recomienda usar el comando de desinstalación integrado.
1. Desinstalación estándar
openclaw uninstall
Este comando eliminará:
- El servicio Gateway
- Los datos de estado local
- Los archivos de configuración
- El directorio de trabajo del Agent y otros datos
2. Desinstalación no interactiva (script automatizado)
Adecuado para entornos de CI o scripts automatizados:
# 直接执行 openclaw uninstall --all --yes --non-interactive # 无本地 CLI 时,通过 npx 执行 npx -y openclaw uninstall --all --yes --non-interactive
- uninstall: programa de desinstalación
- --all: elimina servicios y datos locales juntos (incluido el servicio Gateway, archivos de configuración, base de datos, etc.)
- --yes: confirmación automática, ya no tendrás que ingresar Y manualmente una y otra vez
II. Desinstalación manual (limpieza completa)
Si deseas tener control total sobre el proceso de desinstalación, puedes limpiar manualmente siguiendo los pasos a continuación.
1. Detener el servicio Gateway
openclaw gateway stop
2. Desinstalar el servicio Gateway
openclaw gateway uninstall
Este paso eliminará el servicio en segundo plano del sistema:
- macOS:launchd
- Linux:systemd
- Windows:Scheduled Tasks
3. Eliminar los directorios de configuración y estado
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
Directorio predeterminado:
~/.openclaw
Contiene:
- Archivos de configuración
- Token
- Session
- Registros
- Datos de estado del Agent
Si se han configurado variables de entorno personalizadas:
OPENCLAW_CONFIG_PATH
También es necesario eliminar los archivos correspondientes manualmente.
4. Eliminar el espacio de trabajo del Agent (opcional)
rm -rf ~/.openclaw/workspace
Este directorio normalmente almacena:
- Código generado por el Agent
- Archivos de ejecución de tareas
- Datos intermedios
5. Eliminar la CLI
Elige el comando correspondiente según el método de instalación:
# npm 安装 npm rm -g openclaw # pnpm 安装 pnpm remove -g openclaw # bun 安装 bun remove -g openclaw
6. Eliminar la aplicación de macOS (si está instalada)
rm -rf /Applications/OpenClaw.app
III. La CLI se perdió pero el servicio sigue en ejecución
Si la CLI ya se ha eliminado pero OpenClaw Gateway sigue ejecutándose en segundo plano, puedes eliminar el servicio del sistema manualmente.
1. macOS (servicio launchd)
Etiqueta de servicio predeterminada:bot.molt.gateway(multi-configuración comobot.molt.<profile>, versión anterior comocom.openclaw.*)
# 停止并卸载服务 launchctl bootout gui/$UID/bot.molt.gateway # 删除服务配置文件 rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist # 多配置场景:替换为对应 profile 标签 # launchctl bootout gui/$UID/bot.molt.<profile> # rm -f ~/Library/LaunchAgents/bot.molt.<profile>.plist # 清理旧版残留(如有) rm -f ~/Library/LaunchAgents/com.openclaw.*.plist
2. Linux (servicio de usuario systemd)
Nombre de servicio predeterminado:openclaw-gateway.service(multi-configuración comoopenclaw-gateway-<profile>.service)
# 停止并禁用服务 systemctl --user disable --now openclaw-gateway.service # 删除服务配置文件 rm -f ~/.config/systemd/user/openclaw-gateway.service # 刷新 systemd 配置 systemctl --user daemon-reload # 多配置场景:替换为对应 profile 服务名 # systemctl --user disable --now openclaw-gateway-<profile>.service # rm -f ~/.config/systemd/user/openclaw-gateway-<profile>.service # systemctl --user daemon-reload
3. Windows (tarea programada)
Nombre de tarea predeterminado:OpenClaw Gateway(multi-configuración comoOpenClaw Gateway (<profile>))
# 删除计划任务 schtasks /Delete /F /TN "OpenClaw Gateway" # 删除任务脚本 Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" # 多配置场景:替换为对应 profile 任务名 # schtasks /Delete /F /TN "OpenClaw Gateway (<profile>)" # Remove-Item -Force "$env:USERPROFILE\.openclaw-<profile>\gateway.cmd"
IV. Método de desinstalación para instalación con Docker
Si OpenClaw se ejecuta en Docker:
docker stop openclaw docker rm openclaw docker volume rm openclaw-data
o
docker-compose down -v
V. Desinstalación de instalación desde código fuente (git clone)
Si se instaló mediantegit cloneel método de código fuente, primero debes limpiar los servicios y luego eliminar el código fuente y la configuración:
- Primero ejecuta el «método de desinstalación recomendado» o «limpieza manual de restos de servicios» para detener y desinstalar el servicio Gateway
Elimina el directorio del repositorio de código fuente
# 替换为你的源码路径 rm -rf /path/to/openclaw-repo
- Sigue los pasos anteriores para eliminar los directorios de estado, configuración y espacio de trabajo
VI. Se recomienda hacer una copia de seguridad antes de desinstalar
Si necesitas conservar los datos, puedes crear una copia de seguridad primero:
openclaw backup create
Luego ejecuta la desinstalación.
Verificación de desinstalación
Una vez completada la desinstalación, puedes verificar si la limpieza fue exhaustiva de las siguientes maneras:
- Ejecuta
openclaw --version, si aparece «comando no encontrado», la CLI se desinstaló correctamente - Comprueba los servicios del sistema:
- macOS:
launchctl list | grep moltSin salida - Linux:
systemctl --user list-units | grep openclawSin salida - Windows: no hay tareas relacionadas con «OpenClaw Gateway» en el Programador de tareas
- macOS:
- Comprueba los directorios:
~/.openclaw(y multi-configuración~/.openclaw-<profile>) han sido eliminados
VII. Directorios residuales comunes
Al desinstalar por completo, se recomienda comprobar los siguientes directorios:
~/.openclaw ~/.openclaw/workspace ~/Library/LaunchAgents/ai.openclaw.gateway.plist ~/.config/systemd/user/openclaw-gateway.serviceOtras extensiones