NemoClaw Ubuntu インストール完全ガイド｜22.04/24.04 対応【2026年版】

NemoClawのUbuntu対応状況

NemoClawの公式サポートOSはUbuntu 22.04 LTS以降です。Ubuntuは全プラットフォームの中で最も動作が安定しており、NVIDIAの公式ドキュメントもUbuntuを前提に書かれています。

WindowsのWSL2やmacOSと違い、ネイティブUbuntuであればOpenShellランタイムが完全に動作し、GPUのパフォーマンスも最大限に発揮できます。サーバー・クラウドVM・ローカル開発マシンいずれの環境でもこの手順で対応できます。

Ubuntu vs 他のOSの比較

システム要件・事前準備

インストール前に以下の要件を満たしているか確認してください。

ハードウェア要件

ソフトウェア要件

以下のソフトウェアが事前にインストールされている必要があります。

• Ubuntu 22.04 LTS または 24.04 LTS（カーネル 5.15以上）
• Docker Engine 24.0以上（Docker Desktopは不可、Engine推奨）
• Node.js 20以上 ＋ npm 10以上
• OpenShell（NemoClawのインストーラが自動でインストール）
• NVIDIAコンテナツールキット（GPU使用時のみ）

NVIDIAアカウントとAPIキーの取得

NemoClawのクラウド推論（Nemotron 3 Super 120B）を使用するにはNVIDIA APIキーが必要です。

1. build.nvidia.com にアクセスしてアカウント作成
2. 「API Keys」セクションから新しいキーを生成
3. キーをメモしておく（後でセットアップ時に使用）

ローカル推論（Nemotron 3 Nano 30B）のみ使用する場合はAPIキー不要ですが、その場合はGPUが必要です。

Step 1：Docker Engineのインストール

NemoClawの前提となるDocker Engineをインストールします。公式リポジトリから最新版を取得します。

# 古いDockerがあれば削除
sudo apt-get remove docker docker-engine docker.io containerd runc

# 必要パッケージの追加
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg lsb-release

# DockerのGPGキーを追加
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
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# リポジトリ追加
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Docker Engineインストール
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# 現在のユーザーをdockerグループに追加（sudo不要にする）
sudo usermod -aG docker $USER
newgrp docker

# 動作確認
docker --version

Step 2：Node.js 20のインストール

NemoClawのオーケストレーションスクリプトはNode.js 20以上が必要です。nvmを使うとバージョン管理が楽になります。

# nvmのインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# シェルを再読み込み
source ~/.bashrc

# Node.js 20をインストールしてデフォルトに設定
nvm install 20
nvm use 20
nvm alias default 20

# バージョン確認
node --version   # v20.x.x が表示されればOK
npm --version    # 10.x.x が表示されればOK

Step 3（GPU使用時のみ）：NVIDIAコンテナツールキット

GPU対応マシンでローカル推論を使う場合のみ必要です。不要な場合はStep 4へ進んでください。

# NVIDIAコンテナツールキットのリポジトリ追加
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list

# インストール
sudo apt-get update
sudo apt-get install -y nvidia-container-toolkit

# Dockerと連携設定
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker

# 動作確認
docker run --rm --gpus all nvidia/cuda:12.0-base-ubuntu22.04 nvidia-smi

Step 4：NemoClawのインストール（1コマンド）

ここまでの準備が完了したら、NemoClawを1コマンドでインストールします。

curl -fsSL https://nemoclaw.ai/install.sh | sh

このコマンドは以下を自動的に実行します。

1. OpenShellランタイムのダウンロード・インストール（約2.4GB）
2. NemoClaw CLIのインストール
3. デフォルト設定ファイル（~/.nemoclaw/config.yaml）の生成
4. 起動スクリプトの配置

通信速度により5〜15分程度かかります。

APIキーの設定

インストール完了後、NVIDIAのAPIキーを設定します。

# APIキーを環境変数に設定（一時的）
export NVIDIA_API_KEY="nvapi-xxxxxxxxxxxx"

# または設定ファイルに書き込む（永続的）
nemoclaw config set api-key nvapi-xxxxxxxxxxxx

# 設定確認
nemoclaw config show

インストール確認

# バージョン確認
nemoclaw --version

# OpenShell動作確認
nemoclaw check

# 期待する出力:
# ✅ Docker: running
# ✅ OpenShell: v0.4.x
# ✅ Node.js: v20.x.x
# ✅ NVIDIA API key: configured
# ✅ NemoClaw: ready

Step 5：最初のエージェントを起動する

インストール確認ができたら、サンプルエージェントを起動してみましょう。

# OpenClawを起動
nemoclaw start

# 別のターミナルでOpenClawのUIを開く
# ブラウザで http://localhost:3000 にアクセス

ブラウザで http://localhost:3000 を開くと、OpenClawのダッシュボードが表示されます。NemoClawがOpenShellランタイムでOpenClawをラップした状態で起動しています。

推論プロファイルの選択

起動時に推論プロファイルを指定できます。

# クラウド推論（APIキー必要、高性能）
nemoclaw start --profile cloud

# ローカル軽量モデル（GPU必要、プライバシー重視）
nemoclaw start --profile local

# デフォルト（設定ファイルの値を使用）
nemoclaw start

よくあるエラーと対処法

Ubuntuへのインストールでよく発生するエラーと解決策をまとめました。

OOMキラーが発動する（メモリ不足）

症状：インストール中やエージェント起動時にプロセスが突然終了する。

原因：RAMが8GB未満のためOpenShellイメージ展開時にOOMキラーが発動。

# スワップ領域を追加して対処（応急処置）
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 永続化
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Permission denied（Docker権限エラー）

症状：Got permission denied while trying to connect to the Docker daemon socket

# dockerグループに追加（再ログイン必要）
sudo usermod -aG docker $USER

# 再ログインせずに反映する場合
newgrp docker

Node.jsバージョンエラー

症状：Requires Node.js >= 20.0.0, current version: 18.x.x

# nvmで20に切り替え
nvm install 20
nvm use 20

# システムのnodeも切り替える場合
sudo ln -sf $(which node) /usr/local/bin/node

cgroup v2エラー（Ubuntu 20.04使用時）

症状：OpenShell requires cgroup v2

原因：Ubuntu 20.04はデフォルトでcgroup v1が使われています。NemoClawはcgroup v2必須のため、Ubuntu 22.04以降へのアップグレードが根本解決です。

22.04へのアップグレードが難しい場合は、GRUBの起動パラメータに systemd.unified_cgroup_hierarchy=1 を追加することで対処できる場合があります。

クラウドVM（AWS・GCP・Azure）での利用

サーバーサイドでNemoClawを常時稼働させたい場合、クラウドVMが適しています。

AWS EC2での設定

AWS EC2でNemoClawを動かす推奨インスタンスは以下の通りです。

AMIはUbuntu 22.04 LTS（ubuntu/images/hvm-ssd/ubuntu-jammy-22.04）を使用してください。

Brevを使った手軽なクラウドデプロイ

NVIDIAはBrev（クラウド開発環境サービス）との連携を公式に推奨しています。GPUインスタンスをすぐに立ち上げられる上、NemoClawテンプレートも用意されています。

# Brev CLIインストール後
brev open nemoclaw-template

# テンプレートから環境を起動（GPUインスタンス自動割当）