openclaw 再インストールで沼らない！壊れた環境を丸ごと立て直す手順

OpenClawが起動しない、アップデート後に応答しない、command not found: openclaw が出る、Control UIに入れない。こうした状態で「openclaw 再インストール」と検索している人は、単に入れ直しコマンドだけを知りたいのではなく、設定やメモリを消してよいのか、どこまで削除すべきか、再発をどう防ぐかまで知りたいはずです。

この記事では、2026年5月26日時点で確認できるOpenClaw関連のインストール手順、アップデート失敗例、Docker運用のつまずき、Alibaba Cloud版のFAQ、トラブルシューティング情報を整理し、再インストール前の切り分けから復旧後の確認、料金・中国利用・代替ツール判断までをまとめます。体験談ではなく、調査結果をもとに「どこで詰まりやすいか」を実務寄りに整理しています。

この記事のポイント
✅ OpenClawを再インストールする前に残すべき設定と消してよいものがわかる
✅ npm版・Docker版・クラウド版で手順がどう違うかがわかる
✅ ENOTEMPTY、401、429、Pairing Required、ポート競合の見方がわかる
✅ 再インストールではなく代替ツールを選ぶべきケースも判断できる

openclaw 再インストール前の安全な切り分け

1. 再インストールの最短回答は「バックアップ→停止→削除→再導入→再起動」
2. openclaw のインストール方法は？迷ったら用途で選ぶのが安全
3. 壊れた原因はアップデート中断・Node競合・残骸設定に分けて見る
4. 削除前に守るべきデータは ~/.openclaw とワークスペース
5. Gatewayを止めてから作業するとENOTEMPTYやポート競合を避けやすい
6. Docker版は汚れにくいがペアリングとネットワーク設定でつまずきやすい

再インストールの最短回答は「バックアップ→停止→削除→再導入→再起動」

OpenClawの再インストールは、勢いで npm install -g openclaw をもう一度実行すれば終わる、という話ではありません。特に、Gatewayが裏で動いている状態や、古い設定ファイルが残っている状態では、入れ直しても同じエラーを引き継ぐ可能性があります。

まず押さえるべき流れは、バックアップ→Gateway停止→壊れた本体削除→再インストール→Gateway再起動→動作確認です。完全に初期化したい場合は設定フォルダも消しますが、設定や認証情報を残したい場合は ~/.openclaw を消さない判断もあります。

⚠️ 注意したいのは、rm -rf ~/.openclaw の扱いです。このディレクトリには、設定、認証情報、エージェント設定、ワークスペース、ログ、SOUL.mdのような人格・長期指示ファイルが含まれることがあります。消すと環境はきれいになりますが、再設定の手間も増えます。

🧭 再インストールの基本判断表

状況	推奨される対応	設定は残るか
CLIだけ壊れた	npmパッケージのみ削除して再インストール	残りやすい
アップデート中に失敗した	壊れたパッケージとbinリンクを手動削除	残りやすい
設定も壊れている	~/.openclaw もバックアップ後に削除	消える
完全にやり直したい	Gateway停止、本体削除、設定削除、再導入	消える
Dockerで作り直したい	コンテナとvolumeの扱いを分けて判断	volume次第

🔧 最小復旧と完全初期化の違い

方針	目的	向いている人
最小復旧	設定を残してOpenClawだけ直す	既存のチャネルや認証を残したい人
クリーン再導入	古い残骸を減らしてやり直す	エラー原因が不明な人
完全初期化	記憶・ログ・認証情報も含めて消す	実験環境を更地に戻したい人
Docker移行	ホスト環境を汚しにくくする	再作成しやすさを重視する人

npm版でよく出る復旧の骨子は、Gateway停止後に壊れたグローバルパッケージを削除し、npm install -g openclaw で入れ直す流れです。nvm配下に入れている場合は、OpenClaw本体が ~/.nvm/versions/node/.../lib/node_modules/openclaw/ にあるケースもあります。

一方、Docker版なら「コンテナを消す」のと「データvolumeを消す」の意味が違います。コンテナだけを消してvolumeを残せば設定は残る場合がありますが、volumeごと消せばOpenClawの記憶や設定も消える可能性があります。

つまり、再インストールで一番大切なのは、コマンドそのものではなくどの層を消すかです。本体だけなのか、Gatewayサービスなのか、設定フォルダなのか、Docker volumeなのかを分けて考えると、不要な初期化を避けやすくなります。

---

openclaw のインストール方法は？迷ったら用途で選ぶのが安全

「openclaw のインストール方法は？」という検索意図には、初回導入だけでなく、再インストール時にどの方式へ戻すべきかという悩みも含まれます。調査した範囲では、主な導入方法は公式スクリプト、npmグローバルインストール、Docker、クラウド/イメージ版に分かれます。

