NemoClawのWindows対応状況

NemoClawはWindows環境でWSL2（Windows Subsystem for Linux 2）を経由して動作します。ネイティブWindowsでの直接実行は非対応のため、WSL2の導入が必須条件となります。

Windows環境NemoClaw対応備考
Windows 11 Pro/Enterprise + WSL2○ 動作GPU Passthrough対応
Windows 11 Home + WSL2△ 制限ありGPU割り当て失敗の報告あり
Windows 10 (21H2以降) + WSL2△ 制限ありカーネル5.10.43.3以上必要
ネイティブWindows（WSL2なし）✕ 非対応—

重要: NemoClawのサンドボックスはLinuxコンテナ上で動作するため、WSL2は省略できません。Windows環境で最も安定した構成はWindows 11 Pro + WSL2 + NVIDIA GPUです。

Windowsエディション別の注意点

NemoClawの動作安定性はWindowsのエディションに左右されます。

Windows 11 Pro / Enterprise:

  • Hyper-Vが標準で利用可能 → WSL2のパフォーマンスが最適
  • GPU Passthroughが安定して動作
  • Docker Desktop for Windowsとの相性が良い

Windows 11 Home:

  • WSL2は利用可能だが、一部制限あり
  • GitHub Issue #152で報告：GPU割り当て失敗（「No assignable GPU found」エラー）
  • 回避策としてCloud NIM推論を使用すればGPU不要で動作可能

Windows 10:

  • 21H2以降でWSL2に対応
  • WSLカーネルを5.10.43.3以上にアップデートする必要あり
  • wsl --updateで最新版に更新すること

Windows環境の前提条件

NemoClawをWindowsで動作させるために必要なソフトウェアと設定です。

項目要件確認方法
OSWindows 10 21H2以降 / Windows 11winver
WSL2有効化済みwsl --status
Ubuntu22.04 LTS（WSL2内）lsb_release -a
Docker Desktop4.30以降（WSL2バックエンド）docker --version
Node.js20 LTS以降node --version
Python3.11以降python3 --version
NVIDIA GPU Driver最新版（Windows側）nvidia-smi（WSL2内）

WSL2の有効化とUbuntuインストール

WSL2がまだ有効化されていない場合は、PowerShell（管理者権限）で以下を実行します。

# WSL2の有効化（Windows 10/11共通）
wsl --install

# 再起動後、Ubuntu 22.04をインストール
wsl --install -d Ubuntu-22.04

# WSL2がデフォルトバージョンか確認
wsl --set-default-version 2

# インストール確認
wsl -l -v
# NAME            STATE           VERSION
# Ubuntu-22.04    Running         2

初回起動時にUbuntuのユーザー名・パスワードの設定を求められます。

NVIDIA GPUドライバの設定（CUDA on WSL2）

NemoClawでローカル推論を使用する場合、NVIDIA GPUのWSL2対応ドライバが必要です。重要: ドライバはWindows側にインストールします。WSL2内にCUDAドライバをインストールしないでください。

  1. NVIDIA公式サイトから最新のGame Ready / Studioドライバをダウンロード・インストール
  2. PCを再起動
  3. WSL2のUbuntuを起動し、GPU認識を確認
# WSL2内でGPU認識確認
nvidia-smi

# 以下のような出力が表示されればOK
# +-----------------------------------------------------------------------------+
# | NVIDIA-SMI 560.xx    Driver Version: 560.xx    CUDA Version: 12.x          |
# |-------------------------------+----------------------+---------------------+
# | GPU  Name        ...          |                      |                     |
# | 0    GeForce RTX 4090  ...    |                      |                     |
# +-------------------------------+----------------------+---------------------+

nvidia-smiでGPUが表示されない場合は、Windowsのドライバを最新版に更新してからWSL2を再起動（wsl --shutdown後に再起動）してください。

Docker Desktop（WSL2バックエンド）の設定

Docker DesktopをWSL2バックエンドで動作させる設定です。

  1. Docker Desktop公式サイトからWindows版をダウンロード・インストール
  2. Settings → General → 「Use the WSL 2 based engine」にチェック
  3. Settings → Resources → WSL Integration → Ubuntu-22.04を有効化
  4. Settings → Resources → メモリを8GB以上に設定
