English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Install overview

Node.js

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

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

bash
node -v

หากคำสั่งนี้พิมพ์ v24.x.x หรือสูงกว่า แสดงว่าคุณอยู่บนค่าเริ่มต้นที่แนะนำ หากพิมพ์ v22.19.x หรือสูงกว่า แสดงว่าคุณอยู่บนเส้นทาง Node 22 LTS ที่รองรับ แต่เรายังคงแนะนำให้อัปเกรดเป็น Node 24 เมื่อสะดวก Node 23 เวอร์ชันก่อน v23.11.0 ไม่รองรับ หากยังไม่ได้ติดตั้ง 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

Using a version manager (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 แบบ global ของ npm ไม่อยู่ใน PATH ของคุณ

  • Find your global npm prefix

    bash
    npm prefix -g

  • Check if it's on your PATH

    bash
    echo "$PATH"

    มองหา <npm-prefix>/bin (macOS/Linux) หรือ <npm-prefix> (Windows) ในเอาต์พุต

  • Add it to your shell startup file

    macOS / Linux

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

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

    จากนั้นเปิดเทอร์มินัลใหม่ (หรือเรียกใช้ rehash ใน zsh / hash -r ใน bash)

    Windows

    เพิ่มเอาต์พุตของ npm prefix -g ลงใน PATH ของระบบผ่าน การตั้งค่า → ระบบ → ตัวแปรสภาพแวดล้อม

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

    หากคุณเห็นข้อผิดพลาด EACCES ให้เปลี่ยน prefix แบบ global ของ 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?
    On this page

    On this page