もっとも手軽なのは、公式スクリプト経由の導入です。LinuxやmacOSでは curl -fsSL https://openclaw.ai/install.sh | bash のようなワンライナーが案内されています。Windows系ではPowerShellやCMD向けのインストーラーが紹介されることもあります。

ただし、スクリプトインストーラーは内部的にnpmグローバル導入へつながるケースがあるため、Node.jsやnpm、nvmの状態に影響を受けやすい点は見逃せません。Node.jsのバージョン違いや壊れたグローバルパッケージがあると、再インストール時にも同じ問題が出るかもしれません。

🧩 インストール方法別の向き不向き

方法	メリット	注意点
公式スクリプト	手軽で初回導入しやすい	中で何をしているか把握しづらい
npmグローバル	手動で制御しやすい	Node.js環境の影響を受ける
Docker	環境を分離しやすい	ネットワーク、volume、権限で詰まりやすい
クラウド版	OS管理を減らせる	課金、リージョン、APIキー再設定が必要

🧪 再インストール時の選択マトリクス

あなたの状況	選びやすい方法	理由
とにかく早く戻したい	npm再インストール	既存設定を残しやすい
何度も壊れている	Docker	コンテナ単位で作り直しやすい
LinuxやWSLに慣れている	npmまたはDocker	ログやプロセス確認がしやすい
サーバー管理を減らしたい	クラウド版	保守負担を下げられる
セキュリティを重視	Dockerまたは専用環境	ホストへの影響を限定しやすい

Dockerを選ぶ場合は、ホスト環境を汚しにくい反面、Gatewayのバインド設定、--network=host の要否、デバイスペアリング、OllamaなどローカルLLMとの接続でつまずく例が確認されています。安全そうに見えても、初回セットアップの難易度はnpm版より上がる可能性があります。

クラウド版やAlibaba CloudのSimple Application Serverイメージを使う場合は、OSごとリセットする操作が「再インストール」に近い意味を持ちます。この場合、保存済みの設定、ログ、データベースなどが消える可能性があるため、スナップショットやバックアップが重要になります。

迷った場合の基本方針は、既存設定を残したいならnpm系の最小復旧、何度も壊れるならDocker、運用保守を減らしたいならクラウド版です。OpenClawは強い権限を持つAIエージェントなので、便利さだけでなく、壊れた時に自分で戻せるかも判断軸に入れるべきです。

---

壊れた原因はアップデート中断・Node競合・残骸設定に分けて見る

OpenClawが壊れる原因は一つではありません。調査した事例では、アップデート中の ENOTEMPTY、command not found: openclaw、Gateway無応答、古い補完設定の残骸、ポート18789の競合など、複数の層で問題が起きています。

特にnpm版では、アップデート途中でパッケージのリネームや置き換えに失敗すると、binリンクだけ残って参照先ファイルが消える状態になることがあります。この場合、openclaw --version が失敗したり、npm list -g でOpenClawの状態が不完全に見えたりします。

もう一つ多いのが、Gatewayプロセスが生きたまま本体を更新・削除しようとするケースです。Gatewayがファイルをつかんでいる状態では、npmがディレクトリを置き換えられず、ENOTEMPTY のようなエラーにつながる可能性があります。

🧨 よくある故障パターン

症状	起きていそうな場所	まず見るポイント
command not found: openclaw	npm/binリンク	which openclaw、npm global
DiscordやTelegramが無応答	Gateway/チャネル	Gatewayログ、チャネル設定
Control UIが開かない	Gateway/ポート	18789の競合、bind設定
ENOTEMPTY	npm更新処理	グローバルパッケージの残骸
起動はするが変な挙動	設定/ワークスペース	~/.openclaw、SOUL.md

🛠 原因別の初動対応

原因候補	初動	再インストールの必要性
Gatewayフリーズ	openclaw gateway restart	低い
トークン不一致	doctorやtoken再生成	低い
npmパッケージ破損	手動削除して再インストール	高い
設定JSON破損	バックアップ後に修正	中
旧プロセス残存	stop/kill後に再起動	中

.bashrc やシェル設定にOpenClawの補完設定が残っていることもあります。本体や ~/.openclaw を消しても、シェル起動時に存在しない補完スクリプトを読み込もうとしてエラーが出る場合があります。これは再インストールというより、残骸掃除の問題です。

Docker版では、本体よりもネットワークやvolumeの問題が目立ちます。コンテナは起動していても、Gatewayが 127.0.0.1 にだけバインドされていて外から見えない、ブラウザアクセスがペアリング対象として扱われない、Ollamaに届かない、といったケースがあります。

