インストール
理由がない限りインストーラーを使用してください。CLIをセットアップし、オンボーディングを実行します。
クイックインストール（推奨）
curl -fsSL https://openclaw.bot/install.sh | bash
Windows（PowerShell）:
iwr -useb https://openclaw.ai/install.ps1 | iex
次のステップ（オンボーディングをスキップした場合）:
openclaw onboard --install-daemon
システム要件
- Node >=22
- macOS、Linux、またはWSL2経由のWindows
- ソースからビルドする場合のみpnpm
インストール方法の選択
1) インストーラースクリプト（推奨）
npm経由でopenclawをグローバルにインストールし、オンボーディングを実行します。
curl -fsSL https://openclaw.bot/install.sh | bash
インストーラーフラグ:
curl -fsSL https://openclaw.bot/install.sh | bash -s -- --help
詳細: Installer internals。
非対話型（オンボーディングをスキップ）:
curl -fsSL https://openclaw.bot/install.sh | bash -s -- --no-onboard
2) グローバルインストール（手動）
既にNodeがある場合:
npm install -g openclaw@latest
libvipsがグローバルにインストールされている場合（Homebrew経由のmacOSで一般的）で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）、上記のSHARP_IGNORE_GLOBAL_LIBVIPS=1回避策を使用してネイティブビルドをスキップしてください。
または:
pnpm add -g openclaw@latest
次に:
openclaw onboard --install-daemon
3) ソースから（コントリビューター/開発者）
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 初回実行時にUI depsを自動インストール
pnpm build
openclaw onboard --install-daemon
ヒント: グローバルインストールがまだない場合は、pnpm openclaw ...経由でリポジトリコマンドを実行してください。
4) その他のインストールオプション
インストール後
- オンボーディングを実行: openclaw onboard --install-daemon
- クイックチェック: openclaw doctor
- Gatewayヘルスチェック: openclaw status + openclaw health
- ダッシュボードを開く: openclaw dashboard
インストール方法: npm vs git（インストーラー）
インストーラーは2つの方法をサポートしています:
- npm（デフォルト）: npm install -g openclaw@latest
- git: GitHubからクローン/ビルドし、ソースチェックアウトから実行
CLIフラグ
# 明示的なnpm
curl -fsSL https://openclaw.bot/install.sh | bash -s -- --install-method npm
# GitHubからインストール（ソースチェックアウト）
curl -fsSL https://openclaw.bot/install.sh | bash -s -- --install-method git
共通フラグ:
- --install-method npm|git
- --git-dir <path>（デフォルト: ~/openclaw）
- --no-git-update（既存のチェックアウト使用時にgit pullをスキップ）
- --no-prompt（プロンプトを無効化、CI/自動化で必須）
- --dry-run（何が起こるか表示、変更なし）
- --no-onboard（オンボーディングをスキップ）
環境変数
同等の環境変数（自動化に便利）:
- OPENCLAW_INSTALL_METHOD=git|npm
- OPENCLAW_GIT_DIR=...
- OPENCLAW_GIT_UPDATE=0|1
- OPENCLAW_NO_PROMPT=1
- OPENCLAW_DRY_RUN=1
- OPENCLAW_NO_ONBOARD=1
- SHARP_IGNORE_GLOBAL_LIBVIPS=0|1（デフォルト: 1、システムlibvipsに対するsharpビルドを回避）
トラブルシューティング: openclawが見つからない（PATH）
クイック診断:
node -v
npm -v
npm prefix -g
echo "$PATH"
$(npm prefix -g)/bin（macOS/Linux）または$(npm prefix -g)（Windows）がecho "$PATH"内に存在しない場合、シェルはnpmグローバルバイナリ（openclawを含む）を見つけられません。
修正: シェル起動ファイル（zsh: ~/.zshrc、bash: ~/.bashrc）に追加してください:
# macOS / Linux
export PATH="$(npm prefix -g)/bin:$PATH"
Windowsでは、npm prefix -gの出力をPATHに追加してください。
次に新しいターミナルを開いてください（またはzshでrehash / bashでhash -r）。