OpenClaw アンインストールガイド
この記事では、CLI、Gateway サービス、設定ファイル、ワークスペースデータを含む OpenClaw を完全にアンインストールする方法を紹介します。
OpenClaw のアンインストールには2つのケースがあります:
- CLI がまだ存在する場合(推奨方法)
- CLI は削除済みだがバックグラウンドサービスがまだ実行中の場合(手動クリーンアップ)
一、推奨方法(CLI がまだ存在する場合)
システムでまだ openclaw コマンドを実行できる場合は、組み込みのアンインストールコマンドを使用することをお勧めします。
1. 標準アンインストール
openclaw uninstall
このコマンドは以下を削除します:
- Gateway サービス
- ローカル状態データ
- 設定ファイル
- Agent 作業ディレクトリなどのデータ
2. 非対話式アンインストール(自動化スクリプト)
CI や自動化スクリプト環境に適しています:
# 直接执行 openclaw uninstall --all --yes --non-interactive # 无本地 CLI 时,通过 npx 执行 npx -y openclaw uninstall --all --yes --non-interactive
- uninstall:アンインストーラー
- --all:サービスとローカルデータをまとめて削除します(ゲートウェイサービス、設定ファイル、データベースなどを含む)
- --yes:自動確認により、途中で何度も手動で Y を入力する必要がなくなります
二、手動アンインストール(完全クリーンアップ)
アンインストールプロセスを完全に制御したい場合は、以下の手順に従って手動でクリーンアップできます。
1. Gateway サービスの停止
openclaw gateway stop
2. Gateway サービスのアンインストール
openclaw gateway uninstall
この手順では、システム内のバックグラウンドサービスを削除します:
- macOS:launchd
- Linux:systemd
- Windows:Scheduled Tasks
3. 設定ファイルと状態ディレクトリの削除
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
デフォルトディレクトリ:
~/.openclaw
これには以下が含まれます:
- 設定ファイル
- Token
- Session
- ログ
- Agent 状態データ
カスタム環境変数を設定した場合:
OPENCLAW_CONFIG_PATH
対応するファイルも手動で削除する必要があります。
4. Agent ワークスペースの削除(任意)
rm -rf ~/.openclaw/workspace
このディレクトリには通常、以下が保存されます:
- Agent が生成したコード
- タスク実行ファイル
- 中間データ
5 CLI の削除
インストール方法に応じて対応するコマンドを選択します:
# npm 安装 npm rm -g openclaw # pnpm 安装 pnpm remove -g openclaw # bun 安装 bun remove -g openclaw
6. macOS アプリの削除(インストールされている場合)
rm -rf /Applications/OpenClaw.app
三、CLI がないがサービスがまだ実行中の場合
CLI を削除済みでも、OpenClaw Gateway がバックグラウンドで実行中の場合は、システムサービスを手動で削除できます。
1. macOS(launchd サービス)
デフォルトのサービスラベル:bot.molt.gateway(複数設定はbot.molt.<profile>、旧バージョンは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(systemd ユーザーサービス)
デフォルトのサービス名:openclaw-gateway.service(複数設定は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(タスクスケジューラ)
デフォルトのタスク名:OpenClaw Gateway(複数設定は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"
四、Docker インストールのアンインストール方法
OpenClaw が Docker で実行されている場合:
docker stop openclaw docker rm openclaw docker volume rm openclaw-data
或
docker-compose down -v
五、ソースコードインストール(git clone)のアンインストール
もしgit cloneソースコード方式でインストールした場合は、先にサービスをクリーンアップし、その後ソースコードと設定を削除する必要があります:
- 先に「推奨アンインストール方法」または「手動でのサービス残骸クリーンアップ」を実行し、Gateway サービスを停止してアンインストールします
ソースコードリポジトリのディレクトリを削除します
# 替换为你的源码路径 rm -rf /path/to/openclaw-repo
- 前述の手順に従って、状態、設定、ワークスペースのディレクトリを削除します
六、アンインストール前のバックアップ推奨
データを保持する必要がある場合は、先にバックアップを作成できます:
openclaw backup create
その後、アンインストールを実行します。
アンインストールの検証
アンインストール完了後、以下の方法で完全にクリーンアップされたかを検証できます:
- 実行
openclaw --version、「コマンドが見つかりません」と表示されれば CLI のアンインストールは成功です - システムサービスの確認:
- macOS:
launchctl list | grep molt出力なし - Linux:
systemctl --user list-units | grep openclaw出力なし - Windows:タスクスケジューラに「OpenClaw Gateway」関連のタスクがないこと
- macOS:
- ディレクトリの確認:
~/.openclaw(および複数設定の~/.openclaw-<profile>)が削除されていること
七、よくある残留ディレクトリ
完全アンインストール時は、以下のディレクトリを確認することをお勧めします:
~/.openclaw ~/.openclaw/workspace ~/Library/LaunchAgents/ai.openclaw.gateway.plist ~/.config/systemd/user/openclaw-gateway.serviceその他の拡張