コンテンツにスキップ

OpenClaw をアンインストールする方法

開発ツールを色々と試していると、一度環境をリセットして整理したくなることがあります。バックグラウンドでサービスが動き続けていたり、不要な設定ファイルが残っていたりするのは避けたいものです。

OpenClaw をきれいに削除するための、最も効率的な手順を紹介します。

  • OpenClaw がインストールされている環境
  • ターミナル(macOS/Linux)または PowerShell(Windows)へのアクセス

OpenClaw を削除するには、CLI がまだ残っているなら「Easy path(簡単な方法)」、すでに CLI を消してしまったなら「Manual service removal(手動削除)」を選びます。

組み込みのアンインストーラーを使うのが一番のおすすめです。

Terminal window
openclaw uninstall

自動化したい場合や npx を使う場合は、こちらのコマンドを使ってください。

Terminal window
openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive

2. 手動でのクリーンアップ手順

Section titled “2. 手動でのクリーンアップ手順”

CLI のアンインストーラーを使わずに、一つずつ確実に消去したい場合は以下のステップで行います。

  1. Gateway サービスの停止

    Terminal window
    openclaw gateway stop
  2. Gateway サービスのアンインストール

    Terminal window
    openclaw gateway uninstall
  3. 状態と設定の削除

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

    ※ OPENCLAW_CONFIG_PATH を独自の場所に設定している場合は、そのファイルも削除してください。

  4. ワークスペースの削除(任意) エージェントのファイルを削除します。

    Terminal window
    rm -rf ~/.openclaw/workspace
  5. CLI 本体の削除 インストール時に使用したパッケージマネージャーに合わせて実行してください。

    Terminal window
    npm rm -g openclaw
    pnpm remove -g openclaw
    bun remove -g openclaw
  6. macOS アプリの削除 macOS アプリ版をインストールしていた場合のみ実行します。

    Terminal window
    rm -rf /Applications/OpenClaw.app

CLI を先に削除してしまったのに Gateway サービスが動き続けている場合は、OS ごとに以下のコマンドを実行してください。

デフォルトのラベルは bot.molt.gateway です。

Terminal window
launchctl bootout gui/$UID/bot.molt.gateway
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist
Terminal window
systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload
Terminal window
schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

プロファイルを使用している場合

Section titled “プロファイルを使用している場合”

--profile や OPENCLAW_PROFILE を使っていた場合は、各プロファイルごとのディレクトリ(例: ~/.openclaw-<profile>)に対して削除手順を繰り返す必要があります。

ソースコードからインストールした場合(git clone)

Section titled “ソースコードからインストールした場合(git clone)”

リポジトリを削除する前に、必ず Gateway サービスのアンインストールを行ってください。サービスを解除した後に、リポジトリディレクトリと状態ファイルを削除します。

以前のバージョンが残っている

Section titled “以前のバージョンが残っている”

macOS の場合、古いバージョンのラベル com.openclaw.* が残っていることがあります。その場合も同様に plist ファイルを削除してください。

リモートモードで運用していた場合、状態ファイルは Gateway ホスト側にあります。ホストマシン上でも上記の手順を実行してください。


解決しない場合は AI Setup Assistant に相談してください。

OpenClaw

OpenClaw Expert

まだ解決しませんか?

このページで解決しない場合は、OpenClaw Expertに直接質問してください。