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

​
Node.js

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

​
バージョンの確認

node -v
v22.x.xまたはそれ以上を表示する場合は、良いです。 v22.x.xまたはそれ以上を表示する場合は、良いです。 Node がインストールされていないか、バージョンが古すぎる場合は、以下の install メソッドを選択します。

​
Node のインストール

Homebrew（推奨）:
````
```bash
brew install node
```

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

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

​
openclaw: command not found

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

Find your global npm prefix

npm prefix -g
2

Check if it's on your PATH

echo "$PATH"

```
出力内に `<npm-prefix>/bin`（macOS / Linux）または `<npm-prefix>`（Windows）が含まれているか確認してください。
```
3

Add it to your shell startup file

~/.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 に追加してください。