原因が不明な時は、いきなり全削除ではなく、プロセス→CLI→設定→チャネル→モデル認証の順で見るのが現実的です。OpenClawは本体、Gateway、モデル、チャネル、ワークスペースが絡むため、「全部壊れた」と見えても一部だけ直せば戻ることがあります。

---

削除前に守るべきデータは ~/.openclaw とワークスペース

OpenClawの再インストールで最も後悔しやすいのは、必要な設定やメモリまで消してしまうことです。多くの資料では、OpenClawの設定や状態は ~/.openclaw/ に保存されると説明されています。環境によっては、ワークスペースパスが設定ファイル内で別に指定されている場合もあります。

~/.openclaw/ には、メイン設定、認証情報、エージェント設定、スキル、ワークスペース、ログなどが含まれることがあります。完全初期化のために削除することもありますが、再設定の手間や認証情報の再発行が必要になる可能性を理解してから実行すべきです。

SOUL.md、IDENTITY.md、AGENTS.md、TOOLS.mdのようなMarkdownファイルは、OpenClawの応答スタイルや長期的な振る舞いに影響する可能性があります。特にSOUL.mdを編集して日本語応答や業務ルールを入れている場合、消す前に退避しておくのが無難です。

📦 バックアップ候補一覧

対象	役割	消した時の影響
~/.openclaw/openclaw.json	メイン設定	Gatewayやモデル設定の再設定が必要
~/.openclaw/credentials/	認証情報	チャネルやAPI接続が切れる可能性
~/.openclaw/agents/	エージェント設定	エージェント構成が失われる可能性
~/.openclaw/workspace/	作業ファイル	SOUL.mdなどが消える可能性
~/.openclaw/skills/	追加スキル	再インストールが必要になる可能性

🧾 削除前チェックリスト

チェック項目	確認内容
✅ 設定を残したいか	~/.openclaw を削除しない選択もある
✅ APIキーを再発行できるか	紛失すると再設定が必要
✅ チャネル設定を再作成できるか	Discord/TelegramなどのBot情報
✅ SOUL.mdを保存したか	日本語設定や行動ルール
✅ Docker volumeの場所を確認したか	volume削除でデータが消える可能性

Alibaba Cloudのようなサーバーイメージ版では、システムリセットがOS再インストールに近い扱いになることがあります。この場合、OpenClawだけでなく、同じサーバー上の他データまで消える可能性があるため、スナップショット作成やローカル退避が重要です。

npm版で本体だけ壊れているなら、~/.openclaw を残したままOpenClawパッケージだけ入れ直す方法があります。これなら、設定やワークスペースを保持したまま復旧できる可能性があります。ただし、設定自体が壊れている場合は、残した設定が再び問題を起こすこともあります。

迷う場合は、削除ではなくコピーして退避が現実的です。たとえば ~/.openclaw を別名に退避してから新規オンボーディングし、必要なSOUL.mdや設定だけ戻す方法なら、完全初期化と設定維持の中間を取れます。

---

Gatewayを止めてから作業するとENOTEMPTYやポート競合を避けやすい

OpenClawの再インストールで見落とされがちなのが、Gatewayの停止です。OpenClawはCLIだけでなく、メッセージングチャネルやControl UIとつながるGatewayを常駐させる構成を取ることがあります。これが動いたままだと、再インストールや削除時に問題が起きやすくなります。

Gateway停止には、OpenClawのCLIを使う方法と、systemdユーザーサービスを使う方法があります。環境によっては openclaw gateway stop、systemctl --user stop openclaw-gateway、systemctl --user disable openclaw-gateway のような操作が使われます。

Gatewayが残っていると、ポート18789が使用中になったり、古いバージョンのGatewayが動き続けたり、ファイル更新中にnpmの置き換え処理を妨げたりする可能性があります。特にアップデート失敗後は、プロセス確認を先に行うのが安全です。

🚦 Gateway停止まわりの確認表

操作	目的	例
Gateway停止	ファイル更新や削除の前準備	openclaw gateway stop
systemd停止	デーモン化されたGatewayを止める	systemctl --user stop openclaw-gateway
自動起動無効化	再起動後の復活を防ぐ	systemctl --user disable openclaw-gateway
ポート確認	18789競合を調べる	lsof -i :18789
ログ確認	失敗理由を見る	openclaw logs --follow

🧯 ENOTEMPTY発生時の見方

見る場所	意味	対応の方向
npmエラーログ	どのパスで失敗したか	対象パッケージを確認
node_modules	壊れたOpenClaw本体	手動削除の候補
binリンク	参照先が残っているか	リンク削除の候補
Gatewayプロセス	ファイル使用中か	停止して再試行
.openclaw	設定は別に残るか	削除前にバックアップ

