Skip to main content
OpenClaw には Node 22.22.3 以降、Node 24.15 以降、または Node 25.9 以降が必要です。インストール、CI、リリースワークフローでは、Node 24 がデフォルトかつ推奨のランタイムです。Node 22 もアクティブな LTS 系列を通じて引き続きサポートされます。Node 23 はサポートされません。インストーラースクリプトは Node を自動的に検出してインストールします。Node を自分でセットアップする場合(バージョン、PATH、グローバルインストール)は、このページを参照してください。

バージョンを確認する

v24.15.0 以降の 24.x が推奨されるデフォルトです。v22.22.3 以降の 22.x は、サポートされる Node 22 LTS の選択肢です。Node v25.9.0+ もサポートされます。Node 23 はサポートされません。Node がインストールされていない場合や、サポート対象範囲外の場合は、以下からインストール方法を選択してください。

Node をインストールする

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

トラブルシューティング

openclaw: command not found

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

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

2

PATH に含まれているか確認する

出力に <npm-prefix>/bin(macOS/Linux)または <npm-prefix>(Windows)が含まれているか確認します。
3

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

~/.zshrc または ~/.bashrc に以下を追加します。
その後、新しいターミナルを開きます(または zsh では rehash、bash では hash -r を実行します)。

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

EACCES エラーが表示される場合は、npm のグローバルプレフィックスをユーザーが書き込み可能なディレクトリに変更します。
永続的に適用するには、export PATH=... の行を ~/.bashrc または ~/.zshrc に追加します。

関連項目