インストール¶

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

システム要件¶

• Node 22+（インストール方法 のインストーラースクリプトが未インストールの場合に導入します）
• macOS、Linux、または Windows
• ソースからビルドする場合のみ pnpm

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

インストール方法¶

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

CLI をダウンロードし、npm でグローバルにインストールして、オンボーディングウィザードを起動します。

```
<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Tab>
  <Tab title="Windows（PowerShell）">
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

以上です — スクリプトが Node の検出、インストール、オンボーディングを処理します。

オンボーディングをスキップしてバイナリのみをインストールする場合：

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```
  </Tab>
  <Tab title="Windows（PowerShell）">
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```
  </Tab>
</Tabs>

すべてのフラグ、環境変数、CI/自動化オプションについては、［Installer internals］(/install/installer) を参照してください。
```

すでに Node 22+ があり、インストールを自分で管理したい場合：

```
<Tabs>
  <Tab title="npm">
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Accordion title="sharp のビルドエラー？">
      libvips をグローバルにインストールしている場合（macOS で Homebrew 経由の場合に一般的）、`sharp` が失敗したら、事前ビルド済みバイナリを強制してください：

      ```bash
      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`）をインストールするか、上記の環境変数を使用してください。
    </Accordion>
  </Tab>
  <Tab title="pnpm">
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

    <Note>
    pnpm では、ビルドスクリプトを含むパッケージに対して明示的な承認が必要です。最初のインストールで「Ignored build scripts」の警告が表示されたら、`pnpm approve-builds -g` を実行し、一覧のパッケージを選択してください。
    </Note>
  </Tab>
</Tabs>
```

コントリビューターまたはローカルチェックアウトから実行したい人のために。

```
<Steps>
  <Step title="クローンとビルド">
    [OpenClaw リポジトリ](https://github.com/openclaw/openclaw) をクローンしてビルドします：

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```
  </Step>
  <Step title="CLI をリンク">
    `openclaw` コマンドをグローバルで利用可能にします：

    ```bash
    pnpm link --global
    ```

    あるいは、リンクを省略して、リポジトリ内から `pnpm openclaw ...` 経由でコマンドを実行できます。
  </Step>
  <Step title="オンボーディングを実行">
    ```bash
    openclaw onboard --install-daemon
    ```
  </Step>
</Steps>

より高度な開発ワークフローについては、［セットアップ］(/start/setup) を参照してください。
```

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

コンテナ化またはヘッドレスなデプロイ。 Nix による宣言的インストール。 フリートの自動プロビジョニング。 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 を完全に削除します。