ENOTEMPTY は、ディレクトリが空でないためにrenameや削除ができない時に出るnpm系のエラーとして見られます。OpenClawに限らずNode.jsパッケージ更新で起きることがありますが、Gatewayが動いている状態では発生リスクが上がるかもしれません。

復旧時は、npm uninstall -g openclaw が失敗する場合もあります。その際は、nvm配下の lib/node_modules/openclaw と bin/openclaw のような壊れた実体を確認し、バックアップや影響範囲を把握したうえで手動削除する流れが紹介されています。

大事なのは、再インストール前に「OpenClawが本当に止まっているか」を見ることです。CLIが壊れて openclaw gateway stop が使えない場合は、systemdやプロセス一覧、ポート使用状況から確認する必要があります。

---

Docker版は汚れにくいがペアリングとネットワーク設定でつまずきやすい

Docker版OpenClawは、ホスト環境を汚しにくいという点で魅力があります。npm版の残骸やNode.jsバージョン競合に悩んだ人にとって、コンテナ単位で作り直せる設計はわかりやすい選択肢です。

ただし、Dockerにすればすべて簡単になるわけではありません。調査した事例では、Gatewayのバインドアドレス、gateway.mode 未設定、デバイスペアリング、Ollama接続、コンテナ内ユーザー権限、volumeの扱いでつまずくケースが確認されています。

特にControl UIにアクセスする場合、Gatewayがどのアドレスで待ち受けているかが重要です。127.0.0.1 にだけバインドされていると、Dockerのネットワーク構成によっては外から見えない場合があります。設定値として lan や loopback のようなモードが使われる例もあります。

🐳 Docker版で見やすい論点

論点	つまずき例	対応の方向
Gateway bind	UIに接続できない	bind設定を確認
gateway.mode	doctorで未設定扱い	configで設定
ペアリング	Pairing required	devices approve
Ollama接続	localhostに届かない	network設定を確認
volume	設定が残らない/消えない	永続化先を把握

🔐 Docker版とnpm版の比較

項目	Docker版	npm版
ホスト汚染	少なめ	Node/npmに依存
作り直し	コンテナ単位で容易	npm残骸が残る場合あり
初回難易度	やや高い	比較的低い
ネットワーク	注意点が多い	比較的単純
セキュリティ分離	しやすい	ホストに近い

OllamaなどローカルLLMと接続する場合、コンテナ内の localhost はホストの localhost ではない点に注意が必要です。Linux Dockerでは --network=host を使う例がありますが、ネットワーク分離が弱まるため、用途とリスクを考えて判断する必要があります。

Docker版で再インストールする場合は、コンテナだけを消すのか、volumeも消すのかを明確にしましょう。volumeに ~/.openclaw 相当のデータを置いている場合、コンテナを作り直しても設定は残ります。逆にvolumeを消すと、設定やメモリも消える可能性があります。

結論として、Docker版は「壊して作り直す」には向いていますが、ネットワークと永続化の理解が必要です。Windows + WSL2環境ではDocker、WSL、Ollama、ブラウザの接続関係が絡むため、初回は一つずつ確認するのが近道です。

openclaw 再インストール後の復旧と代替判断

1. 再インストール後はdoctor・health・ログで順番に確認する
2. openclaw 料金は本体無料でもAPI費用と保守時間が乗る
3. openclaw 中国で使う場合はクラウド版・リージョン・モデル制限を確認する
4. 401・429・Pairing Requiredは認証とトークンから直す
5. DiscordやTelegramが返事しない時はチャネル設定と許可を見直す
6. SOUL.mdと設定ファイルは復旧後に最小限で戻す
7. 代替ツールはOpenClawに戻すより安く安定する場面がある
8. 総括：openclaw 再インストールのまとめ

再インストール後はdoctor・health・ログで順番に確認する

OpenClawを再インストールした後は、すぐに普段のメッセージングアプリから使い始めるより、基本診断を順番に通した方が問題を見つけやすくなります。代表的には、openclaw --version、openclaw doctor、openclaw health、openclaw gateway status、openclaw logs --follow などが確認候補になります。

openclaw doctor は、Node.jsバージョン、設定ファイル、モデル認証、Gateway、チャネル接続などを確認する診断コマンドとして紹介されています。--fix が使える環境では、自動修復を試せる場合もあります。ただし、自動修復がどこまで効くかはバージョンや環境によるため、ログ確認も併用した方が安全です。

Gatewayが起動していても、モデル認証が失敗しているとエージェントは返答できません。逆に、モデル認証が正しくても、DiscordやTelegramのチャネル設定が外れていれば、メッセージングアプリからは無応答に見えます。

🩺 復旧後の確認順序

