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

インストール

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

最も速いインストール方法です。OSを検出し、必要に応じてNodeをインストールし、OpenClawをインストールして、オンボーディングを開始します。
curl -fsSL https://openclaw.ai/install.sh | bash
オンボーディングを実行せずにインストールするには:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
すべてのフラグとCI/自動化オプションについては、Installer internals を参照してください。

システム要件

  • Node 24(推奨)または Node 22.14+ — インストーラースクリプトがこれを自動で処理します
  • macOS、Linux、またはWindows — ネイティブWindowsとWSL2の両方をサポートしています。WSL2のほうがより安定しています。Windows を参照してください。
  • pnpm はソースからビルドする場合にのみ必要です

別のインストール方法

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

システム全体のNodeインストールに依存せず、 ~/.openclaw のようなローカルプレフィックス配下にOpenClawとNodeを保持したい場合に使用します:
curl -fsSL https://openclaw.ai/install-cli.sh | bash
デフォルトでnpmインストールをサポートし、同じ プレフィックスフローでgit checkoutインストールにも対応しています。完全なリファレンス: Installer internals

npm、pnpm、または bun

すでに自分でNodeを管理している場合:
npm install -g openclaw@latest
openclaw onboard --install-daemon
グローバルにインストールされたlibvipsが原因で sharp が失敗する場合:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

ソースから

コントリビューターや、ローカルcheckoutから実行したい人向け:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon
または、linkをスキップしてリポジトリ内から pnpm openclaw ... を使用することもできます。完全な開発ワークフローについては Setup を参照してください。

GitHub main からインストール

npm install -g github:openclaw/openclaw#main

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

Docker

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

Podman

Dockerのrootlessコンテナ代替。

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 user service
  • ネイティブ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はインストール済み?
npm prefix -g     # グローバルパッケージはどこにある?
echo "$PATH"      # グローバルbinディレクトリはPATHに入っている?
$(npm prefix -g)/bin$PATH にない場合は、シェル起動ファイル(~/.zshrc または ~/.bashrc)に追加してください:
export PATH="$(npm prefix -g)/bin:$PATH"
その後、新しいターミナルを開いてください。詳細は Node setup を参照してください。