Install overview

ติดตั้ง

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

  • Node 24 (แนะนำ) หรือ Node 22.14+ - สคริปต์ตัวติดตั้งจะจัดการเรื่องนี้ให้อัตโนมัติ
  • macOS, Linux หรือ Windows - รองรับทั้ง Windows แบบเนทีฟและ WSL2; WSL2 เสถียรกว่า ดู Windows
  • ต้องใช้ pnpm เฉพาะเมื่อคุณสร้างจากซอร์ส

แนะนำ: สคริปต์ตัวติดตั้ง

วิธีติดตั้งที่เร็วที่สุด ระบบจะตรวจหา OS ของคุณ ติดตั้ง Node หากจำเป็น ติดตั้ง OpenClaw และเริ่มขั้นตอนเริ่มต้นใช้งาน

macOS / Linux / WSL2

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

หากต้องการติดตั้งโดยไม่เรียกใช้ขั้นตอนเริ่มต้นใช้งาน:

macOS / Linux / WSL2

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Windows (PowerShell)

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

สำหรับ flag ทั้งหมดและตัวเลือก CI/ระบบอัตโนมัติ ดู รายละเอียดภายในของตัวติดตั้ง

วิธีติดตั้งทางเลือก

ตัวติดตั้ง prefix ภายในเครื่อง (install-cli.sh)

ใช้วิธีนี้เมื่อคุณต้องการเก็บ OpenClaw และ Node ไว้ใต้ prefix ภายในเครื่อง เช่น ~/.openclaw โดยไม่ต้องพึ่งพาการติดตั้ง Node แบบทั้งระบบ:

curl -fsSL https://openclaw.ai/install-cli.sh | bash

โดยค่าเริ่มต้น วิธีนี้รองรับการติดตั้งผ่าน npm รวมถึงการติดตั้งแบบ git-checkout ภายใต้ flow prefix เดียวกัน อ้างอิงฉบับเต็ม: รายละเอียดภายในของตัวติดตั้ง

ติดตั้งไว้แล้วใช่ไหม? สลับระหว่างการติดตั้งแบบแพ็กเกจและแบบ git ด้วย openclaw update --channel dev และ openclaw update --channel stable ดู การอัปเดต

npm, pnpm หรือ bun

หากคุณจัดการ Node เองอยู่แล้ว:

npm

npm install -g openclaw@latest
openclaw onboard --install-daemon

pnpm

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun

bun add -g openclaw@latest
openclaw onboard --install-daemon
การแก้ปัญหา: ข้อผิดพลาด build ของ sharp (npm)

หาก sharp ล้มเหลวเนื่องจาก libvips ที่ติดตั้งแบบ global:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

จากซอร์ส

สำหรับผู้ร่วมพัฒนาหรือผู้ที่ต้องการเรียกใช้จาก checkout ภายในเครื่อง:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

หรือข้ามการ link แล้วใช้ pnpm openclaw ... จากภายใน repo ดู การตั้งค่า สำหรับ workflow การพัฒนาแบบเต็ม

ติดตั้งจาก GitHub main

npm install -g github:openclaw/openclaw#main

คอนเทนเนอร์และตัวจัดการแพ็กเกจ

ตรวจสอบการติดตั้ง

openclaw --version      # ยืนยันว่า CLI พร้อมใช้งาน
openclaw doctor         # ตรวจหาปัญหาการกำหนดค่า
openclaw gateway status # ตรวจสอบว่า Gateway กำลังทำงาน

หากคุณต้องการให้เริ่มทำงานแบบมีการจัดการหลังติดตั้ง:

  • macOS: LaunchAgent ผ่าน openclaw onboard --install-daemon หรือ openclaw gateway install
  • Linux/WSL2: systemd user service ผ่านคำสั่งเดียวกัน
  • Windows แบบเนทีฟ: ใช้ Scheduled Task ก่อน พร้อม fallback เป็นรายการ login ในโฟลเดอร์ Startup ต่อผู้ใช้ หากการสร้าง task ถูกปฏิเสธ

การโฮสต์และการปรับใช้

ปรับใช้ OpenClaw บนเซิร์ฟเวอร์คลาวด์หรือ VPS:

VPS
Docker VM
Kubernetes

OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii90aC9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:

Hetzner
GCP
Azure
Railway
Render
Northflank

อัปเดต ย้าย หรือถอนการติดตั้ง

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

หากการติดตั้งสำเร็จแล้วแต่ไม่พบ openclaw ในเทอร์มินัลของคุณ:

node -v           # ติดตั้ง Node แล้วหรือไม่?
npm prefix -g     # แพ็กเกจ global อยู่ที่ใด?
echo "$PATH"      # ไดเรกทอรี bin แบบ global อยู่ใน PATH หรือไม่?

หาก $(npm prefix -g)/bin ไม่อยู่ใน $PATH ให้เพิ่มลงในไฟล์เริ่มต้นของ shell (~/.zshrc หรือ ~/.bashrc):

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

จากนั้นเปิดเทอร์มินัลใหม่ ดู การตั้งค่า Node สำหรับรายละเอียดเพิ่มเติม