Windows ユーザーに WSL2 が必要な理由
OpenClaw はオープンソースの AI Agent ゲートウェイで、macOS、Linux、Windows プラットフォームをサポートしていますが、公式には Windows ユーザーが WSL2（Windows Subsystem for Linux 2）を通じて実行することを強く推奨しています。WSL2 は完全な Linux カーネルサポートを提供し、OpenClaw が依存する各種ネイティブモジュールやネットワークプロトコルをより適切に処理できます。ネイティブ Windows 環境での実行では、パス処理、ファイル監視、ネイティブモジュールのコンパイルなどの面で互換性の問題が生じる可能性があります。
本記事では、ゼロから Windows 上で WSL2 を設定し、OpenClaw をインストールする手順を案内します。
システム要件
- Windows 10 バージョン 2004 以上、または Windows 11
- 最低 8GB メモリ（16GB 推奨）
- 仮想化機能が有効になっていること（BIOS で VT-x/AMD-V を有効化）
- 安定したネットワーク接続
WSL2 のインストール
ワンクリックインストール（推奨）
管理者として PowerShell または Windows Terminal を開き、以下を実行します。
wsl --install
このコマンドは以下の操作を自動的に完了します。WSL 機能の有効化、仮想マシンプラットフォームの有効化、最新 Linux カーネルのダウンロードとインストール、WSL2 をデフォルトバージョンに設定、Ubuntu ディストリビューションのインストール。
インストール完了後、PC の再起動が必要です。
Ubuntu の初回起動
再起動後、スタートメニューから Ubuntu を開きます。初回起動時に Linux のユーザー名とパスワードの作成が求められます。設定完了後、Ubuntu の bash ターミナルに入ります。
WSL のバージョンが 2 であることを確認します。
wsl --list --verbose
VERSION が 1 と表示される場合は、変換が必要です。
wsl --set-version Ubuntu 2
Ubuntu システムの更新
WSL2 の Ubuntu ターミナルに入ったら、まずシステムを更新します。
sudo apt update && sudo apt upgrade -y
基本的な開発ツールをインストールします。
sudo apt install -y build-essential curl git
Node.js 22 のインストール
OpenClaw は Node.js 22 以上のバージョンが必要です。nvm を使用して Node.js のバージョンを管理することを推奨します。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
Node.js 22 をインストールします。
nvm install 22
nvm alias default 22
インストールを確認します。
node --version
npm --version
Node.js のバージョンが 22.x.x であることを確認します。特に注意：Node.js の代替として Bun を使用しないでください。Bun は WhatsApp と Telegram の接続処理に既知の互換性の問題があります。
OpenClaw のインストール
2 つのインストール方法から選択できます。
方法1：npm グローバルインストール
npm install -g openclaw@latest
方法2：公式インストールスクリプト
curl -fsSL https://openclaw.ai/install.sh | bash
インストール完了後に確認します。
openclaw --version
設定の初期化
OpenClaw のガイダンスプログラムを実行して初期化を完了します。
openclaw onboard --install-daemon
ガイダンスプログラムが以下の設定を案内します。
- AI モデル設定：AI プロバイダー（OpenAI、Anthropic、Google など）を選択し、API キーを入力
- チャットプラットフォーム接続：接続するチャットアプリ（WhatsApp、Telegram、Discord など）を設定
- デーモンプロセスインストール：WSL2 の Ubuntu 環境では systemd サービスを設定（WSL2 で systemd が有効になっている場合）
すべての設定は ~/.openclaw/openclaw.json ファイルに保存されます。
WSL2 での systemd サポートの有効化
新しいバージョンの WSL2 は systemd をサポートしており、OpenClaw のバックグラウンドサービス管理に非常に重要です。systemd が有効になっているか確認します。
systemctl --version
コマンドが使用できない場合は、systemd を有効にする必要があります。WSL 設定ファイルを編集します。
sudo nano /etc/wsl.conf
以下の内容を追加します。
[boot]
systemd=true
保存後、PowerShell で WSL を再起動します。
wsl --shutdown
Ubuntu ターミナルを再度開くと、systemd が動作しているはずです。
systemd サービスの設定
openclaw onboard --install-daemon が自動的に systemd サービスを作成しなかった場合は、手動で作成できます。
sudo tee /etc/systemd/system/openclaw.service > /dev/null << 'EOF'
[Unit]
Description=OpenClaw AI Agent Gateway
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=あなたのユーザー名
ExecStart=/home/あなたのユーザー名/.nvm/versions/node/v22.0.0/bin/openclaw start
Restart=always
RestartSec=5
Environment=HOME=/home/あなたのユーザー名
Environment=PATH=/home/あなたのユーザー名/.nvm/versions/node/v22.0.0/bin:/usr/bin:/bin
[Install]
WantedBy=multi-user.target
EOF
ユーザー名と Node.js の実際のバージョンパスに置き換えてください。サービスを有効にして起動します。
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw
診断チェックの実行
組み込みの診断ツールを使用して、すべてが正常であることを確認します。
openclaw doctor
このコマンドは Node.js のバージョン、設定ファイルの完全性、ネットワーク接続性、各プラットフォームの接続状態などをチェックします。
Windows から OpenClaw にアクセスする
WSL2 内で動作するサービスは、Windows ブラウザから localhost 経由で直接アクセスできます。ブラウザを開いて以下にアクセスします。
http://localhost:3000
OpenClaw の管理パネルが表示されます。WSL2 内で以下を実行することもできます。
openclaw dashboard
WSL2 ネットワーク設定の注意事項
ポートフォワーディング
デフォルトでは、WSL2 はポートを Windows ホストに自動的にマッピングします。Windows からアクセスできない場合は、Windows ファイアウォールの設定を確認し、3000 ポートがブロックされていないことを確認してください。
外部アクセス
LAN 上の他のデバイスから WSL2 内の OpenClaw にアクセスする必要がある場合（例：Webhook コールバックの設定）、追加のポートフォワーディング設定が必要な場合があります。
netsh interface portproxy add v4tov4 listenport=3000 listenaddress=0.0.0.0 connectport=3000 connectaddress=$(wsl hostname -I | awk '{print $1}')
ファイルシステムパフォーマンスの最適化
WSL2 には 2 つのファイルシステムがあります。Linux ファイルシステム（/home/）と Windows ファイルシステム（/mnt/c/ など）です。OpenClaw のデータを Linux ファイルシステムに置くことで最高のパフォーマンスが得られます。~/.openclaw ディレクトリを /mnt/ 下の Windows パーティションに配置しないでください。
WSL2 の自動起動
デフォルトでは、WSL2 は手動で開く必要があります。Windows のタスクスケジューラで自動起動を実現できます。
PowerShell でスケジュールタスクを作成します。
$action = New-ScheduledTaskAction -Execute "wsl.exe" -Argument "-d Ubuntu -- bash -c 'sudo systemctl start openclaw'"
$trigger = New-ScheduledTaskTrigger -AtLogon
Register-ScheduledTask -TaskName "StartOpenClaw" -Action $action -Trigger $trigger -Description "Start OpenClaw in WSL2"
よくある問題のトラブルシューティング
WSL2 がネットワークに接続できない
DNS 設定を確認します。/etc/wsl.conf を編集して以下を追加します。
[network]
generateResolvConf=false
続いて DNS を手動で設定します。
sudo rm /etc/resolv.conf
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf
メモリ使用量が高すぎる
WSL2 はデフォルトで多くのメモリを消費する場合があります。Windows のユーザーディレクトリに .wslconfig ファイルを作成します。
[wsl2]
memory=4GB
swap=2GB
OpenClaw が起動しない
Linux ファイルシステム内で実行していること、Node.js のバージョンが 22 以上であること、ネットワークが正常であることを確認します。openclaw doctor を実行して詳細な診断情報を取得してください。
まとめ
WSL2 は Windows ユーザーに OpenClaw を実行するための最適な環境を提供します。本記事の設定により、Windows デスクトップシステム上で Linux サーバーとほぼ同等の OpenClaw 実行体験が得られ、同時に Windows デスクトップ環境の利便性も享受できます。WSL2 のパフォーマンスはネイティブ Linux に近く、OpenClaw AI Agent ゲートウェイの実行要件を十分に満たします。