順番	確認コマンド/操作	見ること
1	openclaw --version	CLIが動くか
2	openclaw doctor	設定と接続の総合診断
3	openclaw gateway status	Gatewayが起動しているか
4	openclaw logs --follow	ERROR/WARNの内容
5	Control UI	Webから応答するか
6	Discord/Telegram	チャネル経由で返答するか

📊 ログメッセージの読み方

ログ/症状	意味	初動
Pairing required	デバイスやトークン未承認	token生成・pairing承認
LLM request timed out	モデル応答が遅い	timeout延長やモデル変更
Model not allowed	モデル設定不一致	許可モデルやprovider確認
401 Unauthorized	APIキー/リージョン不一致	認証情報を確認
Port already in use	18789競合	使用プロセスを確認

OpenClawのControl UIは、通常 http://127.0.0.1:18789 や http://localhost:18789 で確認されることがあります。ただし、クラウド版やAlibaba Cloudイメージではランダムポートやトークン付きURLが使われるケースもあるため、環境ごとの案内に従う必要があります。

再インストール直後にHTTP 429やInsufficient balance系のエラーが出る場合、OpenClaw本体ではなく、モデルプロバイダー側の料金・クォータ・モデル選択が原因かもしれません。これは再インストールでは直りにくい問題です。

復旧確認では、CLI、Gateway、モデル、チャネルを分けて見ることが重要です。どこが通っていて、どこが詰まっているかを分ければ、無駄な再インストールを繰り返さずに済みます。

---

openclaw 料金は本体無料でもAPI費用と保守時間が乗る

「openclaw 料金」で調べる人は、OpenClaw自体が無料なのか、有料なのかを知りたいはずです。調査した範囲では、OpenClawはオープンソースまたはセルフホストで使える文脈が多く、ソフトウェア本体のライセンス費だけ見れば無料に近い扱いです。

しかし、実際の運用費は本体価格だけでは決まりません。LLMのAPI費用、VPSやサーバー代、クラウドイメージの利用料、検索API、保守にかかる時間が乗ってきます。特に自律型エージェントは、通常のチャットよりもツール呼び出しや長いコンテキストを使うことがあり、APIコストが読みにくいです。

OpenClawを再インストールするほど環境が不安定な場合、コストはお金だけでなく時間にも出ます。Docker設定、YAML、systemd、Node.js、APIキー、チャネル連携を何度も直す時間は、ライセンス費無料のメリットを薄める可能性があります。

💰 費用の内訳

費用項目	内容	注意点
本体	オープンソース/セルフホスト系	無料でも保守は必要
LLM API	Claude/OpenAI/Gemini/Qwen等	使った分だけ増える場合あり
インフラ	VPS、自宅PC、クラウド	常時稼働なら電気代も含む
検索API	Brave Searchなど	無料枠や上限確認が必要
保守時間	再インストール、ログ確認	見えにくいコスト

📉 セルフホストとマネージドの違い

項目	セルフホスト	マネージド/クラウド
初期費用	低く見えやすい	月額が発生しやすい
障害対応	自分で対応	提供側が一部対応
自由度	高い	制限がある場合あり
セキュリティ管理	自分で設計	提供側の設計に依存
向いている人	技術者・研究用途	業務利用・保守を減らしたい人

Alibaba CloudのFAQでは、Model Studioの無料クォータや課金、リージョンごとの違い、追加課金に関する説明がされています。無料枠だけで運用したい場合は、無料クォータ上限に達した時の挙動を確認する必要があります。

また、429エラーやInsufficient balance系のエラーは、OpenClawの再インストールではなく、モデルプロバイダーの残高、クォータ、プラン制限、リージョン設定の問題である可能性があります。ここを勘違いすると、何度入れ直しても直らない状態になります。

結論として、OpenClawの料金は「本体が無料か」だけでなく、API費用、サーバー費、保守時間、失敗時の復旧コストまで含めて考えるべきです。業務利用なら、月額課金のクラウド版や代替サービスの方が結果的に安くなる場面もあります。

---

openclaw 中国で使う場合はクラウド版・リージョン・モデル制限を確認する

「openclaw 中国」という関連検索には、中国語圏でのOpenClaw利用、Alibaba CloudでのOpenClawイメージ、リージョン別モデル、ネットワーク制限、課金の違いなどが含まれると考えられます。調査したAlibaba CloudのFAQでは、Simple Application Server上のOpenClawイメージやModel Studio連携が詳しく案内されています。

Alibaba Cloud版では、OpenClawのポート番号がランダム生成される説明や、モデル構成、APIキー、ゲートウェイ再起動、401エラー、クォータ、リージョン別の違いなどが扱われています。セルフホスト版とは見える場所や操作画面が違うため、同じ再インストールでも意味が変わります。

