Install overview

インストール

システム要件

  • Node 24(推奨)または Node 22.16+ - インストーラースクリプトがこれを自動的に処理します
  • macOS、Linux、または Windows - ネイティブ Windows と WSL2 の両方に対応しています。WSL2 のほうが安定しています。Windows を参照してください。
  • ソースからビルドする場合のみ pnpm が必要です

推奨: インストーラースクリプト

最速のインストール方法です。OS を検出し、必要に応じて Node をインストールし、OpenClaw をインストールして、オンボーディングを起動します。

macOS / Linux / WSL2

bash
curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell)

powershell
iwr -useb https://openclaw.ai/install.ps1 | iex

オンボーディングを実行せずにインストールするには:

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/自動化オプションについては、インストーラー内部 を参照してください。

代替インストール方法

ローカルプレフィックスインストーラー (install-cli.sh)

システム全体の Node インストールに依存せず、OpenClaw と Node を ~/.openclaw のようなローカルプレフィックスの下に保持したい場合に使用します:

bash
curl -fsSL https://openclaw.ai/install-cli.sh | bash

デフォルトで npm インストールに対応し、同じプレフィックスフローの下での git チェックアウトインストールにも対応しています。完全なリファレンス: インストーラー内部

すでにインストール済みですか? openclaw update --channel devopenclaw update --channel stable でパッケージインストールと git インストールを切り替えられます。 更新 を参照してください。

npm、pnpm、または bun

Node を自分で管理している場合:

npm

bash
npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm

bash
pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun

bash
bun add -g openclaw@latestopenclaw onboard --install-daemon
Troubleshooting: sharp build errors (npm)

グローバルにインストールされた libvips が原因で sharp が失敗する場合:

bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

ソースから

コントリビューター、またはローカルチェックアウトから実行したい場合:

bash
git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

またはリンクを省略し、リポジトリ内から pnpm openclaw ... を使用します。完全な開発ワークフローについては セットアップ を参照してください。

GitHub main からインストール

bash
npm install -g github:openclaw/openclaw#main

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

インストールを確認する

bash
openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw gateway status # verify the Gateway is running

インストール後に管理された起動を使いたい場合:

  • macOS: openclaw onboard --install-daemon または openclaw gateway install による LaunchAgent
  • Linux/WSL2: 同じコマンドによる systemd ユーザーサービス
  • ネイティブ Windows: まず Scheduled Task を使用し、タスク作成が拒否された場合はユーザーごとの Startup フォルダーのログイン項目にフォールバック

ホスティングとデプロイ

OpenClaw をクラウドサーバーまたは VPS にデプロイします:

VPS
Docker VM
Kubernetes
Fly.io
Hetzner
GCP
Azure
Railway
Render
Northflank

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

トラブルシューティング: openclaw が見つからない

インストールは成功したが、ターミナルで openclaw が見つからない場合:

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

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

その後、新しいターミナルを開きます。詳細については Node セットアップ を参照してください。

Was this useful?