ติดตั้ง

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

• Node 22.22.3+, 24.15+ หรือ 25.9+ - Node 24 เป็นเวอร์ชันเป้าหมายเริ่มต้น โดยสคริปต์ติดตั้งจะจัดการส่วนนี้โดยอัตโนมัติ
• macOS, Linux หรือ Windows - ผู้ใช้ Windows สามารถเริ่มต้นด้วยแอป Windows Hub แบบเนทีฟ โปรแกรมติดตั้ง CLI ผ่าน PowerShell หรือ Gateway บน WSL2 ดูที่ Windows
• จำเป็นต้องใช้ pnpm เฉพาะเมื่อบิลด์จากซอร์สเท่านั้น

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

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

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

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

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

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

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

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

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

โปรแกรมติดตั้งแบบคำนำหน้าภายในเครื่อง (install-cli.sh)

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

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

โดยค่าเริ่มต้นรองรับการติดตั้งด้วย npm รวมถึงการติดตั้งจาก git checkout ภายใต้ กระบวนการคำนำหน้าเดียวกัน เอกสารอ้างอิงฉบับเต็ม: รายละเอียดภายในของโปรแกรมติดตั้ง

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

npm, pnpm หรือ bun

หากจัดการ Node ด้วยตนเองอยู่แล้ว:

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

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

จากซอร์ส

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

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

หรือข้ามขั้นตอนการลิงก์และใช้ pnpm openclaw ... จากภายในรีโพซิทอรี ดูขั้นตอนการพัฒนาแบบเต็มได้ที่ การตั้งค่า

ติดตั้งจาก checkout ของสาขา main บน GitHub

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

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

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

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

หากต้องการให้ระบบจัดการการเริ่มทำงานหลังติดตั้ง:

• macOS: LaunchAgent ผ่าน openclaw onboard --install-daemon หรือ openclaw gateway install
• Linux/WSL2: บริการผู้ใช้ systemd ผ่านคำสั่งเดียวกัน
• Windows แบบเนทีฟ: ใช้ Scheduled Task เป็นอันดับแรก และใช้รายการเข้าสู่ระบบในโฟลเดอร์ Startup ของผู้ใช้เป็นทางเลือกสำรอง หากไม่ได้รับอนุญาตให้สร้างงาน

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

ปรับใช้ OpenClaw บนเซิร์ฟเวอร์คลาวด์หรือ VPS ดูตัวเลือกผู้ให้บริการทั้งหมดได้ที่ เซิร์ฟเวอร์ Linux (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi และอื่นๆ) หรือปรับใช้แบบประกาศบน Render

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

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

เกือบทุกกรณีเกิดจากปัญหา PATH: ไดเรกทอรีไบนารีส่วนกลางของ npm ไม่ได้อยู่ใน PATH ของเชลล์ ดูวิธีแก้ไขทั้งหมด รวมถึงพาธของ Windows ได้ที่ การแก้ไขปัญหา Node.js

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