Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw ต้องใช้ Node 22.16 หรือใหม่กว่า Node 24 เป็น runtime เริ่มต้นและที่แนะนำ สำหรับการติดตั้ง, CI และเวิร์กโฟลว์การเผยแพร่ Node 22 ยังรองรับผ่านสาย LTS ที่ยังใช้งานอยู่ สคริปต์ติดตั้ง จะตรวจจับและติดตั้ง Node โดยอัตโนมัติ - หน้านี้มีไว้สำหรับกรณีที่คุณต้องการตั้งค่า Node ด้วยตนเองและตรวจสอบให้แน่ใจว่าทุกอย่างเชื่อมต่อถูกต้อง (เวอร์ชัน, PATH, การติดตั้งแบบ global)

​
ตรวจสอบเวอร์ชันของคุณ

node -v
หากคำสั่งนี้แสดง v24.x.x หรือสูงกว่า แสดงว่าคุณอยู่บนค่าเริ่มต้นที่แนะนำ หากแสดง v22.16.x หรือสูงกว่า แสดงว่าคุณอยู่บนเส้นทาง Node 22 LTS ที่รองรับ แต่เรายังคงแนะนำให้อัปเกรดเป็น Node 24 เมื่อสะดวก หากยังไม่ได้ติดตั้ง Node หรือเวอร์ชันเก่าเกินไป ให้เลือกวิธีติดตั้งด้านล่าง

​
ติดตั้ง Node

Homebrew (แนะนำ):
brew install node
หรือดาวน์โหลดตัวติดตั้ง macOS จาก nodejs.org
ตัวจัดการเวอร์ชันช่วยให้คุณสลับระหว่างเวอร์ชันของ Node ได้ง่าย ตัวเลือกยอดนิยม:
  • fnm - รวดเร็ว ใช้ได้ข้ามแพลตฟอร์ม
  • nvm - ใช้งานแพร่หลายบน macOS/Linux
  • mise - รองรับหลายภาษา (Node, Python, Ruby ฯลฯ)
ตัวอย่างด้วย fnm:
fnm install 24
fnm use 24
ตรวจสอบให้แน่ใจว่าตัวจัดการเวอร์ชันของคุณถูกเริ่มต้นในไฟล์เริ่มต้นของเชลล์ (~/.zshrc หรือ ~/.bashrc) หากไม่ได้ตั้งค่าไว้ อาจหา openclaw ไม่พบในเซสชันเทอร์มินัลใหม่ เพราะ PATH จะไม่รวมไดเรกทอรี bin ของ Node

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

​
openclaw: command not found

ปัญหานี้เกือบทุกครั้งหมายความว่าไดเรกทอรี global bin ของ npm ไม่ได้อยู่ใน PATH ของคุณ
1

ค้นหา global npm prefix ของคุณ

npm prefix -g
2

ตรวจสอบว่าอยู่ใน PATH ของคุณหรือไม่

echo "$PATH"
มองหา <npm-prefix>/bin (macOS/Linux) หรือ <npm-prefix> (Windows) ในผลลัพธ์
3

เพิ่มลงในไฟล์เริ่มต้นของเชลล์

เพิ่มลงใน ~/.zshrc หรือ ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"
จากนั้นเปิดเทอร์มินัลใหม่ (หรือรัน rehash ใน zsh / hash -r ใน bash)

​
ข้อผิดพลาดด้านสิทธิ์ใน npm install -g (Linux)

หากคุณเห็นข้อผิดพลาด EACCES ให้เปลี่ยน global prefix ของ npm ไปยังไดเรกทอรีที่ผู้ใช้เขียนได้: 
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
เพิ่มบรรทัด export PATH=... ลงใน ~/.bashrc หรือ ~/.zshrc เพื่อให้มีผลถาวร

​
ที่เกี่ยวข้อง