Skip to main content
OpenClaw には Node 22 以降 が必要です。インストーラースクリプト は Node を自動検出して導入しますが、このページは、Node を手動でセットアップし、バージョン、PATH、グローバルインストールが正しく揃っているか確認したい場合のガイドです。

​
バージョンの確認

node -v
ここで v22.x.x 以上が表示されれば問題ありません。Node が未導入、または古すぎる場合は、以下の方法から選んでください。

​
Node のインストール

Homebrew (推奨):
brew install node
または、nodejs.org から macOS 用インストーラーをダウンロードしてください。
バージョンマネージャーを使うと、Node のバージョン切り替えが容易です。代表的な選択肢:
  • fnm — 高速、クロスプラットフォーム
  • nvm — macOS/Linux で広く使用されている
  • mise — 多言語対応（Node, Python, Ruby など）
fnm を使用した例：
fnm install 22
fnm use 22
バージョンマネージャーがシェルの起動ファイル（~/.zshrc または ~/.bashrc）で初期化されていることを確認してください。初期化されていない場合、PATH に Node の bin ディレクトリが含まれないため、新しいターミナルセッションで openclaw が見つからない可能性があります。

​
トラブルシューティング

​
openclaw: command not found

ほとんどの場合、npm のグローバル bin ディレクトリが PATH に入っていないことが原因です。
1

グローバル npm プレフィックスを確認する

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 のグローバルプレフィックスをユーザーが書き込み可能なディレクトリに変更してください： 
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
この設定を永続的にするには、export PATH=... の行を ~/.bashrc または ~/.zshrc に追加してください。