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
คอนเทนเนอร์และตัวจัดการแพ็กเกจ
การปรับใช้แบบคอนเทนเนอร์หรือแบบไม่มีหน้าจอ
ทางเลือกคอนเทนเนอร์แบบ rootless แทน Docker
การติดตั้งแบบประกาศผ่าน Nix flake
การจัดเตรียมเครื่องจำนวนมากแบบอัตโนมัติ
การใช้งานเฉพาะ CLI ผ่าน Bun runtime
ตรวจสอบการติดตั้ง
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:
OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii90aC9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:
อัปเดต ย้าย หรือถอนการติดตั้ง
รักษา OpenClaw ให้เป็นเวอร์ชันล่าสุด
ย้ายไปยังเครื่องใหม่
ลบ OpenClaw ออกทั้งหมด
การแก้ปัญหา: ไม่พบ 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 สำหรับรายละเอียดเพิ่มเติม
Docs agent