特に重要なのは、リージョンとAPIキーの組み合わせです。中国（北京）、シンガポール、米国（バージニア）などでベースURLやAPIキーの互換性が異なる説明があり、リージョン不一致は401エラーの原因になり得ます。

🌏 中国・クラウド利用で見るポイント

確認項目	内容
リージョン	北京、シンガポール、米国など
APIキー	リージョンと対応しているか
モデル権限	ワークスペースに対象モデル権限があるか
ポート	ランダムポートや18789の扱い
リセット	OS再インストール相当になる可能性

🧭 セルフホスト版とAlibaba Cloud版の違い

項目	セルフホスト	Alibaba Cloud版
設定場所	~/.openclaw など	/root/.openclaw や管理画面
ポート	18789が多い	ランダム生成の説明あり
モデル	自分でprovider設定	Model Studio連携が前提の場合あり
再インストール	パッケージ/コンテナ単位	システムリセットに近い場合あり
バックアップ	自分でコピー	スナップショット推奨

Alibaba Cloudのシステムリセットは、OpenClawだけを軽く入れ直す操作ではなく、システムディスク上のデータを削除する可能性がある操作として説明されています。実行前にスナップショットやデータ退避が必要です。

また、中国やクラウド環境では、Web検索スキル、Brave Search、SearXNG、外部コードリポジトリへのアクセス制限なども絡みます。スキルのインストールがブロックされる場合は、ネットワーク制限やHomebrew依存が原因になることもあります。

中国・クラウド文脈でのOpenClaw再インストールは、ローカルPCのnpm再インストールとは別物です。リージョン、モデル、課金、ポート、スナップショットを確認してから進める方が安全です。

---

401・429・Pairing Requiredは認証とトークンから直す

再インストール後に多いエラーとして、401 Unauthorized、HTTP 429、Pairing Requiredがあります。これらはOpenClaw本体のインストール失敗ではなく、認証、課金、トークン、ペアリングの問題であることが少なくありません。

401 Unauthorizedは、APIキーが間違っている、ベースURLとリージョンが合っていない、ワークスペースにモデル権限がない、トークン付きURLが期限切れになっている、といった原因が考えられます。Alibaba Cloud版では、APIキーとリージョンの一致確認が重要です。

429は、レート制限や無料クォータの上限、残高不足、プラン制限などが原因になることがあります。再インストールしても、プロバイダー側の利用制限が解消されなければ同じエラーが出る可能性があります。

🚨 エラー別の切り分け表

エラー	よくある原因	見る場所
401 Unauthorized	APIキー、リージョン、権限	auth設定、provider設定
429	クォータ、残高、レート制限	モデルプロバイダー管理画面
Pairing Required	デバイス未承認、token不一致	doctor、pairing、devices
Disconnected 1008	認証トークン不足	アクセスURL
Model not allowed	モデル許可設定	models設定

🔑 認証まわりの復旧優先順位

優先度	作業	理由
高	APIキーの有効性確認	本体再インストールでは直らない
高	リージョン/ベースURL確認	401の原因になりやすい
中	Gateway token再生成	Pairing Required対策
中	モデル変更	429や権限エラー回避
低	本体再インストール	認証問題だけなら不要な場合あり

Pairing Requiredは、Gateway Tokenがない、期限切れ、または接続元デバイスが承認されていない時に起きることがあります。openclaw doctor --generate-gateway-token のようなトークン生成コマンドが紹介される資料もあります。

Docker版では、ブラウザからのアクセスがDockerブリッジ経由に見えるなどの理由で、ローカルインストール時よりもペアリングが手動になることがあります。devices list や devices approve のような操作が必要になる場合があります。

エラー対応で大切なのは、再インストールを最後の手段にすることです。401や429は、OpenClaw本体を消しても残る外部要因の可能性があります。まずは認証情報、リージョン、トークン、モデル、クォータを確認しましょう。

---

DiscordやTelegramが返事しない時はチャネル設定と許可を見直す

OpenClawがControl UIでは動くのに、DiscordやTelegramから返事がない場合、再インストールよりもチャネル設定の見直しが優先です。メッセージング連携は、Bot token、許可チャンネル、DMペアリング、Gateway起動状態、権限設定が絡みます。

Discordでは、Bot tokenの入力だけでなく、Developer Portal側のPrivileged Gateway Intentsを有効にする必要があるケースがあります。Message Content Intentなどが無効だと、Botがメッセージを読めず、オフラインや無応答に見える場合があります。

Telegramでは、BotFatherでBotを作り、トークンをOpenClaw側に設定し、ユーザーIDや許可リストを登録する流れが紹介されています。再インストール後はトークンやallowlistが初期化・不一致になる可能性があります。

