Install overview
インストール
システム要件
- Node 24(推奨)または Node 22.14+ - インストーラスクリプトがこれを自動的に処理します
- macOS、Linux、または Windows - ネイティブ Windows と WSL2 の両方がサポートされています。WSL2 のほうが安定しています。Windows を参照してください。
pnpmはソースからビルドする場合にのみ必要です
推奨: インストーラスクリプト
最も速いインストール方法です。OS を検出し、必要に応じて Node をインストールし、OpenClaw をインストールして、オンボーディングを起動します。
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
オンボーディングを実行せずにインストールするには:
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Windows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
すべてのフラグと CI/自動化オプションについては、インストーラ内部 を参照してください。
代替インストール方法
ローカルプレフィックスインストーラ (install-cli.sh)
システム全体の Node インストールに依存せず、OpenClaw と Node を ~/.openclaw などのローカルプレフィックス配下に保持したい場合に使用します。
curl -fsSL https://openclaw.ai/install-cli.sh | bash
デフォルトで npm インストールをサポートし、同じプレフィックスフロー内で git チェックアウトインストールもサポートします。完全なリファレンス: インストーラ内部。
すでにインストール済みですか?openclaw update --channel dev と openclaw update --channel stable で、パッケージインストールと git インストールを切り替えられます。更新 を参照してください。
npm、pnpm、または bun
すでに自分で Node を管理している場合:
npm
npm install -g openclaw@latest
openclaw onboard --install-daemon
pnpm
pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon
bun
bun add -g openclaw@latest
openclaw onboard --install-daemon
トラブルシューティング: sharp ビルドエラー (npm)
グローバルにインストールされた libvips が原因で sharp が失敗する場合:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
ソースから
コントリビューター、またはローカルチェックアウトから実行したい場合:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
または、リンクを省略し、リポジトリ内から pnpm openclaw ... を使用します。完全な開発ワークフローについては、セットアップ を参照してください。
GitHub main からインストール
npm install -g github:openclaw/openclaw#main
コンテナとパッケージマネージャー
コンテナ化された、またはヘッドレスのデプロイ。
Docker に代わるルートレスコンテナ。
Nix flake による宣言的インストール。
フリートの自動プロビジョニング。
Bun ランタイムによる CLI 専用の使用。
インストールを検証する
openclaw --version # CLI が利用可能であることを確認
openclaw doctor # 設定の問題を確認
openclaw gateway status # Gateway が実行中であることを検証
インストール後にマネージド起動を使用したい場合:
- macOS:
openclaw onboard --install-daemonまたはopenclaw gateway installによる LaunchAgent - Linux/WSL2: 同じコマンドによる systemd ユーザーサービス
- ネイティブ Windows: まず Scheduled Task を使用し、タスク作成が拒否された場合はユーザーごとの Startup フォルダーログイン項目にフォールバック
ホスティングとデプロイ
クラウドサーバーまたは VPS に OpenClaw をデプロイします:
OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii9qYS1KUC9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:
更新、移行、またはアンインストール
トラブルシューティング: openclaw が見つからない
インストールは成功したが、ターミナルで openclaw が見つからない場合:
node -v # Node installed?
npm prefix -g # Where are global packages?
echo "$PATH" # Is the global bin dir in PATH?
$(npm prefix -g)/bin が $PATH に含まれていない場合は、シェルの起動ファイル(~/.zshrc または ~/.bashrc)に追加します:
export PATH="$(npm prefix -g)/bin:$PATH"
その後、新しいターミナルを開きます。詳細については、Node セットアップ を参照してください。
Docs agent