Install overview
ติดตั้ง
ข้อกำหนดของระบบ
- Node 24 (แนะนำ) หรือ Node 22.16+ - สคริปต์ติดตั้งจัดการเรื่องนี้ให้อัตโนมัติ
- macOS, Linux หรือ Windows - รองรับทั้ง Windows แบบเนทีฟและ WSL2; WSL2 มีความเสถียรมากกว่า ดู Windows
- จำเป็นต้องใช้
pnpmเฉพาะเมื่อคุณ build จากซอร์ส
แนะนำ: สคริปต์ติดตั้ง
วิธีติดตั้งที่เร็วที่สุด โดยจะตรวจหา OS ของคุณ ติดตั้ง Node หากจำเป็น ติดตั้ง OpenClaw และเริ่ม onboarding
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexหากต้องการติดตั้งโดยไม่รัน onboarding:
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboardWindows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardสำหรับ flags ทั้งหมดและตัวเลือก CI/automation ดู รายละเอียดภายในของตัวติดตั้ง
วิธีติดตั้งทางเลือก
ตัวติดตั้งแบบ local prefix (install-cli.sh)
ใช้วิธีนี้เมื่อคุณต้องการเก็บ OpenClaw และ Node ไว้ใต้ local prefix เช่น
~/.openclaw โดยไม่ต้องพึ่งการติดตั้ง Node ระดับทั้งระบบ:
curl -fsSL https://openclaw.ai/install-cli.sh | bashโดยค่าเริ่มต้นรองรับการติดตั้งผ่าน npm รวมถึงการติดตั้งแบบ git-checkout ภายใต้ flow prefix เดียวกัน อ้างอิงฉบับเต็ม: รายละเอียดภายในของตัวติดตั้ง
ติดตั้งไว้แล้วใช่ไหม สลับระหว่างการติดตั้งแบบ package และ git ด้วย
openclaw update --channel dev และ openclaw update --channel stable ดู
การอัปเดต
npm, pnpm หรือ bun
หากคุณจัดการ Node เองอยู่แล้ว:
npm
npm install -g openclaw@latestopenclaw onboard --install-daemonpnpm
pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemonbun
bun add -g openclaw@latestopenclaw 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.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemonหรือข้ามการ link แล้วใช้ pnpm openclaw ... จากภายใน repo ดู การตั้งค่า สำหรับ workflow การพัฒนาแบบเต็ม
ติดตั้งจาก GitHub main
npm install -g github:openclaw/openclaw#mainContainers และ package managers
การ deploy แบบ containerized หรือ headless
ทางเลือก container แบบ rootless แทน Docker
การติดตั้งแบบ declarative ผ่าน Nix flake
การ provision fleet แบบอัตโนมัติ
การใช้งานเฉพาะ CLI ผ่านรันไทม์ Bun
ตรวจสอบการติดตั้ง
openclaw --version # confirm the CLI is availableopenclaw doctor # check for config issuesopenclaw gateway status # verify the Gateway is runningหากคุณต้องการ managed startup หลังติดตั้ง:
- macOS: LaunchAgent ผ่าน
openclaw onboard --install-daemonหรือopenclaw gateway install - Linux/WSL2: systemd user service ผ่านคำสั่งเดียวกัน
- Windows แบบเนทีฟ: ใช้ Scheduled Task ก่อน โดยมีรายการ login ใน Startup-folder ต่อผู้ใช้เป็น fallback หากการสร้าง task ถูกปฏิเสธ
Hosting และ deployment
Deploy OpenClaw บน cloud server หรือ VPS:
อัปเดต ย้าย หรือถอนการติดตั้ง
ทำให้ OpenClaw เป็นปัจจุบันอยู่เสมอ
ย้ายไปยังเครื่องใหม่
ลบ OpenClaw ออกทั้งหมด
การแก้ไขปัญหา: ไม่พบ openclaw
หากติดตั้งสำเร็จแล้วแต่ไม่พบ openclaw ใน terminal ของคุณ:
node -v # Node installed?npm prefix -g # Where are global packages?echo "$PATH" # Is the global bin dir in PATH?หาก $(npm prefix -g)/bin ไม่อยู่ใน $PATH ของคุณ ให้เพิ่มลงในไฟล์ startup ของ shell (~/.zshrc หรือ ~/.bashrc):
export PATH="$(npm prefix -g)/bin:$PATH"จากนั้นเปิด terminal ใหม่ ดู การตั้งค่า Node สำหรับรายละเอียดเพิ่มเติม