Skip to main content
すでに導入ガイド(Getting Started)の手順を完了していますか？ その場合は準備完了です。このページでは、代替のインストール方法、プラットフォーム固有の手順、およびメンテナンスについて説明します。

​
システム要件

Windowsでは、WSL2環境でOpenClawを実行することを強く推奨します。

​
インストール方法

OpenClawのインストールにはインストーラースクリプトの使用が推奨されます。Nodeの検出、インストール、オンボーディングをワンステップで処理します。
VPS/クラウドホストを利用する場合、サードパーティの「1クリック」マーケットプレイスイメージは可能な限り避けてください。クリーンなベースOSイメージ（例: Ubuntu LTS）を優先し、インストーラースクリプトを使用してOpenClawをご自身でインストールしてください。

インストーラースクリプト

CLIをダウンロードし、npm経由でグローバルにインストールして、オンボーディングウィザードを起動します。
curl -fsSL https://openclaw.ai/install.sh | bash
これだけで完了です。スクリプトがNodeの検出、インストール、およびオンボーディングを処理します。オンボーディングをスキップしてバイナリのインストールのみを行う場合は、次のように実行します。
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
すべてのフラグ、環境変数(env vars)、CI/自動化オプションについては、インストーラの内部仕様(Installer internals)を参照してください。
すでにNode 22+がインストールされており、ご自身でインストールを管理したい場合:
npm install -g openclaw@latest
openclaw onboard --install-daemon
libvipsがグローバルにインストールされており（macOSのHomebrew経由でよく見られます）、sharpのビルドに失敗する場合は、ビルド済みバイナリを強制的に使用します。
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
sharp: Please add node-gyp to your dependenciesというエラーが表示された場合は、ビルドツールをインストールするか（macOS: Xcode CLT + npm install -g node-gyp）、上記の環境変数を使用してください。
コントリビューター、またはローカルのチェックアウトから実行したい方向けの方法です。
1

クローンとビルド

OpenClawリポジトリをクローンしてビルドします:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
2

CLIのリンク

openclawコマンドをグローバルに利用できるようにします:
pnpm link --global
または、リンクをスキップして、リポジトリ内から pnpm openclaw ... を経由してコマンドを実行することもできます。
3

オンボーディングの実行

openclaw onboard --install-daemon
より詳細な開発ワークフローについては、セットアップ(Setup)を参照してください。

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

Docker

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

Podman

ルートレスコンテナ: 一度だけ setup-podman.sh を実行し、その後起動スクリプトを実行します。

Nix

Nixを使用した宣言的インストール。

Ansible

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

Bun

Bunランタイムを経由したCLIのみの利用。

​
インストール後

すべてが正常に動作しているか確認します: 
openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI
カスタムのランタイムパスが必要な場合は、以下を使用します:
  • OPENCLAW_HOME - ホームディレクトリベースの内部パス用
  • OPENCLAW_STATE_DIR - 変更可能な状態の保存場所用
  • OPENCLAW_CONFIG_PATH - 設定ファイルの場所用
優先順位や詳細については、環境変数(Environment vars)を参照してください。

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

簡単な診断方法:
node -v
npm -v
npm prefix -g
echo "$PATH"
$(npm prefix -g)/bin (macOS/Linux) または $(npm prefix -g) (Windows) が $PATH に含まれていない場合、シェルはグローバルなnpmバイナリ（openclaw を含む）を見つけることができません。修正方法 — シェルのスタートアップファイル（~/.zshrc または ~/.bashrc）に以下を追加します:
export PATH="$(npm prefix -g)/bin:$PATH"
Windowsの場合は、npm prefix -g の出力を環境変数 PATH に追加してください。その後、新しいターミナルを開くか（またはzshの場合は rehash、bashの場合は hash -r を実行します）、設定を反映させます。

​
アップデート / アンインストール

アップデート

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

移行

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

アンインストール

OpenClawを完全に削除します。