Install overview

インストール

システム要件

  • Node 22.19+、23.11+、または 24+ - Node 24 がデフォルトの対象です。インストーラースクリプトが自動的に処理します。
  • macOS、Linux、または Windows - Windows ユーザーは、ネイティブ Windows Hub アプリ、PowerShell CLI インストーラー、または WSL2 Gateway から開始できます。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

ソースから

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

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
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

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

インストールの確認

bash
openclaw --version      # CLI が利用可能であることを確認openclaw doctor         # 設定の問題を確認openclaw gateway status # Gateway が実行中であることを確認

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

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

ホスティングとデプロイ

OpenClaw をクラウドサーバーまたは VPS にデプロイします。プロバイダー選択の全一覧 (DigitalOcean、Hetzner、Hostinger、Fly.io、GCP、Azure、Railway、 Northflank、Oracle Cloud、Raspberry Pi など)については Linux サーバーを参照するか、 Render 上に宣言的にデプロイしてください。

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

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

ほとんどの場合は PATH の問題です。npm のグローバル bin ディレクトリがシェルの PATH に含まれていません。Windows のパスを含む完全な修正方法については、Node.js のトラブルシューティングを参照してください。

bash
node -v           # Node はインストール済みか?npm prefix -g     # グローバルパッケージはどこにあるか?echo "$PATH"      # グローバル bin ディレクトリは PATH に含まれているか?
Was this useful?
On this page

On this page