Node.js のセットアップ

新しいツールを導入する際、環境変数の設定やバージョンの不一致で時間を取られるのは本当にもどかしいですよね。特に Node.js は、グローバルにインストールしたはずのコマンドが動かないといったトラブルが起きがちです。

こうしたセットアップの悩みを取り除き、すぐに開発に取り掛かれるよう、適切な設定方法を確認していきましょう。

必要なもの

• Node 22 以上

OpenClaw には Node 22 以降が必要です。installer script を使用すれば Node.js は自動的に検出・インストールされます。このガイドは、手動で Node.js を管理し、バージョンや PATH、グローバルインストールを正しく設定したい方向けの内容です。

クイックスタート

まずは、現在インストールされているバージョンを確認します。

node -v

v22.x.x 以上の数字が表示されれば準備完了です。Node.js がインストールされていない場合や、バージョンが古い場合は、以下の方法でインストールしてください。

OS 別のインストール方法

macOS:

Homebrew （推奨）:

brew install node

または、nodejs.org から macOS 用インストーラーをダウンロードしてください。

Linux:

Ubuntu / Debian:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora / RHEL:

sudo dnf install nodejs

Windows:

winget （推奨）:

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

バージョンマネージャーの使用

Node.js のバージョンを簡単に切り替えたい場合は、バージョンマネージャーの利用がおすすめです。

• fnm — 高速でクロスプラットフォームに対応（おすすめ）
• nvm — macOS や Linux で広く普及

fnm を使用した例：

fnm install 22
fnm use 22

注意

バージョンマネージャーを使用する場合は、シェルの設定ファイル（~/.zshrc や ~/.bashrc）で初期化設定が記述されているか確認してください。設定されていない場合、新しいターミナルセッションで Node.js の bin ディレクトリに PATH が通らず、openclaw コマンドが見つからない原因になります。

トラブルシューティング

openclaw: command not found

このエラーは、npm のグローバル bin ディレクトリが PATH に含まれていないことが原因です。

1. グローバルの npm prefix を確認

    npm prefix -g

2. PATH に含まれているか確認

    echo "$PATH"

出力の中に <npm-prefix>/bin (macOS/Linux) または <npm-prefix> (Windows) があるか探します。

3. 設定ファイルに追加

macOS / Linux:

~/.zshrc または ~/.bashrc に以下を追記します。

export PATH="$(npm prefix -g)/bin:$PATH"

その後、新しいターミナルを開くか、rehash (zsh) または hash -r (bash) を実行してください。

Windows:

npm prefix -g の出力結果を、システム設定の「環境変数」から PATH に追加してください。

Linux での npm install -g 権限エラー

EACCES エラーが発生する場合は、npm のグローバル prefix をユーザーが書き込み可能なディレクトリに変更してください。

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

この export PATH=... の行を ~/.bashrc や ~/.zshrc に追記することで、設定が永続化されます。

---

セットアップ中に不明な点があれば、AI Setup Assistant にいつでも相談してください。

次のステップ

• インストール方法の詳細