メインコンテンツへスキップ

​
Node.js

OpenClaw には Node 22.14 以降 が必要です。Node 24 がデフォルトであり、推奨される実行時環境 です。インストール、CI、リリースワークフローでは Node 24 を推奨します。Node 22 もアクティブな LTS 系列として引き続きサポートされます。インストーラースクリプト は Node を自動検出してインストールします。このページは、Node を自分でセットアップし、すべてが正しく構成されていること（バージョン、PATH、グローバルインストール）を確認したい場合のためのものです。

​
バージョンを確認する

node -v
これが v24.x.x 以降を表示する場合、推奨されるデフォルト環境です。v22.14.x 以降を表示する場合、サポート対象の Node 22 LTS 環境ですが、可能なときに Node 24 へアップグレードすることを推奨します。Node がインストールされていない、またはバージョンが古すぎる場合は、以下のインストール方法を選んでください。

​
Node をインストールする

Homebrew（推奨）:
brew install node
または nodejs.org から macOS インストーラーをダウンロードしてください。
バージョンマネージャーを使うと、Node のバージョンを簡単に切り替えられます。代表的な選択肢:
  • fnm — 高速でクロスプラットフォーム
  • nvm — macOS/Linux で広く使われている
  • mise — polyglot（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 に追加してください。

​
関連