OpenClawDocs
ในหน้านี้

ในหน้านี้

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Runtimes

Node.js

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

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

bash
node -v

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

ติดตั้ง Node

macOS

Homebrew (แนะนำ):

bash
brew install node

หรือดาวน์โหลดโปรแกรมติดตั้งสำหรับ macOS จาก nodejs.org

Linux

Ubuntu / Debian:

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

Fedora / RHEL:

bash
sudo dnf install nodejs

หรือใช้ตัวจัดการเวอร์ชัน (ดูด้านล่าง)

Windows

winget (แนะนำ):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

หรือดาวน์โหลดโปรแกรมติดตั้งสำหรับ Windows จาก nodejs.org

การใช้ตัวจัดการเวอร์ชัน (nvm, fnm, mise, asdf)

ตัวจัดการเวอร์ชันช่วยให้สลับระหว่างเวอร์ชันต่าง ๆ ของ Node ได้อย่างง่ายดาย ตัวเลือกยอดนิยมมีดังนี้:

  • fnm - รวดเร็วและรองรับหลายแพลตฟอร์ม
  • nvm - ใช้กันอย่างแพร่หลายบน macOS/Linux
  • mise - รองรับหลายภาษา (Node, Python, Ruby ฯลฯ)

ตัวอย่างการใช้ fnm:

bash
fnm install 24fnm use 24

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

openclaw: command not found

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

  • ค้นหาคำนำหน้าส่วนกลางของ npm

    bash
    npm prefix -g

  • ตรวจสอบว่าอยู่ใน PATH หรือไม่

    bash
    echo "$PATH"

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

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

    macOS / Linux

    เพิ่มลงใน ~/.zshrc หรือ ~/.bashrc:

    bash
    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 ให้เปลี่ยนคำนำหน้าส่วนกลางของ npm เป็นไดเรกทอรีที่ผู้ใช้เขียนได้:

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

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

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

    Was this useful?