Install overview
Node.js
OpenClaw には Node 22.16 以降が必要です。インストール、CI、リリースワークフローでは、Node 24 がデフォルトかつ推奨ランタイムです。Node 22 はアクティブな LTS 系列を通じて引き続きサポートされます。インストーラースクリプトは Node を自動的に検出してインストールします。このページは、Node を自分でセットアップし、すべてが正しく接続されていること（バージョン、PATH、グローバルインストール）を確認したい場合のためのものです。
バージョンを確認する
node -vこれが v24.x.x 以上を出力する場合、推奨デフォルトを使用しています。v22.16.x 以上を出力する場合、サポート対象の Node 22 LTS パスを使用していますが、都合のよいタイミングで Node 24 へアップグレードすることを引き続き推奨します。Node がインストールされていない、またはバージョンが古すぎる場合は、以下からインストール方法を選んでください。
Node をインストールする
macOS
Homebrew（推奨）:
brew install nodeまたは nodejs.org から macOS インストーラーをダウンロードします。
Linux
Ubuntu / Debian:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejsFedora / RHEL:
sudo dnf install nodejsまたはバージョンマネージャーを使用します（下記参照）。
Windows
winget（推奨）:
winget install OpenJS.NodeJS.LTSChocolatey:
choco install nodejs-ltsまたは nodejs.org から Windows インストーラーをダウンロードします。
バージョンマネージャー（nvm、fnm、mise、asdf）を使用する
バージョンマネージャーを使うと、Node のバージョンを簡単に切り替えられます。よく使われる選択肢:
fnm の例:
fnm install 24fnm use 24トラブルシューティング
openclaw: command not found
これはほとんどの場合、npm のグローバル bin ディレクトリが PATH に含まれていないことを意味します。
グローバル npm prefix を見つける
npm prefix -gPATH に含まれているか確認する
echo "$PATH"出力に <npm-prefix>/bin（macOS/Linux）または <npm-prefix>（Windows）があるか確認します。
シェルの起動ファイルに追加する
macOS / Linux
~/.zshrc または ~/.bashrc に追加します:
export PATH="$(npm prefix -g)/bin:$PATH"その後、新しいターミナルを開きます（または zsh では rehash、bash では hash -r を実行します）。
Windows
設定 → システム → 環境変数から、npm prefix -g の出力をシステム PATH に追加します。
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 に追加します。