Node.jsバージョンの重要性
OpenClawはNode.js 22以上を必要とします。これは任意の推奨ではなく、ハードな要件です。22未満のバージョンでは、OpenClawが起動できないか、予期しないエラーが発生します。Node.js 22には、改善されたESMサポート、ネイティブWebSocket API、パフォーマンスの最適化など、OpenClawが依存する多くの機能が導入されています。
また特に注意すべき点として、BunはNode.jsの代替として近年急速に発展していますが、OpenClaw公式ではBunでの実行を推奨していません。WhatsAppやTelegramのWebSocket接続の処理に既知の互換性問題があるためです。
nvm（Node Version Manager）は複数のNode.jsバージョンを管理する最適なツールで、システム全体の環境に影響を与えることなく、異なるバージョン間を自由に切り替えることができます。
nvmのインストール
macOSとLinux
macOSとLinuxでのnvmのインストールは非常に簡単です。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
インストールスクリプトは自動的にnvmロードコマンドをシェル設定ファイル（~/.bashrc、~/.zshrcなど）に追加します。インストール完了後、シェルを再読み込みします。
source ~/.bashrc
zshを使用している場合（macOSのデフォルトシェル）：
source ~/.zshrc
nvmのインストール成功を確認します。
nvm --version
Windows（WSL2）
OpenClawはWindows上ではWSL2での実行を推奨しています。WSL2のUbuntu環境では、nvmのインストール方法はLinuxと同じです。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
ネイティブWindows環境を使用する場合は、nvm-windows（https://github.com/coreybutler/nvm-windows）の使用を検討できますが、最高の互換性を得るためにWSL2の使用を強くお勧めします。
Node.js 22のインストール
nvmを使用して最新のNode.js 22 LTSバージョンをインストールします。
nvm install 22
nvmは自動的に指定バージョンをダウンロード、コンパイル（必要な場合）、インストールします。インストール完了後、自動的にそのバージョンに切り替わります。
node --version
出力が v22.x.x であることを確認してください。
デフォルトバージョンに設定する
Node.js 22をnvmのデフォルトバージョンに設定すると、新しいターミナルを開くたびに自動的に使用されます。
nvm alias default 22
デフォルトバージョンの設定を確認します。
nvm current
OpenClawのインストール
Node.js環境の準備ができたら、OpenClawをインストールできます。
方法1：npmグローバルインストール
npm install -g openclaw@latest
方法2：公式インストールスクリプト
curl -fsSL https://openclaw.ai/install.sh | bash
どちらの方法でもOpenClawがグローバルコマンドラインツールとしてインストールされます。インストールを確認します。
openclaw --version
OpenClawの初期化
初回インストール後、ガイドプログラムを実行して設定を完了します。
openclaw onboard --install-daemon
ガイドプログラムが以下の手順を案内します。
- AIモデルプロバイダー（OpenAI、Anthropicなど）のAPIキーを設定
- チャットプラットフォーム（WhatsApp、Telegram、Discordなど）を選択して接続
- バックグラウンドデーモンをインストール（macOSではLaunchAgent、LinuxではSystemdサービス）
すべての設定は ~/.openclaw/openclaw.json ファイルに保存されます。
インストール後の検証
OpenClaw内蔵の診断ツールを実行して、環境が正しく設定されているか確認します。
openclaw doctor
このコマンドは以下をチェックします。
- Node.jsバージョンが22+の要件を満たしているか
- OpenClaw設定ファイルが完全か
- 各チャットプラットフォームの接続が正常か
- ネットワーク接続性
すべてのチェック項目に合格したら、OpenClawを起動します。
openclaw start
または管理パネルを開きます。
openclaw dashboard
nvmの日常的な使い方のコツ
インストール済みバージョンの確認
nvm ls
利用可能なリモートバージョンの確認
nvm ls-remote --lts
バージョンの切り替え
nvm use 22
プロジェクトレベルでのバージョン固定
プロジェクトディレクトリに .nvmrc ファイルを作成して、Node.jsバージョンを固定します。
echo "22" > .nvmrc
その後、プロジェクトディレクトリで nvm use を実行するだけで、nvmが自動的に .nvmrc を読み取り、指定バージョンに切り替えます。
自動バージョン切り替え
~/.bashrc または ~/.zshrc に以下のスクリプトを追加すると、プロジェクトディレクトリに入った際にNode.jsバージョンが自動的に切り替わります。
autoload -U add-zsh-hook
load-nvmrc() {
local nvmrc_path="$(nvm_find_nvmrc)"
if [ -n "$nvmrc_path" ]; then
local nvmrc_node_version=$(nvm version "$(cat "${nvmrc_path}")")
if [ "$nvmrc_node_version" = "N/A" ]; then
nvm install
elif [ "$nvmrc_node_version" != "$(nvm version)" ]; then
nvm use
fi
fi
}
add-zsh-hook chdir load-nvmrc
load-nvmrc
Node.jsバージョンのアップグレード
Node.jsの新バージョンがリリースされた場合、nvmを使って簡単にアップグレードできます。
nvm install 22 --reinstall-packages-from=current
--reinstall-packages-from=current パラメータは、現在のバージョンにグローバルインストールされたnpmパッケージ（OpenClawを含む）を自動的に新バージョンに移行します。
アップグレード後、OpenClawが引き続き正常に動作することを確認します。
openclaw --version
openclaw doctor
古いバージョンのアンインストール
アップグレード後、不要になった古いバージョンをクリーンアップできます。
nvm uninstall 20
よくある質問
nvmコマンドが見つからない
シェル設定ファイルにnvmロードスクリプトが含まれていることを確認してください。~/.bashrc または ~/.zshrc に以下の内容があるか確認します。
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
バージョン切り替え後にグローバルnpmパッケージが消える
nvmの各Node.jsバージョンには独立したグローバルパッケージディレクトリがあります。バージョンを切り替えた後はグローバルパッケージを再インストールする必要があります。または --reinstall-packages-from パラメータを使用してインストール時に自動移行できます。
sudo npm installが失敗する
nvmで管理されたNode.jsではsudoを使用する必要はなく、使用すべきでもありません。権限の問題が発生した場合は、誤ってシステムレベルのNode.jsを使用していないか確認してください。which node を実行して、パスがnvmディレクトリ（~/.nvm/versions/node/v22.x.x/bin/node のような）を指していることを確認します。
まとめ
nvmはOpenClawの実行環境管理に柔軟で信頼性の高いソリューションを提供します。nvmを使用すれば、Node.jsバージョンを簡単にインストール、切り替え、管理でき、OpenClawが常に互換性のあるNode.js 22+環境で実行されることを保証できます。開発デバッグでも本番デプロイでも、nvmはNode.jsバージョン管理のベストプラクティスです。