Node ランタイム

Node.js

OpenClaw には Node 22 以降が必要です。インストーラースクリプトは Node を自動的に検出してインストールします — このページは、自分で Node をセットアップし、すべてが正しく設定されていることを確認したい場合(バージョン、PATH、グローバルインストール)のためのものです。

バージョンの確認

node -v

これが v22.x.x 以上を表示すれば問題ありません。Node がインストールされていないか、バージョンが古すぎる場合は、以下のインストール方法を選択してください。

Node のインストール

brew install node

トラブルシューティング

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: シェルのスタートアップファイルに追加する

export PATH="$(npm prefix -g)/bin:$PATH"

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 に追加して永続化します。

診断フラグセッション管理詳細解説