Windows/WSL2 で OpenClaw を入れるときに多い五つの誤読パターン
OpenClaw の 2026 年インストール面は macOS、Linux、Windows（多くは WSL2 経由）を覆います。Windows 側の障害は三層が重なりやすいです。Node ランタイムの版、systemd ユーザーセッションが使えるか、18789 が幽霊プロセスに占有されているかです。運用がこの三層を「もう一度入れ直す」に圧縮すると、2026.4.24 付近のビルドでは 30〜50 秒ごとのクラッシュループに入り、真因はユーザー級とシステム級の Gateway サービス二重登録のまま残ります。変更票では先に署名番号を付け、ポート掃除、dist-tag のロールバック、本番 Gateway のクラウド Mac 移設のどれを取るか決めてください。
WSL からクラウド Mac に ping が通る＝Gateway が健全：到達性と openclaw gateway status の active は別物です。Node 側の remote URL が誤っていると、Windows ローカルだけが再起動を繰り返します。
WSL2 の systemd を有効にせず onboard --install-daemon：unit は書き込まれるのに user session から起動できず、SSH 切断でプロセスが消え、「たまに落ちる」ように見えます。
Windows ホストと WSL の両方に Gateway：18789 の二重 listen で幽霊 EADDRINUSE が出て、doctor の出力が矛盾します。
ノートのスリープ後にチャネルが沈黙：消費者向け Windows の休止は WSL も止めます。本番 webhook はスリープしないクラウド Mac Masterに置き、Windows は Node かコンソールに限定します。
アップグレード後に config key が漂流し doctor 未実行：小版を跨いだあとも旧キーが json に残ると、Gateway は起動するのに channels probe が赤く、Windows ファイアウォールのせいにされます。
署名を付けてからモデルルートを触ってください。クラウド Mac で Master を既に動かしているなら、配線は リモート Node ペアリングと跨リージョン移行を先に読みます。Gateway をクラウドで一度も受け入れていない場合は、ヘッドレス SSH 初時間チェックリストで土台を固めてから WSL の常駐を重ねてください。不安定な Master の上にローカル再起動ノイズを足すと、切り分けがさらに難しくなります。
Windows ネイティブ、WSL2、「クラウド Mac Gateway」の三分法マトリクス
2026 年のコミュニティ合意は「Windows で OpenClaw が動かない」ではなく、7×24 の制御面とチャネル webhook を安定ホストに置くことです。下表は、ローカル実験、WSL 開発機で Gateway を自前運用、「クラウド Mac Master + Windows Node」の分裂トポロジを粗く揃えます。分裂構成の補完として Gateway 全プラットフォーム展開と復旧も参照してください。
| 観点 | Windows ネイティブ | WSL2 + systemd | クラウド Mac Gateway + Win Node |
|---|---|---|---|
| 導入入口 | install.ps1 | install.sh（Ubuntu 内） | クラウド Mac：install.sh；Win：CLI/Node のみ |
| 常駐形態 | タスクスケジューラ、UI 干渉しやすい | ユーザー級 systemd unit | クラウド Mac：LaunchAgent；Win：常駐なし可 |
| 7×24 チャネル | スリープ・更新で切れやすい | WSL 一時停止で切断 | チャネルはクラウド Mac のみ、最も安定 |
| 切り分け | パスと権限が分裂 | systemd とポートの理解が必要 | Win は Node、クラウド Mac は Gateway と層分け |
| 2026 推奨 | 短期デモ | 本番スクリプトの再現 | 跨リージョン小チーム、自動化担当 |
本番チャネルはノートが眠らない前提で賭けない。Gateway はクラウド Mac の loopback に置き、Windows は node run だけにする。
分裂トポロジを選んだら、どのクラウド Mac が webhook を受け、Windows が openclaw node run --remote wss://... のみかを文書化します。実験期に WSL で一時 Gateway を立てるのは構いませんが、同一チャネル token をクラウド Mac Master と同時に刺さないでください。二重消費とメッセージ欠落が起きます。Docker と裸金属の差は Docker と install.sh の二経路、版固定は アップグレードとロールバック Runbook を見てください。
WSL2 事前確認、Node 24 受け入れ、「幽霊 EADDRINUSE」の層別対処
WSL 内で本番同等の openclaw onboard --install-daemon を走らせる前に、Node ≥ 22.16（推奨 24） と systemd=true を確認します。2026 年 4 月下旬の一部 2026.4.24 ビルドでは、Gateway ログは起動するのに Control UI に届かず、30〜50 秒周期の EADDRINUSE が報告されています。緩和策の一つは 2026.4.22 への版固定と、重複 systemd unit の掃除です。次のコマンド塊は当番の骨格です。発行版パスは環境に合わせて置き換えてください。
grep -q 'systemd=true' /etc/wsl.conf || echo '[boot]' >> /etc/wsl.conf && echo 'systemd=true' >> /etc/wsl.conf node -v curl -fsSL https://openclaw.ai/install.sh | bash openclaw onboard --install-daemon systemctl --user status openclaw-gateway lsof -i :18789 openclaw doctor openclaw gateway status
lsof で 18789 が占有なのに gateway status が stopped のときは、残留 openclaw プロセスと/etc/systemd/system と ~/.config/systemd/user の二重 unitを先に疑います。掃除後はユーザー級だけ残し、systemctl --user daemon-reload で再起動します。それでもループする場合は openclaw --version を記録し、Runbook に沿って 2026.4.24 からのロールバックを検討し、変更窓で openclaw doctor --fix を実行します。Windows ホストのファイアウォールで Control UI をローカル確認する場合も、本番は Tailscale Serve でクラウド Mac Master を指し、ノートのポートを公網に晒さない方針が安全です。
メモ：onboard の前後で systemctl --user status と lsof -i :18789 を各一度アーカイブすると、「二重インスタンス」と「版欠陥」の切り分けが楽になります。
六ステップ Runbook：WSL 受け入れからクラウド Mac Master のチャネル試験まで
トポロジを凍結：Win の役割（Node のみ / 一時 Gateway）、クラウド Mac の都市、チャネルを Master のみにするかを記録します。
WSL 事前：systemd を有効化し、node -v ≥ 22.16 を確認。必要なら Ubuntu 内で Node 24 を別途入れます。
クラウド Mac に Master 展開：初時間チェックリストどおり install.sh、onboard、LaunchAgent。loopback 18789 と gateway status を確認します。
Win/WSL で remote 接続：node run --remote または Control UI を Master の WSS に向けます。1008 のときは Master で devices approve（リモート Node 記事参照）。
分裂構成なら Win ローカル Gateway を停止：WSL ユーザー級 unit を止め、Master と同一チャネル設定を争わせません。
Master でチャネル試験：クラウド Mac で channels probe と実 inbound。Win 側はツール実行だけを見て、webhook をノートに戻しません。
三本の当番閾値と六リージョンクラウド Mac Gateway 選定
ポート争用の赤線：同一 WSL で 10 分に EADDRINUSE が 3 回以上かつ openclaw-gateway が 2 プロセス以上なら二重インスタンスとみなし、停止・掃除を先にします。
Node 版の下限：2026 公式ドキュメントは Node 24 を推奨基線とします。22.16 未満では doctor が通ってもプラグイン読み込みが不安定になります。チケットに node -v の証跡を添えてください。
分裂トポロジの受け入れ：Master 復旧後 10 分以内に channels probe を 3 回以上。Win を一度スリープさせても Node だけ再接続し、チャネルはノート常時オンラインに依存しないこと。
注意：閾値は当番連絡用の目安であり、ベンダ SLA ではありません。
Gateway を Windows ノートに縛ると、スリープ、自動更新再起動、WSL 凍結が戻ります。安価な Linux VPS だけでは、macOS ブラウザ自動化や公証チェーンのツールから離れます。裸金属クラウド Mac を Master、Windows を Node かコンソールにすると、Apple ツールチェーンの近さ、loopback 規律、予測可能な換え窓のバランスが取れます。7×24 チャネルを消費者ハードの常時オンラインに賭けたくないチームには、MESHLAUNCH の Mac Mini クラウドレンタルが現実的です。目標リージョンで日次レンタルから六ステップとホスト再起動を一度通し、状態が固まってから月次にロックする順序をおすすめします。容量と申込は レンタル料金 と ヘルプセンター をご覧ください。
先に lsof -i :18789 と systemctl --user status openclaw-gateway を取り、二重 unit と残留プロセスを掃除します。2026.4.24 の版固定が要るかも確認してください。全プラットフォーム Gateway 手順と、申込は 料金ページです。
短期実験には足ります。本番チャネルはクラウド Mac Master に移し、Win は node run に限定するのが安全です。展開は ヘッドレス SSH 初時間チェックリストを参照してください。
/etc/wsl.conf の systemd がまだ true か、openclaw doctor の結果を確認します。分裂トポロジではチャネルはクラウド Mac 側がオンラインのままであるべきです。手順は ヘルプセンターです。