OpenClawSkills
GitHub
プラットフォーム • 7分で読める

Windows（WSL2）

Windows では WSL2 経由で OpenClaw を実行します

Windows では OpenClaw を WSL2 経由（Ubuntu 推奨）で動かすのがおすすめです。CLI + Gateway を Linux 環境で動かすことで、ランタイムの一貫性が保て、ツールチェーン互換性も大きく改善します（Node/Bun/pnpm、Linux バイナリ、skills など）。ネイティブ Windows で動かすのは手間になりがちですが、WSL2 なら完全な Linux 体験を得られます。インストールは 1 コマンド：wsl --install。

Windows のネイティブコンパニオンアプリは計画中です。

Tutorial.step

インストール（WSL2）

- Getting Started（WSL 内で実行）

- インストールと更新

- Microsoft 公式 WSL インストールガイド

Tutorial.step

Gateway

- Gateway runbook

- Configuration

Tutorial.step

Gateway サービスのインストール（CLI）

WSL2 内で：

Terminal
openclaw onboard --install-daemon

または：

Terminal
openclaw gateway install

または：

Terminal
openclaw configure

プロンプトが出たら Gateway service を選択します。

Repair / migrate:

Terminal
openclaw doctor
Tutorial.step

上級：WSL のサービスを LAN に公開（portproxy）

WSL は独立した仮想ネットワークを持ちます。別のマシンから WSL 内 で動いているサービス（SSH、ローカル TTS、Gateway など）へアクセスしたい場合、Windows 側のポートを現在の WSL IP に転送する必要があります。WSL の IP は再起動で変わるため、portproxy ルールを更新する必要がある場合があります。

例（管理者として PowerShell を実行）：

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 ファイアウォールを許可（1 回だけ）：

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

WSL 再起動後に portproxy を更新：

Powershell
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）。

- リモートノードは 到達可能 な Gateway URL を指す必要があります（127.0.0.1 ではない）。openclaw status --all で確認してください。

- listenaddress=0.0.0.0 は LAN に公開、127.0.0.1 はローカルのみです。

- 自動化したい場合は、ログイン時に更新手順を実行するスケジュールタスクを登録できます。

Tutorial.step

WSL2 セットアップ（手順）

WSL2 + Ubuntu をインストールし、WSL 内で OpenClaw をセットアップします。

Tutorial.step

1）WSL2 + Ubuntu をインストール

PowerShell（管理者）を開きます：

Powershell
wsl --install

wsl --list --online
wsl --install -d Ubuntu-24.04

再起動が求められた場合は、指示に従って再起動してください。

Tutorial.step

2）systemd を有効化（Gateway service のインストールに必要）

WSL ターミナルで：

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

次に PowerShell で：

Powershell
wsl --shutdown

Ubuntu を開き直して確認：

Bash
systemctl --user status
Tutorial.step

3）WSL 内で OpenClaw をインストール

WSL 内で Linux の Getting Started 手順に従って進めます：

Bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # First run will auto-install UI dependencies
pnpm build
openclaw onboard

完全ガイド：Getting Started

Tutorial.step

Windows コンパニオンアプリ

現時点では Windows コンパニオンアプリはありません。貢献歓迎です。