Install overview
Node.js
OpenClaw ต้องใช้ Node 22.19 หรือใหม่กว่า Node 24 เป็น runtime เริ่มต้นและที่แนะนำ สำหรับการติดตั้ง, CI และเวิร์กโฟลว์การเผยแพร่ Node 22 ยังรองรับผ่านสาย LTS ที่ยังใช้งานอยู่ สคริปต์ติดตั้ง จะตรวจจับและติดตั้ง Node โดยอัตโนมัติ - หน้านี้มีไว้สำหรับกรณีที่คุณต้องการตั้งค่า Node ด้วยตัวเองและตรวจสอบให้แน่ใจว่าทุกอย่างเชื่อมต่อถูกต้อง (เวอร์ชัน, PATH, การติดตั้งแบบ global)
ตรวจสอบเวอร์ชันของคุณ
node -vหากคำสั่งนี้พิมพ์ v24.x.x หรือสูงกว่า แสดงว่าคุณใช้ค่าเริ่มต้นที่แนะนำแล้ว หากพิมพ์ v22.19.x หรือสูงกว่า แสดงว่าคุณอยู่บนเส้นทาง Node 22 LTS ที่รองรับ แต่เรายังแนะนำให้อัปเกรดเป็น Node 24 เมื่อสะดวก หากยังไม่ได้ติดตั้ง Node หรือเวอร์ชันเก่าเกินไป ให้เลือกวิธีติดตั้งด้านล่าง
ติดตั้ง Node
macOS
Homebrew (แนะนำ):
brew install nodeหรือดาวน์โหลดตัวติดตั้ง macOS จาก nodejs.org
Linux
Ubuntu / Debian:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejsFedora / RHEL:
sudo dnf install nodejsหรือใช้ตัวจัดการเวอร์ชัน (ดูด้านล่าง)
Windows
winget (แนะนำ):
winget install OpenJS.NodeJS.LTSChocolatey:
choco install nodejs-ltsหรือดาวน์โหลดตัวติดตั้ง Windows จาก nodejs.org
การใช้ตัวจัดการเวอร์ชัน (nvm, fnm, mise, asdf)
ตัวจัดการเวอร์ชันช่วยให้คุณสลับระหว่างเวอร์ชัน Node ได้ง่าย ตัวเลือกยอดนิยม:
- fnm - รวดเร็ว ใช้ได้ข้ามแพลตฟอร์ม
- nvm - ใช้กันอย่างแพร่หลายบน macOS/Linux
- mise - หลายภาษา (Node, Python, Ruby ฯลฯ)
ตัวอย่างด้วย fnm:
fnm install 24fnm use 24การแก้ไขปัญหา
openclaw: command not found
เกือบทุกครั้งหมายความว่าไดเรกทอรี bin แบบ global ของ npm ไม่ได้อยู่ใน PATH ของคุณ
ค้นหา prefix แบบ global ของ npm
npm prefix -gตรวจสอบว่าอยู่ใน PATH ของคุณหรือไม่
echo "$PATH"มองหา <npm-prefix>/bin (macOS/Linux) หรือ <npm-prefix> (Windows) ในผลลัพธ์
เพิ่มลงในไฟล์เริ่มต้นของเชลล์ของคุณ
macOS / Linux
เพิ่มลงใน ~/.zshrc หรือ ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"จากนั้นเปิดเทอร์มินัลใหม่ (หรือรัน rehash ใน zsh / hash -r ใน bash)
Windows
เพิ่มผลลัพธ์ของ npm prefix -g ลงใน PATH ของระบบผ่าน Settings → System → Environment Variables
ข้อผิดพลาดเกี่ยวกับสิทธิ์ใน npm install -g (Linux)
หากคุณเห็นข้อผิดพลาด EACCES ให้เปลี่ยน prefix แบบ global ของ 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 เป็นเวอร์ชันล่าสุดอยู่เสมอ
- เริ่มต้นใช้งาน - ขั้นตอนแรกหลังติดตั้ง