メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 をインストールする

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

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

​
openclaw: command not found

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

グローバル npm prefix を見つける

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 のグローバル prefix をユーザーが書き込み可能なディレクトリに切り替えます: 
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
永続化するには、export PATH=... 行を ~/.bashrc または ~/.zshrc に追加します。

​
関連