Skip to main content

​
インストール

すでに Getting Started を完了しましたか？ すべて設定されています — このページは、代替のインストール方法、プラットフォーム固有の手順、およびメンテナンスのためのものです。

​
システム要件

  • Node 22+（インストール方法 のインストーラースクリプトが未インストールの場合に導入します）
  • macOS、Linux、または Windows
  • ソースからビルドする場合のみ pnpm
Windows では、WSL2 上で OpenClaw を実行することを強く推奨します。

​
インストール方法

インストーラースクリプトは、OpenClaw をインストールする推奨方法です。Node の検出、インストール、オンボーディングを 1 つのステップで処理します。

Installer script

CLI をダウンロードし、npm でグローバルにインストールして、オンボーディングウィザードを起動します。
以上です — スクリプトが Node の検出、インストール、オンボーディングを処理します。オンボーディングをスキップしてバイナリのみをインストールする場合：
すべてのフラグ、環境変数、CI/自動化オプションについては、Installer internals を参照してください。
すでに Node 22+ があり、インストールを自分で管理したい場合：
libvips をグローバルにインストールしている場合（macOS で Homebrew 経由の場合に一般的）、sharp が失敗したら、事前ビルド済みバイナリを強制してください：
sharp: Please add node-gyp to your dependencies が表示される場合は、ビルドツール（macOS：Xcode CLT + npm install -g node-gyp）をインストールするか、上記の環境変数を使用してください。
コントリビューターまたはローカルチェックアウトから実行したい人のために。
1

クローンとビルド

OpenClaw リポジトリ をクローンしてビルドします：
2

CLI をリンク

openclaw コマンドをグローバルで利用可能にします：
あるいは、リンクを省略して、リポジトリ内から pnpm openclaw ... 経由でコマンドを実行できます。
3

オンボーディングを実行

より高度な開発ワークフローについては、Setup を参照してください。

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

Docker

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

Podman

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

Nix

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

Ansible

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

Bun

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

​
インストール後

動作確認を行います：
カスタムの実行時パスが必要な場合は、以下を使用してください:
  • ホームディレクトリ基準の内部パスには OPENCLAW_HOME
  • 可変状態の保存場所には OPENCLAW_STATE_DIR
  • 設定ファイルの場所には OPENCLAW_CONFIG_PATH
優先順位および詳細については Environment vars を参照してください。

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

クイック診断：
$(npm prefix -g)/bin（macOS/Linux）または $(npm prefix -g)（Windows）が $PATH に含まれていない場合、シェルは npm のグローバルバイナリ（openclaw を含む）を見つけられません。修正 — シェルの起動ファイル（~/.zshrc または ~/.bashrc）に追加します：
Windows では、npm prefix -g の出力を PATH に追加してください。その後、新しいターミナルを開く（または zsh では rehash、bash では hash -r を実行）してください。

​
更新 / アンインストール

Updating

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

Migrating

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

Uninstall

OpenClaw を完全に削除します。