インストール
はじめにをすでに完了していますか？それならセットアップは完了しています。このページでは、代替のインストール方法、プラットフォーム別の手順、メンテナンス方法について説明します。
システム要件
- Node 24（推奨）（Node 22 LTS、現在
22.16+も互換性のためサポート中。インストーラースクリプトは Node 24 が未導入の場合に自動インストールします） - macOS、Linux、または Windows
- ソースからビルドする場合のみ
pnpmが必要
注意： Windows では WSL2 上での実行を強くお勧めします。
インストール方法
ヒント： インストーラースクリプトが推奨のインストール方法です。Node の検出・インストール・オンボーディングをワンステップで行います。
警告： VPS やクラウドホストでは、サードパーティの「ワンクリック」マーケットプレイスイメージの使用はできるだけ避けてください。クリーンなベース OS イメージ（例：Ubuntu LTS）を使い、インストーラースクリプトで OpenClaw を自分でインストールすることを推奨します。
インストーラースクリプト
CLI をダウンロードし、npm でグローバルインストールした後、オンボーディングウィザードを起動します。
#### macOS / Linux / WSL2
```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```
#### Windows（PowerShell）
```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```
以上で完了です。スクリプトが Node の検出・インストール・オンボーディングをすべて処理します。
オンボーディングをスキップしてバイナリのみインストールする場合：
#### macOS / Linux / WSL2
```bash
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
```
#### Windows（PowerShell）
```powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
```
すべてのフラグ、環境変数、CI/自動化オプションについては、[インストーラーの内部構造](/docs/install/installer)を参照してください。npm / pnpm
Node を自身で管理している場合は、Node 24 を推奨します。互換性のため Node 22 LTS（現在 `22.16+`）もサポートしています：
#### npm
```bash
npm install -g openclaw@latest
openclaw onboard --install-daemon
```
<details>sharp のビルドエラーが出る場合
グローバルに libvips がインストールされている環境（macOS で Homebrew を使用している場合など）で `sharp` のビルドに失敗する場合は、プリビルトバイナリを強制的に使用してください：
```bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
```
`sharp: Please add node-gyp to your dependencies` というエラーが表示される場合は、ビルドツール（macOS：Xcode CLT + `npm install -g node-gyp`）をインストールするか、上記の環境変数を使用してください。
</details>
#### pnpm
```bash
pnpm add -g openclaw@latest
pnpm approve-builds -g # openclaw, node-llama-cpp, sharp などを承認
openclaw onboard --install-daemon
```
> **注意：** pnpm ではビルドスクリプトを持つパッケージに対して明示的な承認が必要です。初回インストールで「Ignored build scripts」の警告が表示されたら、`pnpm approve-builds -g` を実行して表示されたパッケージを選択してください。ソースからビルド
コントリビューターやローカルチェックアウトから実行したい方向けです。
### ステップ1：クローンとビルド
[OpenClaw リポジトリ](https://github.com/openclaw/openclaw)をクローンしてビルドします：
```bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
```
### ステップ2：CLI をリンク
`openclaw` コマンドをグローバルで使えるようにします：
```bash
pnpm link --global
```
リンクせずにリポジトリ内から `pnpm openclaw ...` で実行することもできます。
### ステップ3：オンボーディングを実行
```bash
openclaw onboard --install-daemon
```
より詳しい開発ワークフローについては、[セットアップ](/docs/start/setup)を参照してください。その他のインストール方法
- Docker — コンテナ化またはヘッドレスデプロイ用。
- Podman — ルートレスコンテナ：
setup-podman.shを一度実行し、その後は起動スクリプトを使用。 - Nix — Nix による宣言的インストール。
- Ansible — フリートの自動プロビジョニング。
- Bun — Bun ランタイムによる CLI のみの使用。
インストール後の確認
正しく動作しているか確認します：
openclaw doctor # 設定の問題をチェック
openclaw status # Gateway のステータス確認
openclaw dashboard # ブラウザ UI を開くカスタムランタイムパスが必要な場合：
OPENCLAW_HOME— ホームディレクトリベースの内部パス用OPENCLAW_STATE_DIR— 可変状態の保存場所用OPENCLAW_CONFIG_PATH— 設定ファイルの場所用
優先順位と詳細は環境変数を参照してください。
トラブルシューティング：openclaw が見つからない
PATH の診断と修正
簡易診断：
node -v
npm -v
npm prefix -g
echo "$PATH"$(npm prefix -g)/bin（macOS/Linux）または $(npm prefix -g)（Windows）が $PATH に含まれていない場合、シェルがグローバル npm バイナリ（openclaw を含む）を見つけられません。
修正方法 — シェルのスタートアップファイル（~/.zshrc または ~/.bashrc）に追加してください：
export PATH="$(npm prefix -g)/bin:$PATH"Windows では、npm prefix -g の出力を PATH に追加してください。
その後、新しいターミナルを開いてください（zsh では rehash、bash では hash -r でも可）。