Skip to main content

システム要件

  • Node 22.22.3+、24.15+、または 25.9+ - Node 24 がデフォルトの対象です。インストーラースクリプトがこれを自動的に処理します。
  • macOS、Linux、または Windows - Windows ユーザーは、ネイティブ Windows Hub アプリ、PowerShell CLI インストーラー、または WSL2 Gateway から始められます。Windows を参照してください。
  • pnpm はソースからビルドする場合にのみ必要です。

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

最も速いインストール方法です。OS を検出し、必要に応じて Node をインストールして、OpenClaw をインストールし、オンボーディングを起動します。
Windows デスクトップユーザーは、セットアップ、トレイステータス、チャット、Node モード、ローカル MCP モードを備えたネイティブのコンパニオンアプリ Windows Hub もインストールできます。
オンボーディングを実行せずにインストールするには:
すべてのフラグと CI/自動化オプションについては、インストーラーの内部構造を参照してください。

その他のインストール方法

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

システム全体の Node インストールに依存せず、OpenClaw と Node を ~/.openclaw などのローカルプレフィックス配下に保持する場合に使用します。
デフォルトで npm インストールをサポートし、同じプレフィックスフローで git チェックアウトからのインストールもサポートします。詳細なリファレンス:インストーラーの内部構造 すでにインストール済みの場合は、openclaw update --channel devopenclaw update --channel stable を使用して パッケージインストールと git インストールを切り替えられます。 更新を参照してください。

npm、pnpm、または bun

Node を自分で管理している場合:
ホスト型インストーラーは、OpenClaw パッケージのインストール時に min-release-age などの npm の鮮度フィルターを解除します。npm で手動インストールする場合は、独自の npm ポリシーが引き続き適用されます。

ソースから

コントリビューター、またはローカルチェックアウトから実行したい場合:
またはリンクを省略し、リポジトリ内から pnpm openclaw ... を使用します。開発ワークフローの詳細については、セットアップを参照してください。

GitHub の main チェックアウトからインストール

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

Docker

コンテナ化またはヘッドレスデプロイ。

Podman

Docker に代わるルートレスコンテナ。

Nix

Nix flake による宣言的インストール。

Ansible

フリートの自動プロビジョニング。

Bun

オプションの依存関係インストーラーおよびパッケージスクリプトランナー。

インストールの確認

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

ホスティングとデプロイ

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

VPS

プロバイダーを選択します。

Docker VM

共通の Docker 手順。

Kubernetes

K8s デプロイ。

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

更新

OpenClaw を最新の状態に保ちます。

移行

新しいマシンに移行します。

アンインストール

OpenClaw を完全に削除します。

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

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