WindowsでOpenClawを導入する方法：WSL2とDockerの手順

Contents

1 前提条件と推奨構成
2 WSL2 のインストールと設定
3 Node.js (LTS) の準備 – nvm 推奨
- 3.1 1. nvm のインストール（WSL 内）
- 3.2 2. LTS 系 Node.js のインストールと使用
4 公式インストーラースクリプトの取得・実行
- 4.1 1. WSL（Ubuntu）側から実行
- 4.2 2. Windows PowerShell から実行（管理者）
  - 4.2.1 実行後の確認ポイント
5 初回起動と代表的なエラー対策
- 5.1 1. OpenClaw の初回起動
- 5.2 2. よくあるエラーと対処法
6 Docker Desktop を使った代替手順（WSL2 バックエンド必須）
7 基本操作例 – タスク作成と実行
8 まとめと次のステップ

スポンサードリンク

前提条件と推奨構成

項目	推奨バージョン / 条件
OS	Windows 10 バージョン 2004 以上、または Windows 11
WSL2	Ubuntu 22.04 LTS（Microsoft Store から取得可）
Docker Desktop	WSL2 バックエンド有効（設定画面で「Use the WSL 2 based engine」にチェック）
Node.js	LTS 系 (v20.x) – nvm で管理すると楽です
権限	PowerShell／コマンドプロンプトは管理者権限で実行（Docker Desktop のインストールやカーネル更新時）

重要
Docker Desktop は内部的に WSL2 を利用します。WSL2 が有効化されていない Windows 環境では Docker Desktop の Linux コンテナは起動できません。その場合は WSL2 のインストールが先決 です。

WSL2 のインストールと設定

1. 必要な Windows 機能を有効化

# PowerShell (管理者) で実行
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# PowerShell (管理者) で実行

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

備考
dism コマンドは GUI の「Windows の機能の有効化または無効化」でも同等に設定できますが、スクリプト化すると再現性が高まります。

2. WSL 本体と Ubuntu をインストール

wsl --install -d Ubuntu-22.04

1 2	wsl --install -d Ubuntu-22.04

このコマンドは以下を自動で行います。

最新の WSL カーネルパッケージをダウンロード
指定したディストリビューション（Ubuntu 22.04）を Microsoft Store から取得
再起動を促す（必要に応じて手動で再起動）

注意
初回起動時にユーザー名とパスワードの設定が求められます。英数字のみ、長さは最低8文字以上を推奨します。

3. カーネル更新プログラム（任意・推奨）

Microsoft は WSL2 用に定期的にカーネル更新パッケージ（.msi）を提供しています。最新版は以下から取得してください。

ダウンロード URL: https://aka.ms/wslkernel （公式 Microsoft Docs へのリンク）

インストール後、バージョンが「2」になっているか確認します。

wsl -l -v
# 出力例
#   NAME            STATE           VERSION
# * Ubuntu-22.04    Running         2

wsl -l -v

# 出力例

# NAME STATE VERSION

# * Ubuntu-22.04 Running 2

ポイント
カーネル更新は OpenClaw の必須条件ではありませんが、最新のシステムコールが利用できるためインストール失敗やパフォーマンス問題を回避しやすくなります。

Node.js (LTS) の準備 – nvm 推奨

OpenClaw の公式インストーラは Node.js LTS が必要です。複数バージョンを安全に管理できる nvm（Node Version Manager） を使うのが最も簡単です。

1. nvm のインストール（WSL 内）

curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# シェルを再起動、または以下で即時反映
source ~/.bashrc

curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# シェルを再起動、または以下で即時反映

source ~/.bashrc

2. LTS 系 Node.js のインストールと使用

nvm install --lts   # v20.x がインストールされます
nvm use --lts
node -v              # =&gt; v20.xx.x と表示されれば成功

nvm install --lts # v20.x がインストールされます

nvm use --lts

node -v # => v20.xx.x と表示されれば成功

ヒント
nvm alias default $(nvm version) を実行しておくと、ターミナル起動時に自動で LTS が選択されます。

公式インストーラースクリプトの取得・実行

OpenClaw の公式サイト（https://openclaw.ai）が提供するシェルスクリプトと PowerShell スクリプトは、OS 判別 → 必要パッケージ自動インストール → OpenClaw 本体取得という流れで構成されています。以下では両方の取得方法を示します。

