WindowsでWSL2を使ってOpenClawを実行する方法：完全セットアップガイド

OpenClawはNode.jsとUnixツーリング上に構築されたローカルファーストのAIエージェントランタイムで、Windowsにはネイティブでは存在しません。Windows Subsystem for Linux（WSL2）がそのギャップを埋め、ネイティブに近いパフォーマンスで本物のLinuxカーネルをWindows内で動作させます。このガイドでは、Windowsの新規インストールから完全に動作するOpenClawインスタンスまでのすべてのステップを説明します。

なぜWSL2でネイティブWindowsではないのか？

OpenClawはPOSIX環境を前提とするいくつかのコンポーネントに依存しています：

• ファイルシステムウォッチャーはLinuxカーネル機能のinotifyを使用^[1]
• スキルやプラグインのシェルスクリプトは/bin/bashを期待
• プロセス間通信にUnixソケットを使用
• プロセス管理はSIGTERMやSIGHUPなどのシグナルに依存

WSL2は軽量なHyper-V仮想マシン内で本物のLinuxカーネルを実行することでこれを解決します。WSL1（変換レイヤーを使用）とは異なり、WSL2はNode.jsネイティブモジュールとファイルウォッチングの互換性問題を完全に解消します。

前提条件

• Windows 10 バージョン2004+（ビルド19041）またはWindows 11
• 最低8 GBのRAM（16 GB推奨）
• BIOS/UEFIで仮想化が有効（Intel VT-xまたはAMD-V）
• 少なくとも1つのLLMプロバイダー（OpenAI、Anthropicなど）のAPIキー

ステップ1：WSL2をインストール

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

wsl --install

必要な機能を有効にし、WSL2をデフォルトに設定し、Ubuntuをインストールします^[2]。プロンプトが表示されたらコンピューターを再起動してください。再起動後、Ubuntuがユーザー名とパスワードの作成を求めます。

WSL2で実行していることを確認します：

wsl --list --verbose

VERSION列が2と表示される必要があります。1と表示される場合、wsl --set-version Ubuntu 2で変換します。

ステップ2：Ubuntuを更新して必須パッケージをインストール

sudo apt update && sudo apt upgrade -y
sudo apt install -y build-essential curl wget git unzip

ステップ3：systemdを有効化

WSL2は2022年9月からsystemdをネイティブサポートしています^[3]。有効か確認します：

ps --no-headers -o comm 1

出力がsystemdではなくinitの場合、有効にします：

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

[automount]
enabled=true
options="metadata,umask=22,fmask=11"

[network]
generateResolvConf=true
EOF

その後PowerShellから：wsl --shutdownを実行し、Ubuntuを再起動します。

ステップ4：Node.js 22をインストール

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

node --versionとnpm --versionで確認します。

または、複数のNode.jsバージョンを管理する場合はnvmを使用：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 22
nvm alias default 22

ステップ5：OpenClawをインストールしてオンボーディング

npm install -g openclaw
openclaw onboard

オンボーディングウィザードが~/.openclaw/を作成し、デフォルトのopenclaw.jsonを生成し、LLM APIキーの入力を求め、ゲートウェイを起動します。設定は以下の場所にあります：

~/.openclaw/
  openclaw.json       # メイン設定
  memory/             # エージェントメモリストレージ
  sessions/           # 会話セッション
  skills/             # インストール済みスキル

ステップ6：Windowsからダッシュボードにアクセス

最新のWSL2ビルドはWindowsとネットワーク名前空間を共有しています。OpenClawがWSL内でlocalhost:19090で起動すると、Windowsブラウザを開いて以下にアクセスします：

http://localhost:19090

localhostの転送が動作しない場合（古いWSL2ビルド）、hostname -I | awk '{print $1}'でWSLのIPを確認し、そのIPを直接使用します。

ステップ7：ポートプロキシによるLANアクセス

ネットワーク上の他のデバイスからOpenClawにアクセスするには、管理者としてPowerShellでポートを転送します：

