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ソースコード方式でインストールした場合は、先にサービスをクリーンアップし、その後ソースコードと設定を削除する必要があります:

  1. 先に「推奨アンインストール方法」または「手動でのサービス残骸クリーンアップ」を実行し、Gateway サービスを停止してアンインストールします
  2. ソースコードリポジトリのディレクトリを削除します

    # 替换为你的源码路径
    rm -rf /path/to/openclaw-repo
  3. 前述の手順に従って、状態、設定、ワークスペースのディレクトリを削除します

六、アンインストール前のバックアップ推奨

データを保持する必要がある場合は、先にバックアップを作成できます:

openclaw backup create

その後、アンインストールを実行します。

アンインストールの検証

アンインストール完了後、以下の方法で完全にクリーンアップされたかを検証できます:

  • 実行openclaw --version、「コマンドが見つかりません」と表示されれば CLI のアンインストールは成功です
  • システムサービスの確認:
    • macOS:launchctl list | grep molt出力なし
    • Linux:systemctl --user list-units | grep openclaw出力なし
    • Windows:タスクスケジューラに「OpenClaw Gateway」関連のタスクがないこと
  • ディレクトリの確認:~/.openclaw(および複数設定の~/.openclaw-<profile>)が削除されていること

七、よくある残留ディレクトリ

完全アンインストール時は、以下のディレクトリを確認することをお勧めします:

~/.openclaw
~/.openclaw/workspace
~/Library/LaunchAgents/ai.openclaw.gateway.plist
~/.config/systemd/user/openclaw-gateway.service
その他の拡張