Node.js

OpenClaw ต้องใช้ Node 22.22.3+, Node 24.15+ หรือ Node 25.9+ โดย Node 24 เป็นรันไทม์เริ่มต้นและแนะนำ สำหรับการติดตั้ง, CI และเวิร์กโฟลว์การเผยแพร่ ส่วน Node 22 ยังคงรองรับผ่านสาย LTS ที่ใช้งานอยู่ ไม่รองรับ Node 23 สคริปต์ติดตั้ง จะตรวจหาและติดตั้ง Node โดยอัตโนมัติ — ใช้หน้านี้เมื่อต้องการตั้งค่า Node ด้วยตนเอง (เวอร์ชัน, PATH, การติดตั้งแบบส่วนกลาง)

ตรวจสอบเวอร์ชัน

node -v

แนะนำให้ใช้ v24.15.0 หรือ 24.x ที่ใหม่กว่าเป็นค่าเริ่มต้น รองรับ v22.22.3 หรือ 22.x ที่ใหม่กว่าในสาย Node 22 LTS และรองรับ Node v25.9.0+ เช่นกัน ไม่รองรับ Node 23 หากไม่มี Node หรือเวอร์ชันอยู่นอกช่วงที่รองรับ ให้เลือกวิธีติดตั้งด้านล่าง

ติดตั้ง Node

brew install node

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejs

sudo dnf install nodejs

winget install OpenJS.NodeJS.LTS

choco install nodejs-lts

fnm install 24fnm use 24

การแก้ไขปัญหา

openclaw: command not found

กรณีนี้แทบทุกครั้งหมายความว่าไดเรกทอรี bin ส่วนกลางของ npm ไม่อยู่ใน PATH

npm prefix -g

echo "$PATH"

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

ข้อผิดพลาดเกี่ยวกับสิทธิ์ใน npm install -g (Linux)

หากพบข้อผิดพลาด EACCES ให้เปลี่ยนคำนำหน้าส่วนกลางของ npm เป็นไดเรกทอรีที่ผู้ใช้เขียนได้:

mkdir -p "$HOME/.npm-global"npm config set prefix "$HOME/.npm-global"export PATH="$HOME/.npm-global/bin:$PATH"

เพิ่มบรรทัด export PATH=... ลงใน ~/.bashrc หรือ ~/.zshrc เพื่อให้การตั้งค่านี้มีผลถาวร

เนื้อหาที่เกี่ยวข้อง

• ภาพรวมการติดตั้ง - วิธีติดตั้งทั้งหมด
• การอัปเดต - การทำให้ OpenClaw เป็นเวอร์ชันล่าสุดอยู่เสมอ
• เริ่มต้นใช้งาน - ขั้นตอนแรกหลังการติดตั้ง