I-install¶

Nasunod mo na ba ang Getting Started? 38. Handa ka na — ang pahinang ito ay para sa mga alternatibong paraan ng pag-install, mga tagubiling partikular sa platform, at maintenance.

Mga kinakailangan sa system¶

• Node 22+ (ii-install ito ng installer script kung wala pa)
• macOS, Linux, o Windows
• pnpm kung magbi-build ka mula sa source

Sa Windows, mariin naming inirerekomenda na patakbuhin ang OpenClaw sa ilalim ng WSL2.

Mga paraan ng pag-install¶

39. Ang installer script ang inirerekomendang paraan para i-install ang OpenClaw. Pinangangasiwaan nito ang pagtukoy ng Node, pag-install, at onboarding sa isang hakbang.

Dina-download ang CLI, ini-install ito nang global sa pamamagitan ng npm, at inilulunsad ang onboarding wizard.

```
<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>

Ayan na — pinapangasiwaan ng script ang pag-detect ng Node, pag-install, at onboarding.

Para laktawan ang onboarding at i-install lang ang binary:

<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>

Para sa lahat ng flag, env var, at mga opsyon para sa CI/automation, tingnan ang [Installer internals](/install/installer).
```

Kung mayroon ka nang Node 22+ at mas gusto mong ikaw ang mag-manage ng pag-install:

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

    <Accordion title="may sharp build errors?">
      Kung may naka-install na libvips nang global (karaniwan sa macOS via Homebrew) at pumalya ang `sharp`, pilitin ang prebuilt binaries:

      ```bash
      SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
      ```

      Kung makita mo ang `sharp: Please add node-gyp to your dependencies`, mag-install ng build tooling (macOS: Xcode CLT + `npm install -g node-gyp`) o gamitin ang env var sa itaas.
    </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>
    Nangangailangan ang pnpm ng hayagang pag-apruba para sa mga package na may build scripts. Pagkatapos ipakita ng unang install ang babalang "Ignored build scripts", patakbuhin ang `pnpm approve-builds -g` at piliin ang mga nakalistang package.
    </Note>
  </Tab>
</Tabs>
```

Para sa mga contributor o sinumang gustong magpatakbo mula sa isang lokal na checkout.

```
<Steps>
  <Step title="I-clone at i-build">
    I-clone ang [OpenClaw repo](https://github.com/openclaw/openclaw) at mag-build:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```
  </Step>
  <Step title="I-link ang CLI">
    Gawing available nang global ang command na `openclaw`:

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

    Bilang alternatibo, laktawan ang pag-link at patakbuhin ang mga command sa pamamagitan ng `pnpm openclaw ...` mula sa loob ng repo.
  </Step>
  <Step title="Patakbuhin ang onboarding">
    ```bash
    openclaw onboard --install-daemon
    ```
  </Step>
</Steps>

Para sa mas malalim na development workflows, tingnan ang [Setup](/start/setup).
```

Iba pang mga paraan ng pag-install¶

Mga containerized o headless na deployment. Deklaratibong pag-install sa pamamagitan ng Nix. Automated na provisioning ng fleet. CLI-only na paggamit sa pamamagitan ng Bun runtime.

Pagkatapos mag-install¶

I-verify na gumagana ang lahat:

openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI

If you need custom runtime paths, use:

• OPENCLAW_HOME for home-directory based internal paths
• OPENCLAW_STATE_DIR for mutable state location
• OPENCLAW_CONFIG_PATH for config file location

See Environment vars for precedence and full details.

Pag-troubleshoot: openclaw not found¶

Mabilis na diagnosis:

node -v
npm -v
npm prefix -g
echo "$PATH"

Kung ang $(npm prefix -g)/bin (macOS/Linux) o $(npm prefix -g) (Windows) ay wala sa iyong $PATH, hindi mahanap ng iyong shell ang mga global npm binary (kasama ang openclaw).

Ayusin — idagdag ito sa iyong shell startup file (~/.zshrc o ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

Sa Windows, idagdag sa iyong PATH ang output ng npm prefix -g.

41. Pagkatapos ay magbukas ng bagong terminal (o rehash sa zsh / hash -r sa bash).

Update / uninstall¶

Panatilihing updated ang OpenClaw. Lumipat sa isang bagong machine. Ganap na alisin ang OpenClaw.