💬 チャネル別の確認ポイント

チャネル	確認すること
Discord	Bot token、Intents、サーバー招待、allowlist
Telegram	BotFather token、ユーザーID、許可リスト
Slack	Bot token、ワークスペース権限
WhatsApp	接続状態、認証、Gateway
DM	ペアリング承認

🧷 無応答時の切り分け

状態	考えられる原因	次に見る場所
UIでは返るがDiscordで返らない	Discord設定	Bot権限/Intents
DMだけ返らない	ペアリング未承認	pairing approve
全チャネルで返らない	Gatewayかモデル	logs/doctor
Botがオフライン	Gatewayやトークン	gateway restart
メンションだけ無反応	allowlist/権限	チャンネル設定

再インストールでBot tokenを入れ直した場合、以前のBotと新しいBotの設定が混ざっている可能性もあります。古いBotをサーバーに残したまま新しいBot tokenを設定すると、見た目ではBotがいるのにOpenClaw側とつながっていない状態になり得ます。

Allowlistを使っている場合は、指定したチャンネル以外では反応しません。セキュリティ上は好ましい設定ですが、初回確認時には「どのチャンネルなら応答するのか」を明確にする必要があります。

チャネル無応答は、OpenClaw本体の故障に見えやすい問題です。しかし実際には、Bot権限、ペアリング、allowlist、Gateway tokenのどれかで止まっていることがあります。Control UIでまず動くかを確認すると、切り分けがかなり楽になります。

---

SOUL.mdと設定ファイルは復旧後に最小限で戻す

OpenClawの魅力の一つは、SOUL.mdのようなMarkdownファイルでエージェントの人格や長期指示を調整できる点です。ただし、再インストール後に古い設定を丸ごと戻すと、壊れた設定まで一緒に戻す可能性があります。

特に、過去に何度もインストールやアップデートを繰り返した環境では、バックアップファイル、旧名のリンク、古いワークスペース、不要な補完設定が混ざることがあります。復旧後は、必要なものだけを最小限で戻すのが安全です。

SOUL.mdに日本語応答ルールを入れる場合も、まずは短く入れる方が管理しやすいです。長すぎる人格設定や矛盾した指示は、エージェントの応答がぶれる原因になるかもしれません。

📝 戻す優先度の高いファイル

ファイル/設定	戻す価値	注意点
SOUL.md	応答スタイル維持	矛盾した指示を避ける
IDENTITY.md	エージェント識別	古い内容を確認
AGENTS.md	行動ルール	現在の運用に合うか確認
auth-profiles.json	認証情報	漏えいに注意
openclaw.json	メイン設定	壊れた設定を戻さない

🧹 復旧後にやりがちな失敗

失敗	起きること
古い設定を丸ごと戻す	同じエラーが再発する
SOUL.mdを長くしすぎる	応答方針がぶれる
APIキーを平文で放置する	セキュリティリスクが上がる
.bashrc残骸を放置する	シェル起動時にエラーが出る
workspaceを複数作る	どれが本物かわからなくなる

復旧後にまず戻すなら、言語設定や短い行動ルールなど、影響がわかりやすいものから始めるのがよいでしょう。たとえば「日本語で返す」「危険な操作は確認する」「不要な前置きを避ける」程度なら、トラブル時にも原因を追いやすくなります。

設定ファイルを直接編集する場合は、JSON構文の破損に注意が必要です。OpenClawのdoctorが構文を見てくれる場合もありますが、編集前にコピーを取っておく方が無難です。

OpenClawは「育てる」楽しさがある一方で、設定が複雑化しやすいツールです。再インストール直後は、理想の設定を一気に戻すより、最小構成で動作確認→必要な設定だけ復帰という順序が安定しやすいです。

---

代替ツールはOpenClawに戻すより安く安定する場面がある

OpenClawは強力なAIエージェントですが、再インストールを何度も繰り返している場合、そもそもOpenClawを使い続けるべきかを見直す価値があります。調査資料では、NanoClaw、ZeroClaw、Hermes Agent、AnyGen AI Teammateなどの代替ツールが紹介されています。

代替ツールを考える軸は、機能の多さではありません。セキュリティを重視するのか、軽量さを重視するのか、自己学習的なスキル生成を重視するのか、企業向けの管理機能を重視するのかで選び方が変わります。

OpenClawは汎用性が高い一方で、Node.js依存、Gateway、チャネル連携、スキル、設定ファイル、API費用など、運用で見るべき点が多いです。小さな用途なら、より軽量なツールやクラウド型の方が扱いやすい可能性があります。

🧭 代替候補の比較

