OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Desinstalar

Dos rutas:

  • Ruta sencilla si openclaw todavía está instalado.
  • Eliminación manual del servicio si la CLI ya no está disponible, pero el servicio sigue ejecutándose.

Ruta sencilla (la CLI sigue instalada)

Recomendación: usar el desinstalador integrado:

bash
openclaw uninstall

La eliminación del estado conserva los directorios de espacio de trabajo configurados, a menos que también se seleccione --workspace.

Vista previa de lo que se eliminará (seguro):

bash
openclaw uninstall --dry-run --all

Sin interacción (automatización / npx). Usar con precaución y solo después de confirmar los ámbitos:

bash
openclaw uninstall --all --yes --non-interactivenpx -y openclaw uninstall --all --yes --non-interactive

Opciones: --service, --state, --workspace, --app seleccionan ámbitos individuales; --all selecciona los cuatro.

Pasos manuales (mismo resultado):

  1. Detener el servicio del Gateway:
bash
openclaw gateway stop
  1. Desinstalar el servicio del Gateway (launchd/systemd/schtasks):
bash
openclaw gateway uninstall
  1. Eliminar el estado y la configuración:
bash
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

Si se estableció OPENCLAW_CONFIG_PATH en una ubicación personalizada fuera del directorio de estado, eliminar también ese archivo. Si se desea conservar un espacio de trabajo dentro del directorio de estado, como ~/.openclaw/workspace, moverlo a otra ubicación antes de ejecutar rm -rf o eliminar selectivamente el contenido del estado.

  1. Eliminar el espacio de trabajo (opcional; elimina los archivos del agente):
bash
rm -rf ~/.openclaw/workspace
  1. Eliminar la instalación de la CLI (elegir el método utilizado):
bash
npm rm -g openclawpnpm remove -g openclawbun remove -g openclaw
  1. Si se instaló la aplicación para macOS:
bash
rm -rf /Applications/OpenClaw.app

Notas:

  • Si se usaron perfiles (--profile / OPENCLAW_PROFILE), repetir el paso 3 para cada directorio de estado (los valores predeterminados son ~/.openclaw-<profile>).
  • En modo remoto, el directorio de estado se encuentra en el host del Gateway, por lo que también deben ejecutarse allí los pasos 1-4.

Eliminación manual del servicio (CLI no instalada)

Usar este método si el servicio del Gateway sigue ejecutándose, pero falta openclaw.

macOS (launchd)

La etiqueta predeterminada es ai.openclaw.gateway (o ai.openclaw.<profile> con un perfil):

bash
launchctl bootout gui/$UID/ai.openclaw.gatewayrm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

Si se usó un perfil, sustituir la etiqueta y el nombre del archivo plist por ai.openclaw.<profile>.

Linux (unidad de usuario de systemd)

El nombre predeterminado de la unidad es openclaw-gateway.service (o openclaw-gateway-<profile>.service). Es posible que todavía exista una unidad clawdbot-gateway.service anterior al cambio de nombre en equipos actualizados desde instalaciones muy antiguas; openclaw uninstall / openclaw gateway uninstall la detecta y elimina automáticamente.

bash
systemctl --user disable --now openclaw-gateway.servicerm -f ~/.config/systemd/user/openclaw-gateway.servicesystemctl --user daemon-reload

Windows (tarea programada)

El nombre predeterminado de la tarea es OpenClaw Gateway (o OpenClaw Gateway (<profile>)). La tarea inicia un script gateway.vbs sin ventana dentro del directorio de estado, que a su vez ejecuta gateway.cmd; eliminar ambos.

powershell
schtasks /Delete /F /TN "OpenClaw Gateway"Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinueRemove-Item -Force "$env:USERPROFILE\.openclaw\gateway.vbs" -ErrorAction SilentlyContinue

Si se usó un perfil, eliminar el nombre de tarea correspondiente y los archivos gateway.cmd / gateway.vbs de ~\.openclaw-<profile>.

Instalación normal frente a repositorio de código fuente

Instalación normal (install.sh / npm / pnpm / bun)

Si se usó https://openclaw.ai/install.sh o install.ps1, la CLI se instaló con npm install -g openclaw@latest. Eliminarla con npm rm -g openclaw (o pnpm remove -g / bun remove -g si se instaló de ese modo).

Repositorio de código fuente (git clone)

Si se ejecuta desde una copia local del repositorio (git clone + openclaw ... / bun run openclaw ...):

  1. Desinstalar el servicio del Gateway antes de eliminar el repositorio (usar la ruta sencilla anterior o la eliminación manual del servicio).
  2. Eliminar el directorio del repositorio.
  3. Eliminar el estado y el espacio de trabajo como se muestra anteriormente.

Contenido relacionado

Was this useful?
On this page

On this page