netsh interface portproxy add v4tov4 `
  listenport=19090 `
  listenaddress=0.0.0.0 `
  connectport=19090 `
  connectaddress=127.0.0.1

Windowsファイアウォールで許可します：

New-NetFirewallRule -DisplayName "OpenClaw Dashboard" `
  -Direction Inbound -LocalPort 19090 -Protocol TCP -Action Allow

LAN上のどのデバイスからもhttp://<your-windows-ip>:19090にアクセスできるようになります。後でプロキシを削除するには：

netsh interface portproxy delete v4tov4 listenport=19090 listenaddress=0.0.0.0

ステップ8：Dockerセットアップ

一部のOpenClawスキルにはDockerが必要です。2つのオプションがあります。

オプションA：Docker Desktop -- Docker Desktop for Windowsをインストール^[4]し、「WSL 2ベースエンジンを使用」がチェックされていることを確認し、設定 > リソースでUbuntuのWSL統合を有効にします。

オプションB：WSL内のDocker Engine（ライセンス制限なし）：

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
  sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) \
  signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo $VERSION_CODENAME) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin
sudo usermod -aG docker $USER && newgrp docker
sudo systemctl enable docker && sudo systemctl start docker

パフォーマンスのヒント

ファイルはLinuxファイルシステム上に保持。 /home/でのファイルI/Oは/mnt/c/の5〜10倍高速です^[5]。OpenClawの作業ディレクトリは常にLinux側に保持してください。

メモリの調整。 Windows側で%UserProfile%\.wslconfigを作成します：

[wsl2]
memory=8GB
swap=4GB
processors=4
localhostForwarding=true

PowerShellからwsl --shutdownで適用します。

大きなファイルを削除した後のディスク領域の回収：

wsl --shutdown
Optimize-VHD -Path "$env:LOCALAPPDATA\Packages\CanonicalGroupLimited.Ubuntu*\LocalState\ext4.vhdx" -Mode Full

Windowsタスクスケジューラで常時稼働

C:\Scripts\start-openclaw.batを保存：

@echo off
wsl -d Ubuntu -u your_username -- bash -c "openclaw start --daemon"

タスクスケジューラ（taskschd.msc）で、30秒遅延で起動時に実行するタスクを作成し、ユーザーがログオンしているかどうかにかかわらず実行するよう設定します。または、WSL内のsystemdサービスを使用します（systemdガイドをご覧ください）。

WSL2の一般的な問題

DNS障害： aptやcurlがホストを解決できない場合：

sudo rm /etc/resolv.conf
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf

スリープ後の時刻ズレ： 時刻がずれたことによるTLS障害：

sudo hwclock -s

Vmmemのメモリ高消費： 上記のように.wslconfigで制限を設定するか、キャッシュを解放します：

sudo sh -c "echo 3 > /proc/sys/vm/drop_caches"

Windowsアップデート後のネットワーク障害：

wsl --shutdown
netsh winsock reset
netsh int ip reset

マネージドの代替手段

WSLセットアップを完全にスキップしたい場合、ClawTankがWebダッシュボード、隔離コンテナ、自動TLS、永続ストレージ付きのホスティングされたOpenClawインスタンスを提供します。

まとめ

1. wsl --installでWSL2をインストール
2. サービス管理のためにsystemdを有効化
3. NodeSourceまたはnvm経由でNode.js 22をインストール
4. openclaw onboardでインスタンスを設定
5. Windowsからlocalhost:19090でダッシュボードにアクセス
6. オプションでポートプロキシでLANアクセスを設定
7. タスクスケジューラまたはsystemdで自動起動を設定

WSL2は、デュアルブートや仮想マシンのオーバーヘッドなしに、Windows上で完全なLinuxネイティブのOpenClaw体験を提供します。

参考文献

1. inotify - Linuxカーネルファイルシステム通知メカニズム
2. Microsoft WSLインストールドキュメント
3. WSLでのsystemdサポート
4. Docker Desktop WSL 2バックエンド
5. WSL2ファイルシステムパフォーマンス比較