ツール	特徴	向いている用途
OpenClaw	汎用AIエージェント	拡張性重視
NanoClaw	セキュリティ重視	権限管理を強くしたい環境
ZeroClaw	軽量・高速志向	エッジ端末や低リソース環境
Hermes Agent	自己学習系	スキル再利用を重視
AnyGen AI Teammate	エンタープライズ向け	保守を外部化したい企業

⚖️ OpenClawを続けるかの判断表

状況	判断の方向
自分でLinux/Dockerを見られる	OpenClaw継続も現実的
何度も再インストールしている	Docker化または代替検討
セキュリティが最重要	NanoClaw系の発想も検討
低スペック端末で動かしたい	ZeroClaw系の軽量思想が合う可能性
業務で止められない	マネージド型も比較対象

ただし、代替ツールの情報は時期やバージョンで変わる可能性があります。特に2026年時点のAIエージェント領域は変化が速く、昨日まで動いた方法が次のバージョンで変わることもあります。導入前には公式情報や最新の利用者報告を確認した方が安全です。

また、OpenClawのMarkdownベースの設定やSOUL.mdの考え方を、他ツールがどこまで移行できるかは製品ごとに異なります。ZeroClawに移行コマンドがあるという情報もありますが、独自スキルを多用している場合は手作業が増えるかもしれません。

再インストールは復旧手段ですが、繰り返すほど運用コストになります。OpenClawにこだわるより、目的に合った構成へ変える方が、長期的には安定する場面もあります。

---

総括：openclaw 再インストールのまとめ

最後に記事のポイントをまとめます。

1. openclaw 再インストールは、本体だけでなくGateway、設定、認証、チャネルを分けて考えるべきである。
2. 最短の流れは、バックアップ、Gateway停止、壊れた本体削除、再導入、再起動、動作確認である。
3. ~/.openclaw には設定、認証情報、ワークスペース、SOUL.mdなどが含まれるため、削除前の確認が必要である。
4. npm版はNode.jsやnvm、グローバルパッケージ破損の影響を受けやすい。
5. ENOTEMPTY が出た場合は、Gateway停止と壊れたnpmパッケージの確認が重要である。
6. Docker版はホストを汚しにくいが、Gateway bind、ペアリング、volume、Ollama接続でつまずきやすい。
7. 再インストール後は、openclaw doctor、Gateway status、ログ、Control UI、チャネル応答の順で確認するべきである。
8. 401や429はOpenClaw本体ではなく、APIキー、リージョン、クォータ、課金の問題である場合がある。
9. DiscordやTelegramが返事しない時は、Bot token、Intents、allowlist、DMペアリングを確認するべきである。
10. openclaw 料金は本体無料だけで判断せず、API費用、サーバー代、保守時間を含めて見るべきである。
11. openclaw 中国やクラウド版では、リージョン、モデル権限、ポート、システムリセットの影響を確認するべきである。
12. 再インストールを繰り返すなら、Docker化、クラウド版、または代替ツールへの移行も検討対象である。

記事作成にあたり参考にさせて頂いたサイト

• https://skywork.ai/skypage/ja/openclaw-guide-reinstallation-alternatives/2047230526080372736
• https://www.reddit.com/r/openclaw/comments/1rbdc27/openclaw_reinstall_loop_node_version_conflicts/?tl=ja
• https://github.com/imudak/maruhuku-contents/blob/main/articles/openclaw-update-trouble-recovery.md
• https://www.bureau-mikami.jp/openclaw-complete-uninstall-and-reset-guide/
• https://note.com/showaradio/n/nd3ca7b2c1b42
• https://zenn.dev/shinseitaro/articles/intro-openclaw
• https://www.alibabacloud.com/help/ja/simple-application-server/use-cases/openclaw-faq
• https://www.reddit.com/r/openclaw/comments/1r2cxkw/config_invalid_error_reinstallreonboard_not/?tl=ja
• https://www.meta-intelligence.tech/ja/insight-openclaw-troubleshooting
• https://wiki.archlinux.jp/index.php/OpenClaw

当サイトについて

当サイトでは、インターネット上に散らばるさまざまな情報を収集し、AIを活用しながら要約・編集を行い、独自の切り口で見解を交えながらわかりやすい形でお届けしています。 情報の整理・編集にあたっては、読者やオリジナル記事の筆者へご迷惑をおかけしないよう、細心の注意を払って運営しておりますが、万が一、掲載内容に問題がある場合や修正・削除のご要望がございましたら、どうぞお気軽にお問い合わせください。 迅速に対応をさせていただきます。 その際には、該当記事の URLやタイトルをあわせてお知らせいただけますと、より速やかに対応 することができますのでそちらもご協力いただけますと大変幸いでございます。 今後とも当サイトをよろしくお願いいたします。