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

OpenClawのアンインストールはコマンド1つではなく、4つのスコープに分かれます。Gatewayサービス、状態ディレクトリ、ワークスペース、CLI本体、そしてインストールしていればデスクトップアプリです。ドキュメントには、CLIがまだインストールされている間に使える簡単な方法と、CLIはもうないのにサービスが動き続けている場合の手動の方法が載っています。後者こそ、フォーラムにスレッドが立つ原因となるケースです。ここでは両方の方法と、何かを削除する前に移動しておくべきものを1つ紹介します。

簡単な方法

• uninstallコマンド1つで済みます。デフォルトでは対話式で、あらかじめ選択されているのはGatewayサービスだけです。完全に削除するには、状態、ワークスペース、アプリも選択するか、allフラグを渡します。
• allフラグを付けてドライランを行うと、削除される内容を安全にプレビューできます。
• 状態を削除しても、ワークスペースのスコープもあわせて選択しない限り、設定済みのワークスペースディレクトリは保持されます。
• サービスの撤去が安全装置になっています。これが失敗すると状態とワークスペースの削除は行われず、いずれかのスコープが失敗した場合、コマンドは0以外のステータスを返します。

openclaw uninstall --stateとは異なり、状態を手動で削除するとワークスペースは保持されません。

手動の方法

• Gatewayサービスを停止してから、アンインストールします。macOSではlaunchd、Linuxではsystemd、Windowsではタスクスケジューラです。
• 残しておきたいワークスペースは、デフォルトのものも含め、まずすべて状態ディレクトリの外に移動してください。状態ディレクトリを削除すると、その中のワークスペースも削除されるからです。
• 状態と設定のディレクトリを削除し、カスタムの設定パスを指定していればそれも削除します。外部のワークスペースは、そのエージェントファイルも消したい場合にだけ削除してください。
• CLIはインストールに使ったツールで削除し、macOSアプリは「アプリケーション」フォルダーから削除します。

ドキュメントが挙げる2つの残骸

非常に古いインストールからアップグレードしたマシンには、改名前のClawdbot時代のサービスユニットが残っていることがあります。uninstallコマンドはこれを検出します。また、古いプレフィックスの環境変数は警告を出す以外に何もしないので、ついでにシェルのプロファイルから削除しておくとよいでしょう。この経緯の続きはClawdbot、Moltbot、OpenClawの記事にあります。

アンインストールの前に：バックアップを

ワークスペースにはメモリファイル、自分で書いたスキル、エージェントへの指示が入っており、状態ディレクトリには設定、認証情報、セッションが入っています。また戻ってくる可能性が少しでもあるなら、backupコマンドがあります。メモリファイルとは何か、なぜそれが残す価値のある部分なのかは、OpenClawのメモリの仕組みの記事で説明しています。

もう気にしなくて済む、もう1つの方法

アンインストールする理由は2つあります。使い終わったか、自分で運用するのをやめたかです。後者なら、DialiのマネージドOpenClawホスティングが同じランタイムを分離されたインスタンス上で動かし続けます。ワークスペースはバックアップされ、アップデートは事前にテストされ、あとで自分のマシンから削除するものも何もありません。

• サービス、状態、ワークスペース、CLI、アプリ：5つの対象を、allフラグ付きのコマンド1つで。
• 手動で削除する前に、ワークスペースを外に移動します。
• ほかのものを削除する前に、サービスを停止する必要があります。