1. WSL（Ubuntu）側から実行

curl -fsSL https://openclaw.ai/install.sh | bash -

1 2	curl -fsSL https://openclaw.ai/install.sh \| bash -

- はスクリプトをパイプ経由で直接実行することを意味し、途中でファイルとして保存されません。
実行中はインストールログが標準出力に流れ、Node.js・npm パッケージ・Playwright のブラウザバイナリが順次インストールされます。

2. Windows PowerShell から実行（管理者）

セキュリティ上の注意
Set-ExecutionPolicy Bypass は「プロセス単位」のみで適用し、永続的にポリシーを緩めないようにします。実行後は自動的に元の設定へ戻ります。

# 1. スクリプト取得
Invoke-WebRequest -Uri &quot;https://openclaw.ai/install.ps1&quot; -OutFile &quot;$env:TEMP\install.ps1&quot;

# 2. 一時的に実行ポリシーを緩める（プロセススコープのみ）
Set-ExecutionPolicy Bypass -Scope Process -Force

# 3. スクリプト実行
&amp; &quot;$env:TEMP\install.ps1&quot;

# 1. スクリプト取得

Invoke-WebRequest -Uri "https://openclaw.ai/install.ps1" -OutFile "$env:TEMP\install.ps1"

# 2. 一時的に実行ポリシーを緩める（プロセススコープのみ）

Set-ExecutionPolicy Bypass -Scope Process -Force

# 3. スクリプト実行

& "$env:TEMP\install.ps1"

実行後の確認ポイント

確認項目	コマンド例	期待結果
Node.js バージョン	`node -v`	v20.x 系
OpenClaw CLI のインストール	`openclaw --version`	公式バージョン文字列が表示
Playwright が必要なブラウザを取得できているか	`npx playwright install --with-deps`	「All browsers installed」メッセージ

初回起動と代表的なエラー対策

1. OpenClaw の初回起動

openclaw start   # または単に `openclaw`

1 2	openclaw start # または単に `openclaw`

デフォルトで http://localhost:3000 にローカルサーバが立ち上がります。
起動直後に既定ブラウザが自動で開き、Welcome to OpenClaw 画面が表示されればインストール成功です。

2. よくあるエラーと対処法

エラーメッセージ	主な原因	推奨対策
WSL version mismatch	ディストリビューションが WSL1 のまま残っている	`wsl --set-version Ubuntu-22.04 2` を実行し、再起動
Port 3000 already in use	他プロセスが同ポートを占有中	`netstat -ano \\| findstr :3000` → PID を特定し `taskkill /PID <PID> /F`（または `lsof -i:3000`）
Permission denied (npm install)	グローバルインストール時の権限不足	PowerShell／ターミナルを「管理者として実行」する、もしくは `sudo npm install -g …`（WSL）
playwright missing browsers	Playwright がブラウザバイナリ取得に失敗	手動で `npx playwright install` を実行し、エラーログを確認

補足
エラーが発生した場合はまず公式 GitHub Issues（https://github.com/openclaw/openclaw/issues）と Microsoft Docs の「WSL トラブルシューティング」ページを参照してください。

Docker Desktop を使った代替手順（WSL2 バックエンド必須）

1. Docker Desktop のインストール

手順	内容
ダウンロード	https://www.docker.com/products/docker-desktop から Windows 用インストーラを取得
インストール	管理者権限で実行し、ウィザードに従う
WSL2 エンジンの有効化	インストール完了後の設定画面 → 「Resources」→「WSL Integration」→「Use the WSL 2 based engine」にチェック

重要
Docker Desktop が起動できない、または「WSL 2 based engine」がグレーアウトしている場合は、先に WSL2 のインストールとカーネル更新 を完了させる必要があります。

2. `docker-compose.yml` による OpenClaw コンテナ起動例

# docker-compose.yml
version: &quot;3.9&quot;
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw
    ports:
      - &quot;3000:3000&quot;            # Web UI アクセス用
    volumes:
      - openclaw_data:/app/data   # データ永続化
    environment:
      - NODE_ENV=production

volumes:
  openclaw_data:

# docker-compose.yml

version: "3.9"

services:

openclaw:

image: ghcr.io/openclaw/openclaw:latest

container_name: openclaw