# WSL2のUbuntu内でDocker動作確認
docker --version
docker run hello-world

NemoClawのインストール手順（Windows / WSL2）

ここからの操作はすべてWSL2のUbuntuターミナル内で行います。Windows側のPowerShellやコマンドプロンプトではありません。

依存パッケージのインストール

# パッケージリスト更新
sudo apt update && sudo apt upgrade -y

# Node.js 20 LTS（NodeSourceリポジトリ）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# Python 3.11+
sudo apt install -y python3 python3-pip python3-venv

# Git（通常プリインストール済み）
sudo apt install -y git

# バージョン確認
node --version   # v20.x.x
python3 --version  # Python 3.11.x

NemoClawのインストール

# 公式インストールスクリプト
curl -fsSL https://nvidia.com/nemoclaw.sh | bash

# インストール確認
nemoclaw --version

# 初回セットアップ
nemoclaw setup

セットアップ時に推論プロファイルを選択します。NVIDIA GPU搭載PCではOption 2（nim-local）でローカル推論が利用可能です。GPU非搭載の場合はOption 1（Cloud NIM）を選択してください。

Windows環境での推論プロファイル選択

推論プロファイルWindows対応要件推奨度
Cloud NIM○NVIDIA APIキーのみ★★★ GPU非搭載PC向け
nim-local○NVIDIA GPU + CUDA★★★ GPU搭載PC向け
vLLM○NVIDIA GPU + VRAM 24GB+★★ 上級者向け
Ollama△NVIDIA GPU★ 安定性に難あり

Windows + NVIDIA GPU環境の最大のメリットは、ローカル推論が安定して動作する点です。GeForce RTX 4060以上であれば、Nemotron 3 Nano 30B（vLLMプロファイル）をローカルで実行できます。

Windows環境でのトラブルシューティング

GPU割り当て失敗（Windows Homeで頻発）

Windows Home環境で「No assignable GPU found」エラーが発生する場合があります（GitHub Issue #152）。

対処法:

  1. Windows側のNVIDIAドライバを最新版に更新
  2. WSL2を再起動: wsl --shutdown → WSL再起動
  3. nvidia-smiでGPU認識を再確認
  4. 解決しない場合はCloud NIM推論に切り替え
nemoclaw config set inference.provider cloud-nim

サンドボックス検出ループ（Step 7で停止）

セットアップのStep 7でサンドボックスの検出が無限ループに入る問題が報告されています。

対処法:

  1. Docker Desktopを再起動
  2. WSL2のメモリ制限を確認 — C:\Users\ユーザー名\.wslconfigに以下を追加: 
    [wsl2]
memory=8GB
swap=4GB
processors=4
  3. WSL2を再起動: wsl --shutdown
  4. NemoClawのセットアップを再実行: nemoclaw setup --reset

ファイルパーミッションの問題

WSL2とWindows間のファイルシステムの違いにより、パーミッションエラーが発生することがあります。

重要: NemoClawのプロジェクトファイルはWSL2のLinuxファイルシステム内（/home/ユーザー名/以下）に置いてください。

# NG: Windowsのマウントパス（遅い＆パーミッション問題）
/mnt/c/Users/username/NemoClaw/

# OK: WSL2のLinuxファイルシステム
/home/username/NemoClaw/

/mnt/c/以下にプロジェクトを配置すると、ファイルI/Oが10〜100倍遅くなるだけでなく、Dockerボリュームマウントでパーミッションエラーが発生します。

用途CPUメモリGPUストレージ
Cloud NIM推論のみ4コア以上16GB不要SSD 50GB
ローカル推論（30B）8コア以上32GBRTX 4060 Ti 16GBSSD 100GB
ローカル推論（120B）8コア以上64GBRTX 4090 24GBSSD 200GB
本番環境相当16コア以上128GBRTX 6000 Ada 48GBNVMe 500GB

開発・テスト用途であれば、GPU不搭載のPCでもCloud NIM推論で十分にNemoClawを活用できます。ローカル推論を行う場合は、VRAM 16GB以上のNVIDIA GPUが事実上の最低要件です。