OpenClaw は、単一の実行ファイルだけでなく、はるかに多くのものをインストールします。ゲートウェイサービス、起動エージェント、状態ディレクトリ、キャッシュされた認証情報、オプションのデスクトップアプリは、明示的に削除するまで残ります。そのため、クリーンなアンインストールには、CLIバイナリを削除するだけでは不十分です。
この実践的な分解ガイドでは、バックアップ、サポートされているopenclaw uninstallフローの実行、プラットフォーム別のサービス削除、そしてプロファイルフォルダーやAPIシークレットを残さないための「残存ファイルのクリーンアップ」までを順に説明します。
要約
質問 | 回答 |
削除の準備はどうすればよいですか？ |
|
主な処理を担うコマンドはどれですか？ |
|
残存ファイルのクリーンアップはどうしますか？ |
|
OS別の手順は必要ですか？ | はい。macOSでは |
削除されたことを確認するにはどうすればよいですか？ | （Linuxでは） |
バックアップを作成し、すべてのプロファイルを把握する
- これにより、エージェントのワークスペース、cronログ、メモリファイルの復元可能なアーカイブが作成されます。（出典: OpenClaw CLIアンインストールドキュメント）
- 状態ディレクトリを列挙:
~/.openclaw、~/.openclaw-<profile>、カスタムのOPENCLAW_STATE_DIRロケーションを確認します。書き留めてください。後でそれぞれ削除します。 - コネクタの棚卸し: どのSlackワークスペース、Googleアカウント、カスタムWebhook、個人APIキーが連携されていたかを記録し、削除後に取り消せるようにします。
公式アンインストールフローを実行する
CLIがまだある状態で、OpenClaw自身にサービスを削除させます:
- このコマンドはゲートウェイを停止し、launchd/systemd/schtasksエントリの登録を解除し、デフォルトの状態ディレクトリを削除して、キャッシュされた認証情報を削除します。
- 削除対象を事前に確認する必要がある場合は、まず
openclaw uninstall --dry-runを使用します。
CLIがすでに削除されている場合は、手動でサービスを削除するセクションに進んでください。
OSサービスを停止し、登録解除する
macOS（launchd）
作成したすべてのプロファイルについて、ai.openclaw.gatewayをai.openclaw.<profile>に置き換えてください。
Linux（systemdユーザーユニット）
レガシーユニットではopenclaw-gateway-<profile>.serviceが使われます。次へ進む前にそれぞれ削除してください。
Windows（スケジュールタスク）
OpenClawをインストールした同じユーザーでPowerShellを開きます:
次に、%USERPROFILE%\.openclaw\gateway.cmd（またはプロファイル別のバリアント）を削除し、Windowsが再起動できないようにします。
残存ファイルとプロファイルを削除する
ここで副次キーワードであるopenclawの残存ファイルのクリーンアップが重要になります。
- プロファイル別ディレクトリ: 先ほど記録したすべてのプロファイルについて:
- カスタム設定パス:
OPENCLAW_CONFIG_PATHを設定していた場合は、そのファイルも削除します。 - DockerまたはVMサンドボックス: レジストリをクリーンに保つため、OpenClawタグ付きのイメージについて
docker rm/docker rmi（またはpodman rm/podman rmi）を実行します。
CLI + デスクトップアプリを削除する
使用したインストーラーに応じて:
install.sh / install.ps1を使用した場合、CLIはnpm install -g openclaw@latest経由で追加されているため、npm rm -g openclawで十分です。
APIキーとWebhookを取り消す
ローカルでアンインストールしても、外部トークンは無効化されません。接続していた各サービス（Google Cloud Console、Slack Appダッシュボード、Discord Developer Portal、Notion連携、GitHubトークン）にアクセスし、OpenClaw用に生成された認証情報を取り消してください。再利用していた共有シークレットはすべてローテーションします。
クリーンアップを検証し、次のインストール計画を立てる
- プロセス & サービス:macOS:
launchctl list | grep openclaw - Linux:
systemctl --user status openclaw-gateway.service - Windows:
Get-Process OpenClaw*およびschtasks /Query /TN "OpenClaw Gateway" - バイナリ確認:
which openclaw（macOS/Linux）またはGet-Command openclaw（PowerShell）は「not found」を返すはずです。 - ファイルシステム確認:
ls ~/.openclawとls ~/.openclaw-*は「No such file or directory.」を返すはずです。 - 今後の方針: 管理ホストや新しいマシンへ移行するためにアンインストールしている場合は、バックアップを削除する前に、ローカルへ再インストールするのか、リモートゲートウェイを立ち上げるのか、ホスト型コントロールプレーンへ移行するのかを文書化します。
AI受付を数分で稼働。
眠らないAIでフロントデスクを拡張しましょう。Solveaは複数チャネルの問い合わせに対応し、予約を自動でカレンダーに登録し、24時間機会損失を防ぎます。
FAQ
次を実行した直後に再インストールできますか: openclaw uninstall?
はい。このコマンドは状態とサービスを削除しますが、グローバルパッケージマネージャーはそのまま残します。クリーンアップ確認が通ったら、npm install -g openclaw（またはインストーラースクリプト）を再実行し、新しいマシンとしてオンボーディングします。
ファイルを削除した後もサービスが再起動し続ける場合は？
launchd/systemd/schtasksエントリを見落としている可能性が高いです。上記のプラットフォーム別コマンドを再実行し、OSスケジューラーが参照している残存gateway.cmdファイルや.serviceファイルを削除してください。
ワークスペースを削除する必要がありますか？
いいえ。ただし、~/.openclaw/workspaceを残すと、クリーンアンインストールの目的が損なわれます。履歴トランスクリプトが必要な場合は別の場所にアーカイブしてから、消去対象のマシンから削除してください。
リモートゲートウェイはどう扱えばよいですか？
ゲートウェイサービスを実行しているリモートホストでアンインストール手順を繰り返します。openclaw uninstallコマンドはローカルマシンの状態のみを削除するため、リモートホストは別途クリーンアップする必要があります。
