Linuxでは、OpenClawゲートウェイがユーザーレベルのsystemdサービスとして実行されます。つまり、アンインストールにはバイナリを削除するだけでは不十分です。ユニット、ソケット、プロファイルディレクトリが残り、システムに影響し続ける可能性があります。
このガイドでは、残存するサービス、ファイル、設定を残さないためのクリーンな削除手順を説明します。
要約
タスク | Linux固有の対応 |
サービスを停止 |
|
ユニットを削除 |
|
残存ファイルをクリーンアップ |
|
CLIを削除 |
|
確認 |
|
Linuxでアンインストールの準備をする
- 将来の復元に備えて、ワークスペース、cronログ、シークレットを保存します。
- プロファイルを一覧表示:
ls -d ~/.openclaw*を実行して、デフォルトおよびプロファイル別の状態ディレクトリをすべて確認します。 - リモートゲートウェイを確認: ゲートウェイが実行されているリモートホストを記録します。後で同じクリーンアップを実施します。
ゲートウェイユニットを停止してアンインストールする
gateway uninstallは、CLI経由でsystemdユニットとソケットを削除します。- 統合された
openclaw uninstallコマンドは、これらの手順を自動的に実行します。
systemdユーザーユニットとソケットを削除する
ユニットが残っていないことを再確認します。
プロファイルを使用していた場合は、openclaw-gateway-<profile>.serviceでも同じ手順を繰り返します。systemctl --user list-units | grep openclawを使って、アクティブなものが何もないことを確認してください。（参照: systemd systemctl manページ）
LinuxでOpenClawの残存ファイルをクリーンアップする
- ワークスペース + ログ:
~/.openclaw/workspace、~/.openclaw/logs、およびカスタムワークスペースパス（/srv/agents/...）を削除します。 - キャッシュディレクトリ:
/var/tmp/openclawなどにキャッシュファイルを保存していた場合は、それらも削除します。 - エディタ/ターミナル: 必要に応じて、シークレットを含むシェル履歴エントリを削除します（
.bash_historyに対するhistory -dまたはsed -i）。
CLIとシェル関連の痕跡を削除する
グローバルインストールではなくリポジトリをクローンしていた場合は、ゲートウェイを停止した後にそのクローンを削除します。OpenClawを参照するカスタムのシェル補完やエイリアスがあれば、~/.bashrc、~/.zshrc、または~/.config/fish/config.fishから削除します。
APIキーとリモートホストの権限を取り消す
- このLinuxマシンに紐づいていたOAuthトークン（Slack、Google、Notion、GitHub、Discordなど）を取り消します。
- OpenClawにプライベートGitリポジトリへのアクセスを許可していた場合は、SSHキーまたはデプロイトークンを削除します。
- リモートゲートウェイを実行していた場合は、バックグラウンドサービスが残らないように、各ホストでゲートウェイのアンインストール手順を繰り返します。
アンインストールを確認し、次の手順に進む
- “Unit openclaw-gateway.service could not be found.”と応答するはずです。
- バイナリ確認:
which openclawは何も返さないはずです。 - ファイルシステム確認:
ls ~/.openclaw ~/.openclaw-*は“No such file or directory.”を出すはずです。 - ジャーナル確認:
journalctl --user -u openclaw-gateway.serviceは古いエントリだけを表示し、新しいエントリは表示されないはずです。
すべて問題がなければ、同じマシンに再インストールするか、新しいホストへ移行します。
AI受付を数分で稼働。
眠らないAIでフロントデスクを拡張しましょう。Solveaは複数チャネルの問い合わせに対応し、予約を自動でカレンダーに登録し、24時間機会損失を防ぎます。
FAQ
いずれかのコマンドでsudoは必要ですか？
いいえ。OpenClawはユーザーレベルのsystemdユニットを使用します。ゲートウェイをインストールした同じユーザーでコマンドを実行してください。
DockerまたはPodmanのサンドボックスをクリーンアップするにはどうすればよいですか？
OpenClawを参照しているコンテナ/イメージを停止して削除します。docker rm <container> → docker rmi <image>（または対応するPodmanコマンド）を実行して、レジストリをクリーンに保ちます。
ワークスペースの削除を省略できますか？
ローカルのトランスクリプトを保持したい場合のみ可能です。それ以外の場合は、クリーンなアンインストールを確実にするため、ファイルを別の場所へ移動してから元のファイルを削除してください。
systemctl --userがサービスはmaskedだと表示した場合はどうすればよいですか？
まずsystemctl --user unmask openclaw-gateway.serviceを実行し、その後disable/removeコマンドを再実行します。
