Guide de désinstallationmacOS / Linux / WindowsDocker / Podman / Nix / Ansible

Guide complet de désinstallation OpenClaw

Ce n’est pas juste « supprimer une app » : il faut gérer les services de passerelle en arrière-plan, les répertoires d’état/config, les résidus de déploiement conteneurisé et (fortement recommandé) révoquer les permissions et clés accordées.

Ordre recommandé

D’abord openclaw uninstall ou arrêter le service → puis désinstaller la CLI.

Copie en un clic

Bouton de copie en haut à droite de chaque bloc de commande.

Finition sécurité

Après désinstallation, révoquez l’OAuth / faites tourner les clés API.

Step 0

D’abord repérer : comment avez‑vous installé ?

Selon la méthode d’installation, le chemin de désinstallation change. Trouvez la vôtre en 10 secondes.

A. Installation locale

La commande openclaw fonctionne, UI/service peut tourner en arrière‑plan.

Voir la section

B. CLI absente

La commande openclaw a disparu, mais service/processus encore actifs.

Voir la section

C/D. Conteneurs

Vous avez utilisé docker-setup.sh ou setup-podman.sh.

Voir la section

E/F. Nix / Ansible

Déployé via nix-openclaw ou openclaw-ansible.

Voir la section

Step 1

Désinstallation officielle (CLI présente)

Si la commande openclaw fonctionne encore, utilisez d’abord le désinstalleur intégré.

1.1 Une commande (recommandé)

Pour la plupart des utilisateurs : désinstallation interactive.

bash

openclaw uninstall

1.2 Automatisation / Sans interaction

Pour les environnements automatisés, sauter les invites.

bash

openclaw uninstall --all --yes --non-interactive

# 或者 npx 直接跑
npx -y openclaw uninstall --all --yes --non-interactive

Step 2

CLI absente mais service actif

Quand la commande openclaw est absente mais que les services tournent encore.

macOS (launchd)

Label par défaut : ai.openclaw.gateway (noms historiques possibles). Arrêter le service puis supprimer le plist.

bash

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

Vérifier les anciens noms :

bash

ls -1 ~/Library/LaunchAgents | grep -Ei 'openclaw|clawd|clawdbot|molt'
launchctl list | grep -Ei 'openclaw|clawd|clawdbot|molt'

Linux (systemd user)

Unit par défaut : openclaw-gateway.service (suffixe ajouté par le profile).

bash

systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

Vérifier :

bash

systemctl --user list-unit-files | grep -i openclaw
systemctl --user status openclaw-gateway.service

Windows (Scheduled Task)

Nom de tâche par défaut : OpenClaw Gateway (suffixe ajouté par le profile).

powershell

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

Step 3

Supprimer les résidus

Nettoyer état/config/espace de travail et anciens répertoires.

Chemins par défaut

État/config et workspace sont par défaut dans ~/.openclaw

bash

rm -rf ~/.openclaw

Répertoires hérités (optionnel)

Si vous avez utilisé une ancienne version, vérifiez ces dossiers.

bash

rm -rf ~/.clawdbot
rm -rf ~/clawdbot

Step 4

Docker / Podman

Retirer la passerelle conteneurisée et nettoyer les données hôte.

Docker Compose

Exécuter dans le répertoire du dépôt pour arrêter et supprimer les conteneurs.

bash

docker compose down

docker compose down -v

Supprimer le répertoire persistant hôte :

bash

rm -rf ~/.openclaw

Podman (rootless)

Arrêter le service Quadlet si utilisé, puis supprimer conteneur et données.

bash

sudo systemctl --machine openclaw@ --user stop openclaw.service
sudo -u openclaw podman rm -f openclaw

Supprimer les données hôte en mode Podman :

bash

sudo rm -rf /home/openclaw/.openclaw
sudo rm -f /home/openclaw/.config/containers/systemd/openclaw.container
sudo systemctl --machine openclaw@ --user daemon-reload

Step 5

Nix / Ansible

Pour les déploiements Nix / Ansible.

Nix / Home Manager

Retirer le module nix-openclaw ou le désactiver, puis réappliquer.

bash

home-manager switch

home-manager switch --rollback

Si besoin, supprimer votre répertoire d’état (peut être personnalisé).

Ansible (openclaw-ansible)

Arrêter et désactiver le service, puis supprimer les chemins d’installation et données.

bash

sudo systemctl stop openclaw
sudo systemctl disable openclaw

sudo rm -rf /opt/openclaw
sudo rm -rf /home/openclaw/openclaw
sudo rm -rf /home/openclaw/.openclaw

Supprimez l’utilisateur openclaw uniquement si vous êtes certain.

bash

sudo userdel -r openclaw

Step 6

Auto‑vérification post‑désinstallation

Confirmez que services, ports et dossiers locaux sont nettoyés.

Step 7

Révoquer l’accès et tourner les clés

Désinstaller n’est pas révoquer. Effectuez le minimum de sécurité.

Au minimum, faites ces trois actions :

Faites tourner toutes les clés API données à OpenClaw (invalider les anciennes).
Déconnecter/supprimer les sessions suspectes (chat, email, console cloud, etc.).
Révoquer les autorisations OAuth/App (Google/Microsoft/GitHub, etc.).

Chaque plateforme diffère ; suivez les centres de sécurité correspondants.