Node.js¶

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

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

node -v

ถ้าคำสั่งนี้แสดง v22.x.x หรือสูงกว่า ก็ใช้งานได้ หากแสดง v22.x.x หรือสูงกว่า แสดงว่าใช้งานได้ หากยังไม่ได้ติดตั้ง Node หรือเวอร์ชันเก่าเกินไป ให้เลือกวิธีการติดตั้งด้านล่าง

ติดตั้ง Node¶

Homebrew (แนะนำ):

````
```bash
brew install node
```

หรือดาวน์โหลดตัวติดตั้ง macOS จาก [nodejs.org](https://nodejs.org/)
````

Ubuntu / Debian:

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

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

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

winget (แนะนำ):

````
```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

หรือดาวน์โหลดตัวติดตั้ง Windows จาก [nodejs.org](https://nodejs.org/)
````

ตัวจัดการเวอร์ชันช่วยให้คุณสลับเวอร์ชัน Node ได้อย่างง่ายดาย ตัวเลือกยอดนิยมได้แก่: ตัวเลือกยอดนิยม:

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

ตัวอย่างด้วย fnm:

fnm install 22
fnm use 22

ตรวจสอบให้แน่ใจว่าตัวจัดการเวอร์ชันของคุณถูกเริ่มต้นในไฟล์เริ่มต้นเชลล์ (~/.zshrc หรือ ~/.bashrc) ตรวจสอบให้แน่ใจว่าตัวจัดการเวอร์ชันของคุณถูกเริ่มต้นในไฟล์เริ่มต้นของเชลล์ (~/.zshrc หรือ ~/.bashrc) หากไม่ได้ตั้งค่าไว้ openclaw อาจไม่ถูกพบในเซสชันเทอร์มินัลใหม่ เนื่องจาก PATH จะไม่รวมไดเรกทอรี bin ของ Node

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

openclaw: command not found¶

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

bash npm prefix -g bash echo "$PATH"

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

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

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

        จากนั้นเปิดเทอร์มินัลใหม่ (หรือรัน `rehash` ใน zsh / `hash -r` ใน bash)
      </Tab>
      <Tab title="Windows">
        เพิ่มเอาต์พุตของ `npm prefix -g` ลงใน system PATH ผ่าน Settings → System → Environment Variables
      </Tab>
    </Tabs>
    ```

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

หากคุณเห็นข้อผิดพลาด EACCES ให้เปลี่ยน npm global prefix ไปยังไดเรกทอรีที่ผู้ใช้มีสิทธิ์เขียนได้:

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

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