Node ランタイム
Node.js
OpenClaw には Node 22 以降が必要で す。インストーラースクリプトは Node を自動的に検出してインストールします — このページは、自分で Node をセットアップし、すべてが正しく設定されていることを確認したい場合（バージョン、PATH、グローバルインストール）のためのものです。
バージョンの確認
node -v
これが v22.x.x 以上を表示すれば問題ありません。Node がインストールされていないか、バージョンが古すぎる場合は、以下のインストール方法を選択してください。
Node のインストール
バージョンマネージャーを使用すると、Node バージョンを簡単に切り替えることができます。一般的な選択肢:
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: シェルのスタートアップファイルに追加する
export PATH="$(npm prefix -g)/bin:$PATH"
npm prefix -g の出力を、設定 → システム → 環境変数からシステム 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 に追加して永続化します。