> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# インストール

# インストール

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

## システム要件

* **[Node 22+](/install/node)**（[インストール方法](#install-methods) のインストーラースクリプトが未インストールの場合に導入します）
* macOS、Linux、または Windows
* ソースからビルドする場合のみ `pnpm`

<Note>
  Windows では、[WSL2](https://learn.microsoft.com/en-us/windows/wsl/install) 上で OpenClaw を実行することを強く推奨します。
</Note>

## インストール方法

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

<AccordionGroup>
  <Accordion title="Installer script" icon="rocket" defaultOpen>
    CLI をダウンロードし、npm でグローバルにインストールして、オンボーディングウィザードを起動します。

    <Tabs>
      <Tab title="macOS / Linux / WSL2">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        curl -fsSL https://openclaw.ai/install.sh | bash
        ```
      </Tab>

      <Tab title="Windows（PowerShell）">
        ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
        iwr -useb https://openclaw.ai/install.ps1 | iex
        ```
      </Tab>
    </Tabs>

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

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

    <Tabs>
      <Tab title="macOS / Linux / WSL2">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
        ```
      </Tab>

      <Tab title="Windows（PowerShell）">
        ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
        & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
        ```
      </Tab>
    </Tabs>

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

  <Accordion title="npm / pnpm" icon="package">
    すでに Node 22+ があり、インストールを自分で管理したい場合：

    <Tabs>
      <Tab title="npm">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        npm install -g openclaw@latest
        openclaw onboard --install-daemon
        ```

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

          ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
          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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        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>
  </Accordion>

  <Accordion title="From source" icon="github">
    コントリビューターまたはローカルチェックアウトから実行したい人のために。

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

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        git clone https://github.com/openclaw/openclaw.git
        cd openclaw
        pnpm install
        pnpm ui:build
        pnpm build
        ```
      </Step>

      <Step title="CLI をリンク">
        `openclaw` コマンドをグローバルで利用可能にします：

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        pnpm link --global
        ```

        あるいは、リンクを省略して、リポジトリ内から `pnpm openclaw ...` 経由でコマンドを実行できます。
      </Step>

      <Step title="オンボーディングを実行">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --install-daemon
        ```
      </Step>
    </Steps>

    より高度な開発ワークフローについては、[Setup](/start/setup) を参照してください。
  </Accordion>
</AccordionGroup>

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

<CardGroup cols={2}>
  <Card title="Docker" href="/install/docker" icon="container">
    コンテナ化またはヘッドレスなデプロイ。
  </Card>

  <Card title="Podman" href="/install/podman" icon="container">
    ルートレスコンテナ：`setup-podman.sh` を一度実行し、その後起動スクリプトを実行します。
  </Card>

  <Card title="Nix" href="/install/nix" icon="snowflake">
    Nix による宣言的インストール。
  </Card>

  <Card title="Ansible" href="/install/ansible" icon="server">
    フリートの自動プロビジョニング。
  </Card>

  <Card title="Bun" href="/install/bun" icon="zap">
    Bun ランタイムによる CLI のみの利用。
  </Card>
</CardGroup>

## インストール後

動作確認を行います：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/help/environment) を参照してください。

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

<Accordion title="PATH diagnosis and fix">
  クイック診断：

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  node -v
  npm -v
  npm prefix -g
  echo "$PATH"
  ```

  `$(npm prefix -g)/bin`（macOS/Linux）または `$(npm prefix -g)`（Windows）が **`$PATH`** に含まれていない場合、シェルは npm のグローバルバイナリ（`openclaw` を含む）を見つけられません。

  修正 — シェルの起動ファイル（`~/.zshrc` または `~/.bashrc`）に追加します：

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  export PATH="$(npm prefix -g)/bin:$PATH"
  ```

  Windows では、`npm prefix -g` の出力を PATH に追加してください。

  その後、新しいターミナルを開く（または zsh では `rehash`、bash では `hash -r` を実行）してください。
</Accordion>

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

<CardGroup cols={3}>
  <Card title="Updating" href="/install/updating" icon="refresh-cw">
    OpenClaw を最新の状態に保ちます。
  </Card>

  <Card title="Migrating" href="/install/migrating" icon="arrow-right">
    新しいマシンへ移行します。
  </Card>

  <Card title="Uninstall" href="/install/uninstall" icon="trash-2">
    OpenClaw を完全に削除します。
  </Card>
</CardGroup>