メインコンテンツへスキップ
OpenClaw には Node 22.19+、Node 23.11+、または Node 24+ が必要です。Node 24 はインストール、CI、リリースワークフローでのデフォルトかつ推奨ランタイムです。Node 22 はアクティブな LTS ラインを通じて引き続きサポートされます。インストーラースクリプトは Node を自動的に検出してインストールします。このページは、Node を自分で設定したい場合（バージョン、PATH、グローバルインストール）に使用してください。

​
バージョンを確認する

node -v
v24.x.x 以上が推奨されるデフォルトです。v22.19.x 以上はサポートされる Node 22 LTS パスです（都合のよいときに Node 24 へアップグレードしてください）。v23.11.0 より前の Node 23 ビルドはサポートされません。Node がないか、サポート範囲外の場合は、以下のインストール方法を選んでください。

​
Node をインストールする

Homebrew（推奨）:
brew install node
または、nodejs.org から macOS インストーラーをダウンロードします。
バージョンマネージャーを使うと、Node のバージョンを簡単に切り替えられます。よく使われる選択肢:
  • fnm - 高速、クロスプラットフォーム
  • nvm - macOS/Linux で広く使用
  • mise - 多言語対応（Node、Python、Ruby など）
fnm の例:
fnm install 24
fnm use 24
シェルの起動ファイル（~/.zshrc または ~/.bashrc）でバージョンマネージャーを初期化してください。これを省略すると、PATH に Node の bin ディレクトリが含まれないため、新しいターミナルセッションで 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

シェルの起動ファイルに追加する

~/.zshrc または ~/.bashrc に追加します:
export PATH="$(npm prefix -g)/bin:$PATH"
その後、新しいターミナルを開きます（または zsh で rehash、bash で hash -r を実行します）。

​
npm install -g で権限エラーが発生する（Linux）

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 に追加します。

​
関連