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.」を返すはずです。 - 今後の方針: 管理ホストや新しいマシンへ移行するためにアンインストールしている場合は、バックアップを削除する前に、ローカルへ再インストールするのか、リモートゲートウェイを立ち上げるのか、ホスト型コントロールプレーンへ移行するのかを文書化します。
Ihr KI-Rezeptionist ist in Minuten live.
Skalieren Sie Ihren Empfang mit einer KI, die nie schläft. Solvea bearbeitet unbegrenzte Anfragen über mehrere Kanäle, bucht Termine automatisch in Ihren Kalender und verhindert rund um die Uhr verpasste Chancen.
FAQ
次を実行した直後に再インストールできますか: openclaw uninstall?
はい。このコマンドは状態とサービスを削除しますが、グローバルパッケージマネージャーはそのまま残します。クリーンアップ確認が通ったら、npm install -g openclaw（またはインストーラースクリプト）を再実行し、新しいマシンとしてオンボーディングします。
ファイルを削除した後もサービスが再起動し続ける場合は？
launchd/systemd/schtasksエントリを見落としている可能性が高いです。上記のプラットフォーム別コマンドを再実行し、OSスケジューラーが参照している残存gateway.cmdファイルや.serviceファイルを削除してください。
ワークスペースを削除する必要がありますか？
いいえ。ただし、~/.openclaw/workspaceを残すと、クリーンアンインストールの目的が損なわれます。履歴トランスクリプトが必要な場合は別の場所にアーカイブしてから、消去対象のマシンから削除してください。
リモートゲートウェイはどう扱えばよいですか？
ゲートウェイサービスを実行しているリモートホストでアンインストール手順を繰り返します。openclaw uninstallコマンドはローカルマシンの状態のみを削除するため、リモートホストは別途クリーンアップする必要があります。
