ติดตั้ง¶

เคยทำตาม Getting Started แล้วหรือยัง? ถ้าใช่ก็พร้อมใช้งานแล้ว — หน้านี้สำหรับวิธีติดตั้งทางเลือก คำแนะนำเฉพาะแพลตฟอร์ม และการบำรุงรักษา

ข้อกำหนดของระบบ¶

• Node 22+ (สคริปต์ติดตั้งใน วิธีติดตั้ง จะติดตั้งให้หากยังไม่มี)
• macOS, Linux หรือ Windows
• pnpm เฉพาะกรณีที่คุณ build จากซอร์ส

บน Windows เราขอแนะนำอย่างยิ่งให้รัน OpenClaw ภายใต้ WSL2

วิธีติดตั้ง¶

สคริปต์ติดตั้ง เป็นวิธีที่แนะนำในการติดตั้ง OpenClaw โดยจะจัดการการตรวจพบ Node การติดตั้ง และการเริ่มต้นใช้งานในขั้นตอนเดียว It handles Node detection, installation, and onboarding in one step.

ดาวน์โหลด CLI ติดตั้งแบบ global ผ่าน 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="เกิดข้อผิดพลาดการ build ของ sharp?">
      หากคุณติดตั้ง libvips แบบ global (พบบ่อยบน macOS ผ่าน Homebrew) และ `sharp` ล้มเหลว ให้บังคับใช้ไบนารีแบบ prebuilt:

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

      หากคุณเห็น `sharp: Please add node-gyp to your dependencies` ให้ติดตั้งเครื่องมือสำหรับ build (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 ต้องการการอนุมัติอย่างชัดเจนสำหรับแพ็กเกจที่มีสคริปต์ build หลังจากการติดตั้งครั้งแรกแสดงคำเตือน "Ignored build scripts" ให้รัน `pnpm approve-builds -g` และเลือกแพ็กเกจที่แสดงรายการ
    </Note>
  </Tab>
</Tabs>
```

สำหรับผู้มีส่วนร่วม หรือผู้ที่ต้องการรันจากเช็กเอาต์ในเครื่อง

```
<Steps>
  <Step title="โคลนและ build">
    โคลน [รีโป OpenClaw](https://github.com/openclaw/openclaw) และ build:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```
  </Step>
  <Step title="ลิงก์ CLI">
    ทำให้คำสั่ง `openclaw` ใช้งานได้แบบ global:

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

    หรือจะข้ามการลิงก์และรันคำสั่งผ่าน `pnpm openclaw ...` จากภายในรีโปก็ได้
  </Step>
  <Step title="รันการเริ่มต้นใช้งาน">
    ```bash
    openclaw onboard --install-daemon
    ```
  </Step>
</Steps>

สำหรับเวิร์กโฟลว์การพัฒนาที่ลึกขึ้น ดูที่ [การตั้งค่า](/start/setup)
```

วิธีติดตั้งอื่นๆ¶

การดีพลอยแบบคอนเทนเนอร์หรือแบบ headless การติดตั้งเชิงประกาศผ่าน Nix การจัดเตรียมฟลีตอัตโนมัติ การใช้งานเฉพาะ CLI ผ่านรันไทม์ Bun

หลังการติดตั้ง¶

ตรวจสอบว่าทุกอย่างทำงานได้ตามปกติ:

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.

การแก้ไขปัญหา: ไม่พบ openclaw¶

การวินิจฉัยอย่างรวดเร็ว:

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

หาก $(npm prefix -g)/bin (macOS/Linux) หรือ $(npm prefix -g) (Windows) ไม่ อยู่ใน $PATH ของคุณ เชลล์จะไม่สามารถค้นหาไบนารี npm แบบ global ได้ (รวมถึง openclaw)

วิธีแก้ไข — เพิ่มเข้าไปในไฟล์เริ่มต้นของเชลล์ (~/.zshrc หรือ ~/.bashrc):

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

บน Windows ให้เพิ่มเอาต์พุตของ npm prefix -g ลงใน PATH ของคุณ

จากนั้นเปิดเทอร์มินัลใหม่ (หรือ rehash ใน zsh / hash -r ใน bash)

อัปเดต / ถอนการติดตั้ง¶

อัปเดต OpenClaw ให้เป็นเวอร์ชันล่าสุด ย้ายไปยังเครื่องใหม่ ลบ OpenClaw ออกทั้งหมด