วิธีติดตั้ง OpenClaw บน macOS, Windows และ Linux

ติดตั้ง OpenClaw

OpenClaw สามารถติดตั้งได้บนทุกระบบปฏิบัติการหลัก ได้แก่ macOS, Windows และ Linux — คู่มือนี้แปลจากเอกสารทางการของ OpenClaw โดยตรง อัปเดตเนื้อหาเดือนมีนาคม 2026

0. ติดตั้ง Git ก่อน (ถ้ายังไม่มี)

Git จำเป็นสำหรับการ clone โปรเจกต์ และใช้งานร่วมกับ OpenClaw Skills ต่างๆ เช่น GitHub integration ตรวจสอบก่อนว่ามี Git แล้วหรือยัง:

git --version

ถ้ายังไม่มี ให้ติดตั้งตาม OS ของคุณ:

# ใช้ Xcode Command Line Tools (วิธีที่ง่ายที่สุด)
xcode-select --install

# หรือใช้ Homebrew
brew install git

1. วิธีที่แนะนำ: Installer Script

วิธีที่เร็วที่สุดในการติดตั้ง OpenClaw — สคริปต์จะตรวจจับ OS ของคุณ, ติดตั้ง Node ให้ถ้ายังไม่มี, ติดตั้ง OpenClaw และเปิด Onboarding อัตโนมัติ

ติดตั้งพร้อม Onboarding

curl -fsSL https://openclaw.ai/install.sh | bash

ติดตั้งโดยไม่ต้อง Onboarding

สำหรับ CI/Automation หรือกรณีที่ต้องการข้าม onboarding flow:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

สำหรับ flags ทั้งหมดและตัวเลือก CI/automation ดูเพิ่มเติมที่ Installer internals

2. ความต้องการของระบบ (System Requirements)

• Node.js 24 (แนะนำ) หรือ Node 22.16+ — installer script จะจัดการให้อัตโนมัติ
• ระบบปฏิบัติการ: macOS, Linux หรือ Windows — รองรับทั้ง Native Windows และ WSL2 (WSL2 เสถียรกว่า)
• pnpm จำเป็นเฉพาะกรณี build จาก source เท่านั้น
• Git จำเป็นสำหรับ clone repo และใช้งาน GitHub integrations

3. ติดตั้งผ่าน npm / pnpm

สำหรับคนที่จัดการ Node.js เองอยู่แล้ว:

npm install -g openclaw@latest
openclaw onboard --install-daemon

4. ติดตั้งจาก Source (สำหรับ Contributors)

สำหรับคนที่ต้องการ contribute หรือรัน local checkout:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon

หรือจะข้ามขั้นตอน link แล้วใช้ pnpm openclaw ... จากภายใน repo ก็ได้ — ดูรายละเอียดเพิ่ม: Setup Guide

5. ตรวจสอบการติดตั้ง

หลังจากติดตั้งเสร็จ ให้รันคำสั่งเหล่านี้เพื่อยืนยันว่าทุกอย่างพร้อมใช้งาน:

openclaw --version      # ยืนยันว่า CLI พร้อมใช้งาน
openclaw doctor         # ตรวจสอบปัญหาเรื่อง config
openclaw gateway status # ยืนยันว่า Gateway กำลังทำงานอยู่

6. การติดตั้งบน Windows (รายละเอียด)

OpenClaw รองรับทั้ง Native Windows และ WSL2 โดย WSL2 เป็นวิธีที่แนะนำ เพราะเสถียรกว่า — CLI, Gateway และ Tooling ทั้งหมดรันใน Linux ได้เต็มรูปแบบ

วิธีที่ 1: WSL2 (แนะนำ) แนะนำ

ขั้นตอน 1 — ติดตั้ง WSL2 + Ubuntu

เปิด PowerShell ในฐานะ Admin:

wsl --install
# หรือเลือก distro เอง:
wsl --list --online
wsl --install -d Ubuntu-24.04

Reboot เครื่องถ้า Windows ร้องขอ

ขั้นตอน 2 — เปิดใช้งาน systemd (จำเป็นสำหรับ Gateway)

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

ขั้นตอน 3 — ติดตั้ง OpenClaw ใน WSL

curl -fsSL https://openclaw.ai/install.sh | bash

วิธีที่ 2: Native Windows

สิ่งที่ทำงานได้ดีบน Native Windows:

• ติดตั้งผ่าน install.ps1
• ใช้งาน CLI เช่น openclaw --version, openclaw doctor
• รัน local agent ได้

openclaw agent --local --agent main --thinking low -m "Reply with exactly WINDOWS-HATCH-OK."

ข้อจำกัดปัจจุบัน: openclaw onboard --non-interactive ยังต้องการ local gateway (ใช้ --skip-health เพื่อข้าม) — การติดตั้ง daemon จะพยายามใช้ Windows Scheduled Tasks ก่อน แล้ว fallback เป็น Startup-folder

7. ติดตั้ง Gateway Service

Gateway คือ background service ที่ OpenClaw ใช้รับ-ส่งข้อมูล

# วิธีใดวิธีหนึ่ง:
openclaw onboard --install-daemon
# หรือ
openclaw gateway install
# หรือ
openclaw configure
# แล้วเลือก "Gateway service" เมื่อถูกถาม

8. อัปเดต / ถอนการติดตั้ง

npm install -g openclaw@latest

9. แก้ปัญหา: หาคำสั่ง openclaw ไม่เจอ

ถ้าติดตั้งสำเร็จแต่พิมพ์ openclaw แล้วไม่เจอ:

node -v           # Node ติดตั้งแล้วหรือยัง?
npm prefix -g     # global packages อยู่ที่ไหน?
echo "$PATH"      # global bin directory อยู่ใน PATH หรือเปล่า?

ดูรายละเอียดเพิ่มที่ Node setup

10. ทดสอบการใช้งาน

openclaw "สวัสดี บอกฉันเกี่ยวกับตัวเองหน่อย"

ถ้าเห็น AI ตอบกลับมา แสดงว่าติดตั้งสำเร็จแล้ว! 🎉

อ้างอิง

• เอกสารทางการ: Install
• Installer Internals
• Windows Platform Guide
• Node Setup