システム要件
- Node 24(推奨)または Node 22.19+ - インストーラースクリプトがこれを自動的に処理します
- macOS、Linux、または Windows - Windows ユーザーは、ネイティブの Windows Hub アプリ、PowerShell CLI インストーラー、または WSL2 Gateway から始められます。Windows を参照してください。
- ソースからビルドする場合のみ
pnpmが必要です
推奨: インストーラースクリプト
最速のインストール方法です。OS を検出し、必要に応じて Node をインストールし、OpenClaw をインストールして、オンボーディングを起動します。Windows デスクトップユーザーは、セットアップ、トレイステータス、チャット、ノードモード、ローカル MCP モードを含むネイティブの Windows Hub コンパニオンアプリもインストールできます。
- macOS / Linux / WSL2
- Windows (PowerShell)
- macOS / Linux / WSL2
- Windows (PowerShell)
代替インストール方法
ローカルプレフィックスインストーラー (install-cli.sh)
システム全体の Node インストールに依存せず、OpenClaw と Node を
~/.openclaw のようなローカルプレフィックス配下に保持したい場合に使用します:
openclaw update --channel dev と openclaw update --channel stable でパッケージインストールと git インストールを切り替えられます。
更新 を参照してください。
npm、pnpm、または bun
すでに自分で Node を管理している場合:- npm
- pnpm
- bun
ホスト型インストーラーは、OpenClaw パッケージインストール時に
min-release-age などの npm 鮮度フィルターを解除します。npm で手動インストールする場合は、自分の npm ポリシーが引き続き適用されます。ソースから
コントリビューター、またはローカルチェックアウトから実行したい場合:pnpm openclaw ... を使用します。完全な開発ワークフローについては セットアップ を参照してください。
GitHub main チェックアウトからインストール
コンテナとパッケージマネージャー
Docker
コンテナ化またはヘッドレスデプロイ。
Podman
Docker の rootless コンテナ代替。
Nix
Nix flake による宣言的インストール。
Ansible
自動化されたフリートプロビジョニング。
Bun
Bun ランタイムによる CLI 専用の使用。
インストールの確認
- macOS:
openclaw onboard --install-daemonまたはopenclaw gateway installによる LaunchAgent - Linux/WSL2: 同じコマンドによる systemd ユーザーサービス
- ネイティブ Windows: まず Scheduled Task。タスク作成が拒否された場合は、ユーザーごとの Startup-folder ログイン項目にフォールバック
ホスティングとデプロイ
クラウドサーバーまたは VPS に OpenClaw をデプロイします:VPS
任意の Linux VPS。
Docker VM
共通の Docker 手順。
Kubernetes
K8s デプロイ。
Fly.io
Fly.io にデプロイ。
Hetzner
Hetzner デプロイ。
GCP
Google Cloud デプロイ。
Azure
Azure デプロイ。
Railway
Railway デプロイ。
Render
Render デプロイ。
Northflank
Northflank デプロイ。
更新、移行、アンインストール
Updating
OpenClaw を最新の状態に保ちます。
Migrating
新しいマシンへ移行します。
Uninstall
OpenClaw を完全に削除します。
トラブルシューティング: openclaw が見つからない
インストールは成功したが、ターミナルで openclaw が見つからない場合:
$(npm prefix -g)/bin が $PATH に含まれていない場合は、シェルの起動ファイル(~/.zshrc または ~/.bashrc)に追加してください: