Install overview

ติดตั้ง

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

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

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

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

macOS / Linux / WSL2

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

Windows (PowerShell)

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

หากต้องการติดตั้งโดยไม่รัน onboarding:

macOS / Linux / WSL2

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

Windows (PowerShell)

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 ระดับทั้งระบบ:

bash
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

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

pnpm

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

bun

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

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

bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

จากซอร์ส

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

bash
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

bash
npm install -g github:openclaw/openclaw#main

Containers และ package managers

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

bash
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:

VPS
Docker VM
Kubernetes
Fly.io
Hetzner
GCP
Azure
Railway
Render
Northflank

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

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

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

bash
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):

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

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

Was this useful?