ports:

- "3000:3000" # Web UI アクセス用

volumes:

- openclaw_data:/app/data # データ永続化

environment:

- NODE_ENV=production

volumes:

openclaw_data:

起動手順（PowerShell）

# 作業ディレクトリに docker-compose.yml を保存したら
docker compose up -d          # バックグラウンドで起動
docker ps | Where-Object {$_.Names -match &quot;openclaw&quot;}   # コンテナ稼働確認

# 作業ディレクトリに docker-compose.yml を保存したら

docker compose up -d # バックグラウンドで起動

docker ps | Where-Object {$_.Names -match "openclaw"} # コンテナ稼働確認

ブラウザで http://localhost:3000 にアクセスすれば、WSL2 上の Linux コンテナと同様に OpenClaw の UI が表示されます。

3. Docker Desktop 利用時の注意点

項目	内容
リソース制限	「Settings」→「Resources」で CPU・メモリを適切に割り当て（最低 2 CPU、4 GB 推奨）
ファイルシステムのパフォーマンス	Windows 側のボリュームマッピングは I/O が遅くなることがあります。大量データを書き込む場合はコンテナ内部に永続化（`openclaw_data` ボリューム）し、必要時だけエクスポートしてください
WSL2 の更新	Docker Desktop は自動で WSL2 カーネルを取得しますが、手動更新したい場合は前述の「カーネル更新」手順を再実行してください

基本操作例 – タスク作成と実行

1. Web UI からタスクを作成

手順	内容
①	ブラウザで `http://localhost:3000` にアクセスし、左メニューの Tasks → Create Task をクリック
②	以下のような JSON（または YAML）を入力し Save

{
  &quot;name&quot;: &quot;Google Search Demo&quot;,
  &quot;steps&quot;: [
    { &quot;action&quot;: &quot;goto&quot;, &quot;url&quot;: &quot;https://www.google.com&quot; },
    { &quot;action&quot;: &quot;type&quot;, &quot;selector&quot;: &quot;input[name=q]&quot;, &quot;text&quot;: &quot;OpenClaw AI&quot; },
    { &quot;action&quot;: &quot;press&quot;, &quot;key&quot;: &quot;Enter&quot; }
  ]
}

{

"name": "Google Search Demo",

"steps": [

{ "action": "goto", "url": "https://www.google.com" },

{ "action": "type", "selector": "input[name=q]", "text": "OpenClaw AI" },

{ "action": "press", "key": "Enter" }

]

}

| ③ | タスク一覧に戻り、作成したタスクの Run ボタンを押す |
| ④ | 実行結果は UI の Logs タブでリアルタイムに確認可能 |

2. CLI から同様の操作

# タスク定義ファイル (task.json) を保存した上で
openclaw task run ./task.json --watch

# タスク定義ファイル (task.json) を保存した上で

openclaw task run ./task.json --watch

--watch オプションを付けると、実行中のログが標準出力に流れます。
完了後は openclaw logs --tail=100 でも履歴確認できます。

3. データ永続化の場所

環境	永続化ディレクトリ
WSL2 (シェル)	`~/openclaw/data/`
Docker コンテナ	ボリューム `openclaw_data` がマウントされる `/app/data`

備考
バックアップが必要な場合は、上記ディレクトリを定期的に外部ストレージへコピーしてください。

まとめと次のステップ

WSL2 の有効化 → カーネル更新（任意） → Ubuntu 22.04 のインストール
nvm で Node.js LTS (v20) をセットアップ
公式インストーラを curl または PowerShell で取得し実行（PowerShell は一時的に Bypass スコープだけ適用）
openclaw start でローカルサーバ起動 → ブラウザ確認
エラーが出たら上記表を参照して対処。Docker Desktop を使う場合は WSL2 バックエンド必須 であることに注意し、docker-compose.yml によるコンテナ起動も併せて実装可能です。

次の学習テーマ例
- Playwright スクリプトを TypeScript で高度化する方法
- OpenClaw の REST API（/api/v1/tasks）を外部システムと連携させる手順
- 大規模タスク実行時のリソースモニタリング（Docker stats / htop）

これらを踏めば、Windows 環境でも 安全・迅速に OpenClaw を稼働 でき、AI 自動化の第一歩をすぐに体感できます。 Happy hacking!