Desinstalar OpenClaw en macOS sin servicios residuales

Desinstalar OpenClaw en macOS implica más que arrastrar una app a la Papelera. Los LaunchAgents mantienen la puerta de enlace en ejecución, los directorios de estado por perfil permanecen en tu carpeta de inicio y los secretos de API en caché siguen ahí hasta que los eliminas. Aquí tienes una desinstalación específica para Mac para poder eliminar todo de forma segura.

Resumen rápido

Prepara tu Mac con copias de seguridad e inventario de perfiles

Esto captura espacios de trabajo de agentes, transcripciones de cron y secretos para que puedas restaurarlos en otro lugar.

Enumera cada perfil: busca ~/.openclaw, ~/.openclaw-<profile> y cualquier valor personalizado de OPENCLAW_STATE_DIR para saber qué eliminar más adelante.

Documenta los conectores: anota qué tokens de Slack, Google, Notion o Discord se emparejaron con tu Mac; tendrás que revocarlos manualmente.

Detén y desinstala la puerta de enlace

Las desinstalaciones en Mac fallan cuando launchd todavía supervisa la puerta de enlace. Ejecuta el flujo compatible desde la CLI:

1. gateway uninstall elimina el LaunchAgent ai.openclaw.gateway antes de que empieces a borrar archivos.
2. El comando unificado openclaw uninstall ejecuta los mismos pasos automáticamente si prefieres un solo comando.

Elimina LaunchAgents y activadores de inicio de sesión

Incluso después de ejecutar la CLI, vuelve a comprobar launchd:

Repite el proceso para cada etiqueta de perfil (ai.openclaw.<profile>). Si experimentaste con compilaciones heredadas, elimina también cualquier archivo com.openclaw.*.plist.

Limpieza de archivos sobrantes de OpenClaw

Una eliminación completa depende de borrar los directorios de estado mencionados antes:

1. Sustituye <profile> por cada nombre de perfil que usaste en este Mac.
2. Si montaste un espacio de trabajo personalizado en otro lugar, elimina también esa ruta.
3. Elimina cualquier favorito del Dock o del Finder que apuntara al espacio de trabajo para que macOS no vuelva a crear metadatos más adelante.

Elimina la CLI, el paquete de la app y los shells

Eliminación de la CLI (elige tu instalador):

Autocompletados de shell (si se instalaron): elimina cualquier entrada de openclaw de /usr/local/share/zsh/site-functions o ~/.config/fish/completions si las copiaste manualmente.

Rota claves de API y permisos de escritorio

1. Revoca tokens en Slack, Google Cloud Console, Discord, GitHub, Notion y cualquier endpoint de webhook personalizado que OpenClaw haya usado en este Mac.
2. Elimina los permisos de grabación de pantalla, micrófono y accesibilidad en Ajustes del Sistema → Privacidad y seguridad para que macOS olvide OpenClaw por completo.

Verifica que todo haya desaparecido

Ejecuta estas comprobaciones después de la limpieza:

Si algún comando todavía informa de un servicio o binario, vuelve a las secciones anteriores y repite el paso de limpieza correspondiente.

Preguntas frecuentes

¿Cómo lo reinstalo más adelante?

Después de que fallen los comandos de verificación (lo que significa éxito), vuelve a ejecutar el instalador que prefieras (npm install -g openclaw, install.sh, etc.) y completa la incorporación como si fuera un Mac nuevo.

¿Necesito sudo para algún paso?

No. OpenClaw se ejecuta como una tarea launchd a nivel de usuario. Usa tu cuenta estándar para cada comando de desinstalación a fin de garantizar que tocas los directorios correctos.

¿Qué pasa si usé varios perfiles?

Repite la eliminación del LaunchAgent y el borrado del directorio para cada plist ai.openclaw.<profile> y directorio ~/.openclaw-<profile>. Los perfiles son independientes, así que no desaparecerán hasta que los elimines individualmente.

¿Por qué eliminar el espacio de trabajo si ya ejecuté openclaw uninstall?

La CLI solo elimina el directorio de estado. Los espacios de trabajo pueden vivir en cualquier lugar, así que la eliminación manual es la única forma de garantizar que desaparezcan de este Mac.