Maintenance
Désinstaller
Deux chemins :
- Chemin simple si
openclawest toujours installé. - Suppression manuelle du service si la CLI a disparu mais que le service fonctionne encore.
Chemin simple (CLI toujours installée)
Recommandé : utilisez le programme de désinstallation intégré :
openclaw uninstallLorsque vous utilisez la CLI, la suppression de l’état conserve les répertoires de travail configurés, sauf si vous sélectionnez aussi --workspace.
Prévisualiser ce qui sera supprimé (sans danger) :
openclaw uninstall --dry-run --allNon interactif (automatisation / npx). À utiliser avec prudence et uniquement après confirmation des périmètres :
openclaw uninstall --all --yes --non-interactivenpx -y openclaw uninstall --all --yes --non-interactiveÉtapes manuelles (même résultat) :
- Arrêter le service Gateway :
openclaw gateway stop- Désinstaller le service Gateway (launchd/systemd/schtasks) :
openclaw gateway uninstall- Supprimer l’état + la configuration :
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"Si vous avez défini OPENCLAW_CONFIG_PATH vers un emplacement personnalisé en dehors du répertoire d’état, supprimez aussi ce fichier.
Si vous voulez conserver un espace de travail dans le répertoire d’état, comme ~/.openclaw/workspace, déplacez-le avant d’exécuter rm -rf ou supprimez sélectivement le contenu de l’état.
- Supprimer votre espace de travail (facultatif, supprime les fichiers d’agent) :
rm -rf ~/.openclaw/workspace- Supprimer l’installation de la CLI (choisissez celle que vous avez utilisée) :
npm rm -g openclawpnpm remove -g openclawbun remove -g openclaw- Si vous avez installé l’app macOS :
rm -rf /Applications/OpenClaw.appNotes :
- Si vous avez utilisé des profils (
--profile/OPENCLAW_PROFILE), répétez l’étape 3 pour chaque répertoire d’état (les valeurs par défaut sont~/.openclaw-<profile>). - En mode distant, le répertoire d’état se trouve sur l’hôte Gateway ; exécutez donc aussi les étapes 1 à 4 à cet endroit.
Suppression manuelle du service (CLI non installée)
Utilisez ceci si le service Gateway continue de fonctionner mais que openclaw est manquant.
macOS (launchd)
Le libellé par défaut est ai.openclaw.gateway (ou ai.openclaw.<profile> ; l’ancien com.openclaw.* peut encore exister) :
launchctl bootout gui/$UID/ai.openclaw.gatewayrm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plistSi vous avez utilisé un profil, remplacez le libellé et le nom du plist par ai.openclaw.<profile>. Supprimez tous les plists hérités com.openclaw.* s’ils sont présents.
Linux (unité utilisateur systemd)
Le nom d’unité par défaut est openclaw-gateway.service (ou openclaw-gateway-<profile>.service) :
systemctl --user disable --now openclaw-gateway.servicerm -f ~/.config/systemd/user/openclaw-gateway.servicesystemctl --user daemon-reloadWindows (tâche planifiée)
Le nom de tâche par défaut est OpenClaw Gateway (ou OpenClaw Gateway (<profile>)).
Le script de tâche se trouve sous votre répertoire d’état sous le nom gateway.cmd ; les installations actuelles peuvent
aussi créer un lanceur sans fenêtre gateway.vbs que le Planificateur de tâches exécute à la place
de l’ouverture directe de gateway.cmd.
schtasks /Delete /F /TN "OpenClaw Gateway"Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinueRemove-Item -Force "$env:USERPROFILE\.openclaw\gateway.vbs" -ErrorAction SilentlyContinueSi vous avez utilisé un profil, supprimez le nom de tâche correspondant et les fichiers gateway.cmd /
gateway.vbs sous ~\.openclaw-<profile>.
Installation normale vs copie de travail source
Installation normale (install.sh / npm / pnpm / bun)
Si vous avez utilisé https://openclaw.ai/install.sh ou install.ps1, la CLI a été installée avec npm install -g openclaw@latest.
Supprimez-la avec npm rm -g openclaw (ou pnpm remove -g / bun remove -g si vous l’avez installée de cette façon).
Copie de travail source (git clone)
Si vous exécutez depuis une copie de travail du dépôt (git clone + openclaw ... / bun run openclaw ...) :
- Désinstallez le service Gateway avant de supprimer le dépôt (utilisez le chemin simple ci-dessus ou la suppression manuelle du service).
- Supprimez le répertoire du dépôt.
- Supprimez l’état + l’espace de travail comme indiqué ci-dessus.