Guide de désinstallation d'OpenClaw

Cet article explique comment désinstaller complètement OpenClaw, y compris la CLI, le service Gateway, les fichiers de configuration et les données de l'espace de travail.

Il existe deux scénarios pour désinstaller OpenClaw :

  • La CLI existe toujours (approche recommandée)
  • La CLI a été supprimée, mais les services en arrière-plan sont toujours en cours d'exécution (nettoyage manuel)

I. Approche recommandée (la CLI existe toujours)

Si la commande openclaw peut encore être exécutée sur votre système, il est recommandé d'utiliser la commande de désinstallation intégrée.

1. Désinstallation standard

openclaw uninstall

Cette commande supprimera :

  • Service Gateway
  • Données d'état locales
  • Fichiers de configuration
  • Données telles que le répertoire de travail de l'Agent

2. Désinstallation non interactive (scripts d'automatisation)

Convient aux environnements CI ou de scripts automatisés :

# 直接执行
openclaw uninstall --all --yes --non-interactive

# 无本地 CLI 时，通过 npx 执行
npx -y openclaw uninstall --all --yes --non-interactive
  • uninstall: Désinstalleur
  • --all: Supprime les services et les données locales ensemble (y compris le service de passerelle, les fichiers de configuration, la base de données, etc.)
  • --yes: Confirme automatiquement, ainsi vous n'avez pas à saisir manuellement Y à plusieurs reprises

II. Désinstallation manuelle (nettoyage complet)

Si vous souhaitez un contrôle total sur le processus de désinstallation, vous pouvez effectuer un nettoyage manuel en suivant les étapes ci-dessous.

1. Arrêter le service de passerelle

openclaw gateway stop

2. Désinstaller le service de passerelle

openclaw gateway uninstall

Cette étape supprimera les services d'arrière-plan du système :

  • macOS：launchd
  • Linux：systemd
  • Windows：Tâches planifiées

3. Supprimer les répertoires de configuration et d’état

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

Répertoires par défaut :

~/.openclaw

Cela comprend :

  • Fichiers de configuration
  • Token
  • Session
  • Journaux
  • Données d’état de l’agent

Si des variables d’environnement personnalisées ont été définies :

OPENCLAW_CONFIG_PATH

Vous devez également supprimer manuellement les fichiers correspondants.

4. Supprimer l’espace de travail de l’agent (facultatif)

rm -rf ~/.openclaw/workspace

Ce répertoire stocke généralement :

  • Code généré par l'agent
  • Fichiers d'exécution des tâches
  • Données intermédiaires

5. Supprimer le CLI

Sélectionnez la commande correspondante en fonction de la méthode d'installation :

# npm 安装
npm rm -g openclaw

# pnpm 安装
pnpm remove -g openclaw

# bun 安装
bun remove -g openclaw

6. Supprimer l'application macOS (si installée)

rm -rf /Applications/OpenClaw.app

III. CLI perdu mais services toujours en cours d'exécution

Si vous avez déjà supprimé le CLI mais qu'OpenClaw Gateway s'exécute toujours en arrière-plan, vous pouvez supprimer manuellement le service système.

1. macOS (service launchd)

Libellé du service par défaut :bot.molt.gateway(Pour une configuration multiple :bot.molt.<profile>, pour les anciennes versions :com.openclaw.*）

# 停止并卸载服务
launchctl bootout gui/$UID/bot.molt.gateway

# 删除服务配置文件
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

# 多配置场景：替换为对应 profile 标签
# launchctl bootout gui/$UID/bot.molt.<profile>
# rm -f ~/Library/LaunchAgents/bot.molt.<profile>.plist

# 清理旧版残留（如有）
rm -f ~/Library/LaunchAgents/com.openclaw.*.plist

2. Linux (service utilisateur systemd)

Nom du service par défaut :openclaw-gateway.service(Pour une configuration multiple :openclaw-gateway-<profile>.service）

# 停止并禁用服务
systemctl --user disable --now openclaw-gateway.service

# 删除服务配置文件
rm -f ~/.config/systemd/user/openclaw-gateway.service

# 刷新 systemd 配置
systemctl --user daemon-reload

# 多配置场景：替换为对应 profile 服务名
# systemctl --user disable --now openclaw-gateway-<profile>.service
# rm -f ~/.config/systemd/user/openclaw-gateway-<profile>.service
# systemctl --user daemon-reload

3. Windows (Tâche planifiée)

Nom de la tâche par défaut :OpenClaw Gateway(Pour une configuration multiple :OpenClaw Gateway (<profile>)）

# 删除计划任务
schtasks /Delete /F /TN "OpenClaw Gateway"

# 删除任务脚本
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

# 多配置场景：替换为对应 profile 任务名
# schtasks /Delete /F /TN "OpenClaw Gateway (<profile>)"
# Remove-Item -Force "$env:USERPROFILE\.openclaw-<profile>\gateway.cmd"

IV. Désinstallation des installations Docker

Si OpenClaw s'exécute dans Docker :

docker stop openclaw
docker rm openclaw
docker volume rm openclaw-data

ou

docker-compose down -v

V. Désinstallation de l'installation source (git clone)

Si installé viagit cloneune installation source, vous devez d'abord nettoyer le service, puis supprimer le code source et la configuration :

  1. Exécutez d'abord la « méthode de désinstallation recommandée » ou « nettoyez manuellement les restes du service » pour arrêter et désinstaller le service de passerelle

  2. Supprimez le répertoire du dépôt source

    # 替换为你的源码路径
rm -rf /path/to/openclaw-repo
  3. Supprimez les répertoires d'état, de configuration et d'espace de travail en suivant les étapes précédentes

VI. Sauvegarde recommandée avant la désinstallation

Si vous devez conserver des données, vous pouvez d'abord créer une sauvegarde :

openclaw backup create

Procédez ensuite à la désinstallation.

Vérification de la désinstallation

Après la désinstallation, vous pouvez vérifier si le nettoyage est complet des manières suivantes :

  • Exécutezopenclaw --version, si elle affiche "command not found", la CLI a été désinstallée avec succès
  • Vérifiez les services système :
    • macOS：launchctl list | grep moltAucune sortie
    • Linux：systemctl --user list-units | grep openclawAucune sortie
    • Windows : Aucune tâche liée à "OpenClaw Gateway" dans le Planificateur de tâches
  • Vérifiez les répertoires :~/.openclaw(et multi-config~/.openclaw-<profile>) ont été supprimés

VII. Répertoires résiduels courants

Lors d'une désinstallation complète, il est recommandé de vérifier les répertoires suivants :

~/.openclaw
~/.openclaw/workspace
~/Library/LaunchAgents/ai.openclaw.gateway.plist
~/.config/systemd/user/openclaw-gateway.service
Autres extensions