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

システム要件

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

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

最速のインストール方法です。OS を検出し、必要に応じて Node をインストールし、OpenClaw をインストールして、オンボーディングを起動します。
Windows デスクトップユーザーは、セットアップ、トレイステータス、チャット、ノードモード、ローカル MCP モードを含むネイティブの Windows Hub コンパニオンアプリもインストールできます。
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-checkout インストールにも対応しています。完全なリファレンス: インストーラー内部 すでにインストール済みですか?openclaw update --channel devopenclaw 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 の rootless コンテナ代替。

Nix

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

Ansible

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

Bun

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

インストールの確認

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
インストール後に管理された起動を使用したい場合:
  • 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 が見つからない場合:
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)に追加してください:
export PATH="$(npm prefix -g)/bin:$PATH"
その後、新しいターミナルを開きます。詳細は Node セットアップ を参照してください。