Saltar al contenido principal

Desinstalar

Hay dos rutas:
  • Ruta fácil si openclaw sigue instalado.
  • Eliminación manual del servicio si la CLI ya no está pero el servicio sigue ejecutándose.

Ruta fácil (la CLI sigue instalada)

Recomendado: usa el desinstalador integrado:
openclaw uninstall
Modo no interactivo (automatización / npx):
openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive
Pasos manuales (mismo resultado):
  1. Detén el servicio de gateway:
openclaw gateway stop
  1. Desinstala el servicio de gateway (launchd/systemd/schtasks):
openclaw gateway uninstall
  1. Elimina estado + configuración:
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
Si estableciste OPENCLAW_CONFIG_PATH en una ubicación personalizada fuera del directorio de estado, elimina también ese archivo.
  1. Elimina tu espacio de trabajo (opcional, elimina archivos del agente):
rm -rf ~/.openclaw/workspace
  1. Elimina la instalación de la CLI (elige la que usaste):
npm rm -g openclaw
pnpm remove -g openclaw
bun remove -g openclaw
  1. Si instalaste la app de macOS:
rm -rf /Applications/OpenClaw.app
Notas:
  • Si usaste perfiles (--profile / OPENCLAW_PROFILE), repite el paso 3 para cada directorio de estado (los predeterminados son ~/.openclaw-<profile>).
  • En modo remoto, el directorio de estado vive en el host de la gateway, así que ejecuta también allí los pasos 1-4.

Eliminación manual del servicio (CLI no instalada)

Úsala si el servicio de gateway sigue ejecutándose pero openclaw no existe.

macOS (launchd)

La etiqueta predeterminada es ai.openclaw.gateway (o ai.openclaw.<profile>; la heredada com.openclaw.* puede seguir existiendo):
launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
Si usaste un perfil, reemplaza la etiqueta y el nombre del plist por ai.openclaw.<profile>. Elimina cualquier plist heredado com.openclaw.* si existe.

Linux (unidad de usuario systemd)

El nombre predeterminado de la unidad es openclaw-gateway.service (o openclaw-gateway-<profile>.service):
systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

Windows (Scheduled Task)

El nombre predeterminado de la tarea es OpenClaw Gateway (o OpenClaw Gateway (<profile>)). El script de la tarea vive en tu directorio de estado.
schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"
Si usaste un perfil, elimina el nombre de tarea correspondiente y ~\.openclaw-<profile>\gateway.cmd.

Instalación normal frente a checkout del código fuente

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

Si usaste https://openclaw.ai/install.sh o install.ps1, la CLI se instaló con npm install -g openclaw@latest. Elimínala con npm rm -g openclaw (o pnpm remove -g / bun remove -g si la instalaste de esa forma).

Checkout del código fuente (git clone)

Si ejecutas desde un checkout del repositorio (git clone + openclaw ... / bun run openclaw ...):
  1. Desinstala el servicio de gateway antes de eliminar el repositorio (usa la ruta fácil anterior o la eliminación manual del servicio).
  2. Elimina el directorio del repositorio.
  3. Elimina estado + espacio de trabajo como se muestra arriba.