みなさん、こんにちは。
前回の「OpenClawの不都合な真実」についての記事では、「身につまされる」「APIコストこそが問題」といった共感の声をいただきました。
2026年のAIエージェントブーム。期待に胸を膨らませて導入したものの、度重なる429エラーや、予想を超えたコスト、あるいはエージェントの迷走に疲れ、「一度環境を更地に戻したい」と考えている方も多いのではないでしょうか。あるいは、最新バージョンへのクリーンインストールを機に、心機一転やり直したいという方もいるでしょう。
何でもOpenClawブームが到来した中国では、勢いでOpenClawをインストールしたものの、使いこなせないのでアンインストールしたいという人たちの要望を有償で請け負う業者が大繁盛とか。
そこで今回は、WSL2/Linux環境からOpenClawを完全に「浄化」し、必要であれば再び「召喚」するための、エンジニア向けのクリーンアップ・マニュアルをまとめておきたいと思います。
OpenClawを完全に「浄化」する手順 — 迷走したエージェントをリセットするために
AIエージェントというものは、一度導入するとシステムのあちこちに「足跡」を残します。単にパッケージを消すだけでは、バックグラウンドで動き続けるプロセスや、シェルの起動を重くする設定が残り、思わぬトラブルの種になります。
以下の4つのステップで、OpenClawをシステムから完全に消し去りましょう。
1. 常駐プロセス（Gateway）の「除霊」
OpenClawを --install-daemon オプション付きでセットアップした場合、OSの起動と同時にエージェントの「門」がひっそりと開くよう設定されています。まずはこの息の根を止めます。
# OpenClawの標準機能で停止
openclaw gateway stop
# または、systemdのユーザーサービスとして停止・無効化
systemctl --user stop openclaw-gateway
systemctl --user disable openclaw-gateway
# 残っているサービス定義ファイルを削除して完全に断ち切る
rm -f ~/.config/systemd/user/openclaw-gateway.service
これを怠ると、本体を消したはずなのにポート 18789 が塞がったままだったり、ログにエラーが吐き出され続けたりといった「怪奇現象」に悩まされることになります。
2. .bashrc の大掃除
OpenClawは、利便性のためにシェルのコマンド補完設定を .bashrc に書き込みます。これが残っていると、ターミナルを立ち上げるたびに「存在しないファイル」を読み込もうとして、起動がコンマ数秒遅れます。エンジニアとしては見過ごせないポイントです。
vi ~/.bashrc 等のエディタでファイルを開き、末尾付近にある以下の記述を探して削除してください。
# OpenClaw Completion
source "/home/YOUR_USER_NAME/.openclaw/completions/openclaw.bash"
削除後は、source ~/.bashrc を実行して、現在のセッションに反映させるのを忘れないようにしましょう。
3. 本体（npmパッケージ）の追放
いよいよ実行バイナリの削除です。グローバルにインストールされているため、管理者権限（または設定したパス）で削除を実行します。
npm uninstall -g openclaw
これで openclaw コマンドそのものがシステムから失われます。
4. 設定フォルダの「完全消去」
最後に、最も重要なステップです。ホームディレクトリの下には、APIキー、実行ログ、エージェントの「記憶」が詰まった設定フォルダが残されています。これを消さない限り、本当の意味でのリセットにはなりません。
rm -rf ~/.openclaw
ここには過去の「爆死したリクエストの記録」もすべて眠っています。これを消し去ることで、ようやくあなたのWSL2環境は清浄な状態へと戻ります。
必要時の「再召喚」手順 — 最新版での再構築
「一度は諦めたけれど、新バージョンで改善されたと聞いた」「コスト管理を徹底してやり直したい」という場合は、以下の手順で最新の環境を構築しましょう。
1. 最新版のクリーンインストール
npmを使用して、最新パッケージを導入します。
npm install -g openclaw@latest
2. 初期セットアップと常駐化（再定義）
再び onboard コマンドを実行します。この際、--install-daemon を付与することで、バックグラウンドでの安定した動作を担保できます。
openclaw onboard --install-daemon
ウィザードでは、前回の反省を活かしてAPIキーの制限設定や、チャット連携の有無を慎重に選択してください。補完設定（Completion）の追記を聞かれたら、今回は迷わず「Yes」で良いでしょう。
完了チェックリスト – あなたのシステムは「清浄」か？
アンインストールが正しく完了したか不安なときは、以下の3つのコマンドで「生存確認」を行ってください。
- 実体の確認
which openclaw→ 何も表示されなければOKです。 - プロセスの確認
pgrep -f openclaw→ 番号が表示されなければ、バックグラウンドで動いているものはありません。 - フォルダの確認
ls -d ~/.openclaw→ 「そのようなファイルやディレクトリはありません」と出れば、浄化完了です。
リセットもまた、エンジニアの重要なスキルである
2026年のAIエージェント狂騒曲の中で、私たちは多くのツールを試し、そして多くの失敗を重ねてきました。大切なのは、失敗した環境をそのまま放置せず、一度立ち止まって「クリーンな状態に戻せる」ことです。
不要なプロセスや設定を削ぎ落とし、再び必要な時に最小限の構成で組み上げる。そのサイクルこそが、肥大化し続けるAIエコシステムと共存していくための、現代のサバイバル術なのかもしれません。
本日も最後までお読みいただきありがとうございました。
それでは、よいAIエージェントライフを！
