ติดตั้ง

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

• Node 22.19+, 23.11+ หรือ 24+ - 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 หรือไม่?