メインコンテンツへスキップ

​
システム要件

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

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

最速のインストール方法です。OS を検出し、必要に応じて Node をインストールし、OpenClaw をインストールして、オンボーディングを起動します。
Windows デスクトップユーザーは、ネイティブの Windows Hub コンパニオンアプリもインストールできます。これにはセットアップ、トレイ状態、チャット、ノードモード、ローカル MCP モードが含まれます。
curl -fsSL https://openclaw.ai/install.sh | bash
オンボーディングを実行せずにインストールするには: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
すべてのフラグと CI/自動化オプションについては、インストーラー内部 を参照してください。

​
代替インストール方法

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

システム全体の Node インストールに依存せず、OpenClaw と Node を ~/.openclaw のようなローカルプレフィックス配下に保持したい場合に使用します。 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
デフォルトで npm インストールに対応し、同じプレフィックスフロー配下で git チェックアウトインストールにも対応します。完全なリファレンス: インストーラー内部。 すでにインストール済みですか？openclaw update --channel dev と openclaw update --channel stable でパッケージインストールと git インストールを切り替えられます。 更新 を参照してください。

​
npm、pnpm、または bun

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

​
ソースから

コントリビューター、またはローカルチェックアウトから実行したい場合: 
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 チェックアウトからインストール

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

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

Docker

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

Podman

Docker のルートレスコンテナ代替。

Nix

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

Ansible

自動化されたフリートプロビジョニング。

Bun

Bun ランタイムによる CLI のみの使用。

​
インストールを確認する

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 フォルダーログイン項目にフォールバック

​
ホスティングとデプロイ

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 トラブルシューティング を参照してください。 
node -v           # Node はインストール済み？
npm prefix -g     # グローバルパッケージはどこ？
echo "$PATH"      # グローバル bin dir は PATH に含まれている？