Windows（WSL2）

Windows 上の OpenClaw は、WSL2 経由での利用を推奨します（Ubuntu 推奨）。CLI とゲートウェイを Linux 内で動かすことで、ランタイムの整合性を保ちやすくなり、Node / Bun / pnpm、Linux バイナリ、skills などの互換性も高くなります。ネイティブ Windows より扱いやすく、wsl --install の 1 コマンドで完全な Linux 環境を導入できます。ネイティブ Windows companion app は今後対応予定です。

インストール（WSL2）

Getting Started（WSL 内で実行）
Install & updates
Microsoft の公式 WSL2 ガイド: https://learn.microsoft.com/windows/wsl/install

ゲートウェイ

ゲートウェイサービスのインストール（CLI）

WSL2 内で次を実行します。

openclaw onboard --install-daemon

または:

openclaw gateway install

または:

openclaw configure

プロンプトが表示されたら Gateway service を選択します。修復 / 移行:

openclaw doctor

Windows ログイン前にゲートウェイを自動起動する

ヘッドレス運用では、誰も Windows にログインしていなくても起動チェーン全体が実行されるようにしておきます。

1) ログインなしでもユーザーサービスを維持する

WSL 内で:

sudo loginctl enable-linger "$(whoami)"

2) OpenClaw ゲートウェイのユーザーサービスをインストールする

WSL 内で:

openclaw gateway install

3) Windows 起動時に WSL を自動起動する

PowerShell を管理者として開き、次を実行します。

schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM

Ubuntu は、次で確認できる実際のディストリビューション名に置き換えてください。

wsl --list --verbose

起動チェーンを確認する

再起動後（Windows サインイン前）に、WSL から次を確認します。

systemctl --user is-enabled openclaw-gateway
systemctl --user status openclaw-gateway --no-pager

詳細: WSL 内サービスを LAN へ公開する（portproxy）

WSL には独自の仮想ネットワークがあります。別マシンから WSL 内 のサービス（SSH、ローカル TTS サーバー、ゲートウェイなど）へ到達させたい場合は、Windows 側のポートを現在の WSL IP へ転送する必要があります。WSL IP は再起動で変わるため、転送ルールを更新し直す必要が出ることがあります。例（PowerShell を 管理者 で実行）:

$Distro = "Ubuntu-24.04"
$ListenPort = 2222
$TargetPort = 22

$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
if (-not $WslIp) { throw "WSL IP not found." }

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `
  connectaddress=$WslIp connectport=$TargetPort

Windows Firewall でこのポートを許可します（初回のみ）。

New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow

WSL 再起動後に portproxy を更新するには:

netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 | Out-Null
netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 `
  connectaddress=$WslIp connectport=$TargetPort | Out-Null

注:

別マシンからの SSH 接続先は Windows ホスト IP です（例: ssh user@windows-host -p 2222）。
リモートノードは、到達可能なゲートウェイ URL を指している必要があります（127.0.0.1 は不可）。openclaw status --all で確認してください。
LAN 公開には listenaddress=0.0.0.0 を使います。127.0.0.1 にするとローカル専用になります。
自動化したい場合は、ログイン時に更新処理を実行する Scheduled Task を追加してください。

WSL2 の段階的なインストール

1) WSL2 + Ubuntu をインストールする

PowerShell を管理者として開きます。

wsl --install
# Or pick a distro explicitly:
wsl --list --online
wsl --install -d Ubuntu-24.04

Windows に再起動を求められた場合は再起動します。

2) systemd を有効にする（ゲートウェイインストールに必須）

WSL ターミナルで:

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

その後、PowerShell で:

wsl --shutdown

Ubuntu を再度開き、次で確認します。

systemctl --user status

3) OpenClaw をインストールする（WSL 内）

WSL 内では Linux 向け Getting Started フローに従います。

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build
openclaw onboard

完全なガイド: Getting Started

Windows companion app

現時点では Windows companion app はまだありません。必要であれば、実現に向けたコントリビューションは歓迎されています。

​インストール（WSL2）

​ゲートウェイ

​ゲートウェイ サービスのインストール（CLI）

​Windows ログイン前にゲートウェイを自動起動する

​1) ログインなしでもユーザー サービスを維持する

​2) OpenClaw ゲートウェイのユーザー サービスをインストールする

​3) Windows 起動時に WSL を自動起動する

​起動チェーンを確認する

​詳細: WSL 内サービスを LAN へ公開する（portproxy）

​WSL2 の段階的なインストール

​1) WSL2 + Ubuntu をインストールする

​2) systemd を有効にする（ゲートウェイ インストールに必須）

​3) OpenClaw をインストールする（WSL 内）

​Windows companion app