ติดตั้ง

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

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

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

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

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

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

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

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

& ([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 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

หรือข้ามการ link แล้วใช้ pnpm openclaw ... จากภายใน repo ดู การตั้งค่า สำหรับ workflow การพัฒนาแบบเต็ม

ติดตั้งจาก GitHub main checkout

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

Containers และตัวจัดการ package

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

openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw gateway status # verify the Gateway is running

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

• macOS: LaunchAgent ผ่าน openclaw onboard --install-daemon หรือ openclaw gateway install
• Linux/WSL2: บริการ systemd ระดับ user ผ่านคำสั่งเดียวกัน
• Native Windows: ใช้ Scheduled Task ก่อน พร้อม fallback เป็นรายการ login ในโฟลเดอร์ Startup ต่อผู้ใช้ หากการสร้าง task ถูกปฏิเสธ

การโฮสต์และการ deploy

Deploy OpenClaw บนเซิร์ฟเวอร์คลาวด์หรือ VPS:

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

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

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

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 ของคุณ ให้เพิ่มลงในไฟล์เริ่มต้นของ shell (~/.zshrc หรือ ~/.bashrc):

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

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