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:

  1. Primero ejecuta el «método de desinstalación recomendado» o «limpieza manual de restos de servicios» para detener y desinstalar el servicio Gateway
  2. Elimina el directorio del repositorio de código fuente

    # 替换为你的源码路径
    rm -rf /path/to/openclaw-repo
  3. 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:

  • Ejecutaopenclaw --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
  • 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.service
Otras extensiones