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 devopenclaw 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

コンテナとパッケージマネージャー

インストールを検証する

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 をデプロイします:

VPS
Docker VM
Kubernetes

OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii9qYS1KUC9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:

Hetzner
GCP
Azure
Railway
Render
Northflank

更新、移行、またはアンインストール

トラブルシューティング: 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 セットアップ を参照してください。