Node.js¶

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

バージョンの確認¶

node -v

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

Node のインストール¶

Homebrew（推奨）:

````
```bash
brew install node
```

または [nodejs.org](https://nodejs.org/) から macOS インストーラーをダウンロードしてください。
````

Ubuntu / Debian:

````
```bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
```

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

もしくは、バージョンマネージャーを使用してください（下記参照）。
````

winget（推奨）:

````
```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

または [nodejs.org](https://nodejs.org/) から Windows インストーラーをダウンロードしてください。
````

バージョンマネージャーを使うと、Node のバージョンを簡単に切り替えられます。代表的な選択肢は次のとおりです。 人気のオプション:

• fnm — 高速でクロスプラットフォーム
• nvm — macOS / Linux で広く利用されています
• mise — ポリグロット（Node、Python、Ruby など）

fnm の例:

fnm install 22
fnm use 22

バージョンマネージャがシェル起動ファイル(~/.zshrcまたは~/.bashrc)で初期化されていることを確認してください。 バージョンマネージャーがシェルの起動ファイル（~/.zshrc または ~/.bashrc）で初期化されていることを確認してください。初期化されていない場合、PATH に Node の bin ディレクトリが含まれないため、新しいターミナルセッションで openclaw が見つからないことがあります。

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

openclaw: command not found¶

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

bash npm prefix -g bash echo "$PATH"

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

~/.zshrc または ~/.bashrc に追加します。

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

        その後、新しいターミナルを開く（または zsh では `rehash`、bash では `hash -r` を実行）してください。
      </Tab>
      <Tab title="Windows">
        `npm prefix -g` の出力を、設定 → システム → 環境変数 からシステム PATH に追加してください。
      </Tab>
    </Tabs>
    ```

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