คู่มือติดตั้ง OpenClaw สำหรับ macOS, Linux และ Windows

OpenClaw เป็นเครื่องมือภายในเครื่องที่ช่วยให้ AI agent ของคุณเชื่อมต่อกับแอปอย่าง Telegram หรือ WhatsApp และลงมือทำงานได้ เช่น ส่งข้อความหรือจัดการงานต่าง ๆ การตั้งค่าไม่ยากเมื่อเข้าใจกระบวนการแล้ว คู่มือนี้ครอบคลุมการติดตั้งบน macOS, Linux และ Windows

ภาพรวมอย่างย่อของตัวเลือกการตั้งค่า OpenClaw

เลือกวิธีตั้งค่าที่เหมาะกับความต้องการของคุณ การรัน OpenClaw ในเครื่องจะเก็บทุกอย่างไว้บนเครื่องของคุณเอง และต้องติดตั้ง dependencies เช่น npm หรือใช้สคริปต์อัตโนมัติ หากต้องการข้ามขั้นตอนตั้งค่า แพลตฟอร์มแบบโฮสต์เต็มรูปแบบอย่าง Kimi Claw จะจัดการสภาพแวดล้อมให้ คุณจึงเริ่มใช้งานได้ทันที

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

macOS และ Linux ใช้โปรแกรมติดตั้งและคำสั่งชุดเดียวกัน คำแนะนำต่อไปนี้ใช้ได้กับทั้งสองระบบ เว้นแต่จะระบุไว้เป็นอย่างอื่น

ด้านล่างคือคู่มือตั้งค่าอย่างย่อ สำหรับขั้นตอนแบบละเอียดพร้อมภาพหน้าจอ โปรดดู วิธีติดตั้ง OpenClaw บน macOS

วิธีที่ 1: ใช้สคริปต์ติดตั้งแบบบรรทัดเดียว

ขั้นตอนที่ 1: รันสคริปต์ติดตั้งใน Terminal

รันสคริปต์ติดตั้งอย่างเป็นทางการเพื่อตั้งค่า OpenClaw สคริปต์จะตรวจสอบว่ามี Node.js 22 หรือใหม่กว่าติดตั้งอยู่หรือไม่ หากไม่มีหรือเวอร์ชันเก่าเกินไป ระบบจะติดตั้ง Node.js 24 ให้โดยอัตโนมัติ จากนั้นจะติดตั้ง OpenClaw CLI และเปิดตัวช่วยเริ่มต้นใช้งาน

ขั้นตอนที่ 2: ทำตัวช่วยเริ่มต้นใช้งานให้เสร็จ

ทำตามตัวช่วยเริ่มต้นใช้งานเพื่อตั้งค่าสภาพแวดล้อม agent ของคุณ รวมถึงเลือกผู้ให้บริการโมเดล (เช่น Kimi API) กรอก API key เลือกช่องทาง และกำหนดค่าพื้นฐาน

ขั้นตอนที่ 3: ตรวจสอบการติดตั้ง

รันคำสั่งต่อไปนี้เพื่อยืนยันเวอร์ชัน OpenClaw ของคุณ

ขั้นตอนที่ 4: ตรวจสอบ gateway และตั้งค่าให้เสร็จสมบูรณ์

รันคำสั่งต่อไปนี้เพื่อตรวจสอบว่า OpenClaw gateway ทำงานอยู่

โปรแกรมติดตั้งยังลงทะเบียน LaunchAgent บน macOS หรือบริการ systemd บน Linux เพื่อให้ OpenClaw ทำงานต่อในเบื้องหลัง เมื่อทุกอย่างตั้งค่าเรียบร้อยแล้ว agent ของคุณก็พร้อมใช้งาน คุณสามารถเริ่มแชท เชื่อมต่อเครื่องมือ หรือกำหนดค่า workflows ตามต้องการได้

วิธีที่ 2: ติดตั้งด้วย Homebrew

ขั้นตอนที่ 1: ติดตั้งหรืออัปเกรด Node.js

ใช้ Homebrew ติดตั้ง Node.js โดยรันคำสั่งต่อไปนี้ใน Terminal หากติดตั้ง Node.js ไว้แล้ว ให้รันคำสั่งอัปเกรดแทน เพื่อให้แน่ใจว่าคุณใช้เวอร์ชันล่าสุด

ขั้นตอนที่ 2: ติดตั้ง OpenClaw CLI

รันคำสั่งต่อไปนี้เพื่อติดตั้ง OpenClaw CLI แบบ global

ขั้นตอนที่ 3: เริ่มต้นใช้งานและตั้งค่า daemon

รันคำสั่งต่อไปนี้เพื่อเปิดตัวช่วยเริ่มต้นใช้งานและลงทะเบียน daemon เบื้องหลัง จากนั้นทำตามตัวช่วยเพื่อตั้งค่าสภาพแวดล้อม agent ของคุณ รวมถึงเลือกผู้ให้บริการโมเดล (เช่น Kimi API) กรอก API key และเชื่อมต่อช่องทางรับส่งข้อความ เมื่อตั้งค่าเสร็จแล้ว agent ของคุณก็พร้อมใช้งาน คุณสามารถเริ่มแชท เชื่อมต่อเครื่องมือ หรือกำหนดค่า workflows ตามต้องการได้

วิธีที่ 3: ติดตั้งด้วย npm

ขั้นตอนที่ 1: ตรวจสอบเวอร์ชัน runtime

รันคำสั่งต่อไปนี้เพื่อให้แน่ใจว่าระบบของคุณติดตั้ง Node.js 22.14 หรือใหม่กว่าแล้ว หากเวอร์ชันเป็นปัจจุบัน คุณสามารถดำเนินการติดตั้งต่อได้

ขั้นตอนที่ 2: ติดตั้ง OpenClaw CLI

รันคำสั่งต่อไปนี้เพื่อติดตั้ง OpenClaw CLI แบบ global

ขั้นตอนที่ 3: เริ่มต้นใช้งานและเปิดใช้การทำงานต่อเนื่อง

รันคำสั่งต่อไปนี้เพื่อเริ่มตัวช่วยเริ่มต้นใช้งานและลงทะเบียน daemon เบื้องหลัง จากนั้นทำตามตัวช่วยเพื่อตั้งค่าสภาพแวดล้อม agent ของคุณ รวมถึงเลือกผู้ให้บริการโมเดล (เช่น Kimi API) กรอก API key และเลือกช่องทางรับส่งข้อความ เมื่อตั้งค่าเสร็จแล้ว agent ของคุณก็พร้อมใช้งาน คุณสามารถเริ่มโต้ตอบกับ agent เชื่อมต่อเครื่องมือ หรือสร้าง workflows ตามต้องการได้

หมายเหตุเกี่ยวกับแพลตฟอร์ม: OpenClaw รองรับ Mac ทั้งแบบ Intel และ Apple Silicon หาก Gatekeeper บล็อกการติดตั้ง คุณสามารถอนุญาตได้ใน System Settings ภายใต้ Privacy & Security

วิธีติดตั้ง OpenClaw บน Windows

Windows มีวิธีติดตั้ง OpenClaw หลัก ๆ 3 วิธี ได้แก่ โปรแกรมติดตั้ง PowerShell สำหรับการตั้งค่าแบบ native ที่รวดเร็ว, WSL2 สำหรับสภาพแวดล้อม Linux เต็มรูปแบบ และ npm สำหรับการติดตั้งด้วยตนเอง

ด้านล่างคือคู่มือตั้งค่าอย่างย่อ สำหรับขั้นตอนแบบละเอียดพร้อมภาพหน้าจอ โปรดดู วิธีติดตั้ง OpenClaw บน Windows

วิธีที่ 1: ใช้โปรแกรมติดตั้ง PowerShell (Windows แบบ native)

ขั้นตอนที่ 1: รันสคริปต์ติดตั้งใน PowerShell

เปิด PowerShell ในฐานะผู้ดูแลระบบ แล้วรันสคริปต์ทางการแบบบรรทัดเดียวเพื่อติดตั้ง OpenClaw

ขั้นตอนที่ 2: ทำตัวช่วยเริ่มต้นใช้งานให้เสร็จ

ทำตามขั้นตอนเริ่มต้นใช้งานเพื่อตั้งค่าสภาพแวดล้อม agent ของคุณ รวมถึงเลือกผู้ให้บริการโมเดล (เช่น Kimi API) กรอก API key และเลือกช่องทางรับส่งข้อความ

ขั้นตอนที่ 3: ตรวจสอบการติดตั้ง

รันคำสั่งต่อไปนี้เพื่อยืนยันว่าติดตั้ง OpenClaw ถูกต้องและ gateway ทำงานอยู่

ขั้นตอนที่ 4: เริ่มใช้ agent ของคุณ

เมื่อตั้งค่าเสร็จแล้ว agent ของคุณก็พร้อมใช้งาน คุณสามารถเริ่มโต้ตอบกับ agent เชื่อมต่อเครื่องมือ หรือกำหนดค่า workflows ตามต้องการได้

วิธีที่ 2: ติดตั้งด้วย WSL2

ขั้นตอนที่ 1: ตั้งค่าสภาพแวดล้อม Linux

เปิด PowerShell ในฐานะผู้ดูแลระบบ แล้วรันคำสั่งต่อไปนี้เพื่อเปิดใช้และเริ่มต้น WSL2

ขั้นตอนที่ 2: รันโปรแกรมติดตั้งใน Linux

เปิดเทอร์มินัล Linux ของคุณ แล้วรันสคริปต์ติดตั้งมาตรฐานเพื่อติดตั้ง OpenClaw

ขั้นตอนที่ 3: ทำตัวช่วยเริ่มต้นใช้งานให้เสร็จ

ทำตามขั้นตอนเริ่มต้นใช้งานเพื่อตั้งค่าสภาพแวดล้อม agent ของคุณ รวมถึงเลือกผู้ให้บริการโมเดล (เช่น Kimi API) กรอก API key และเลือกช่องทางรับส่งข้อความ

เมื่อตั้งค่าเสร็จแล้ว agent ของคุณก็พร้อมใช้งาน คุณสามารถเริ่มโต้ตอบกับ agent เชื่อมต่อเครื่องมือ หรือกำหนดค่า workflows ตามต้องการได้

วิธีที่ 3: ติดตั้งด้วย npm บน Windows

ขั้นตอนที่ 1: ตรวจสอบเวอร์ชัน Node.js ของคุณ

รันคำสั่งต่อไปนี้เพื่อตรวจสอบว่าได้ติดตั้ง Node.js แล้วและเป็นเวอร์ชันล่าสุด

ขั้นตอนที่ 2: ติดตั้ง OpenClaw CLI

รันคำสั่งต่อไปนี้เพื่อติดตั้ง OpenClaw CLI แบบ global

ขั้นตอนที่ 3: เริ่มต้นใช้งานและเปิดใช้การทำงานต่อเนื่อง

รันคำสั่งต่อไปนี้เพื่อเริ่มตัวช่วยเริ่มต้นใช้งานและลงทะเบียน daemon เบื้องหลัง

ทำตามขั้นตอนเริ่มต้นใช้งานเพื่อตั้งค่าสภาพแวดล้อม agent ของคุณ รวมถึงเลือกผู้ให้บริการโมเดล (เช่น Kimi API) กรอก API key และเลือกช่องทางรับส่งข้อความ

เมื่อตั้งค่าเสร็จแล้ว agent ของคุณก็พร้อมใช้งาน คุณสามารถเริ่มโต้ตอบกับ agent เชื่อมต่อเครื่องมือ หรือกำหนดค่า workflows ตามต้องการได้

วิธีรัน OpenClaw ออนไลน์ด้วย Kimi Claw

วิธีข้างต้นต้องใช้เทอร์มินัล, Node.js เวอร์ชันที่รองรับ และเครื่องที่เปิดทำงานตลอดเวลา Kimi Claw มีตัวเลือกแบบโฮสต์เต็มรูปแบบ คุณจึงรัน OpenClaw ได้โดยไม่ต้องติดตั้งหรือดูแลสภาพแวดล้อมภายในเครื่อง

ขั้นตอนที่ 1: เปิด Kimi Claw แล้วสร้าง instance

ไปที่หน้า Kimi Claw แล้วคลิก Create เพื่อเริ่มต้น

ขั้นตอนที่ 2: ยืนยันการ deploy

ยืนยันการ deploy ในหน้าต่างป๊อปอัป Kimi Claw จะตั้งค่าสภาพแวดล้อม OpenClaw ให้คุณโดยอัตโนมัติ รวมถึง gateway และ workspace โดยไม่ต้องกำหนดค่าใด ๆ ในเครื่อง

ขั้นตอนที่ 3: เริ่มใช้ workspace ของคุณ

เมื่อ deploy เสร็จแล้ว workspace ของคุณจะเปิดใน dashboard คุณสามารถเริ่มโต้ตอบกับ agent ตั้งค่า skills กำหนดค่างานตามกำหนดเวลา และจัดการไฟล์ได้โดยตรงในเบราว์เซอร์

ฟีเจอร์หลักของ Kimi Claw

• โฮสต์บนคลาวด์: Kimi Claw รัน gateway ของคุณบนคลาวด์ agent ของคุณจึงยังพร้อมใช้งานแม้เครื่องภายในของคุณจะออฟไลน์

• บำรุงรักษาอัตโนมัติ: ระบบจัดการการอัปเดตและแพตช์ให้เบื้องหลัง โดยไม่ต้องตั้งค่าหรือรีสตาร์ตด้วยตนเอง

• ความสามารถในตัว: มีการตั้งเวลางาน พื้นที่จัดเก็บถาวร และการโหลด skills แบบไดนามิกตาม prompts ของคุณ พร้อมการเข้าถึงข้ามอุปกรณ์อย่างไร้รอยต่อ

การแก้ไขข้อผิดพลาดทั่วไปในการติดตั้ง OpenClaw

ปัญหาการติดตั้ง OpenClaw ส่วนใหญ่มักอยู่ในไม่กี่กลุ่ม เช่น การตั้งค่า PATH, dependency ที่ขาดหาย หรือพอร์ตชนกัน ส่วนต่อไปนี้จะช่วยให้คุณระบุและแก้ไขปัญหาที่พบบ่อยที่สุดบน macOS, Windows และ Linux ได้อย่างรวดเร็ว

"openclaw: command not found" หลังติดตั้ง

OpenClaw ไม่อยู่ใน PATH ของระบบคุณ

• วิธีแก้: เพิ่มไดเรกทอรี npm global bin ลงใน PATH ของคุณ

จากนั้นโหลด shell ใหม่ (เช่น source ~/.zshrc) หรือรีสตาร์ตเทอร์มินัล บน Windows ให้เพิ่ม path ลงใน environment variables แล้วรีสตาร์ต PowerShell

ข้อผิดพลาดขณะ build Sharp บน macOS

โดยปกติเกิดขึ้นเมื่อ libvips ที่ติดตั้งแบบ global ขัดแย้งกับไลบรารี Sharp

• วิธีแก้: รันคำสั่งติดตั้งพร้อม environment variable นี้

หากพบข้อผิดพลาด node-gyp ให้ติดตั้ง Xcode Command Line Tools:

OpenClaw ไม่เริ่มทำงานหลังรีบูต

ไม่ได้ติดตั้ง daemon เบื้องหลังระหว่างขั้นตอนเริ่มต้นใช้งาน

• วิธีแก้: รันขั้นตอนเริ่มต้นใช้งานอีกครั้งพร้อมแฟล็ก daemon

จากนั้นตรวจสอบ service:

Gateway ไม่ตอบสนองหรือแสดง "0 tokens used"

กระบวนการ gateway อาจหยุดทำงาน หรือการยืนยันตัวตนผ่าน API อาจล้มเหลว

• วิธีแก้: รีสตาร์ต gateway

รันการตรวจสุขภาพ:

สำหรับ logs การ debug:

นอกจากนี้ ให้ตรวจสอบว่า API key ของคุณถูกต้อง

พอร์ต 18789 ถูกใช้งานอยู่แล้ว

มีกระบวนการอื่นใช้พอร์ต gateway ของ OpenClaw อยู่

• วิธีแก้: ค้นหาและหยุดกระบวนการที่ชนกัน

จากนั้นรีสตาร์ต gateway:

ข้อผิดพลาดสิทธิ์ EACCES

โดยปกติหมายความว่าไดเรกทอรี npm global ไม่มีสิทธิ์ที่ถูกต้อง

• วิธีแก้: อัปเดต ownership ของไดเรกทอรี

บน Windows ให้รัน PowerShell ในฐานะ Administrator หรือกำหนด npm prefix เอง:

สำหรับการตั้งค่าด้วย Docker ให้แก้ไขสิทธิ์ของ volume:

ข้อผิดพลาด "spawn git ENOENT"

ยังไม่ได้ติดตั้ง Git หรือ Git ไม่อยู่ใน PATH

• วิธีแก้: ติดตั้ง Git จาก git-scm.com รีสตาร์ตเทอร์มินัล แล้วลองติดตั้งอีกครั้ง

WSL2 systemd ไม่ทำงาน

ยังไม่ได้เปิดใช้ systemd ในการกำหนดค่า WSL ของคุณ

• วิธีแก้: แก้ไข /etc/wsl.conf แล้วเพิ่มรายการต่อไปนี้

จากนั้นรีสตาร์ต WSL:

เปิดเทอร์มินัล Linux อีกครั้งแล้วตรวจสอบ:

หน่วยความจำไม่พอระหว่าง npm install บน VPS

VPS ที่มีหน่วยความจำน้อยอาจล้มเหลวระหว่างการติดตั้งแพ็กเกจ

• วิธีแก้: สร้าง swap file

จากนั้นรันการติดตั้งอีกครั้ง

"Access not configured" เมื่อเชื่อมต่อกับแพลตฟอร์มรับส่งข้อความ

บัญชีของคุณยังไม่ได้รับอนุญาตจาก OpenClaw

• วิธีแก้: อนุมัติบัญชีของคุณด้วย pairing code

นอกจากนี้ ให้ตรวจสอบว่าข้อมูลยืนยันตัวตนของ bot (token, webhook, permissions) ถูกกำหนดค่าอย่างถูกต้อง

สรุป

การติดตั้ง OpenClaw บน macOS, Linux และ Windows ทำได้ไม่ยุ่งยาก คุณสามารถใช้สคริปต์บรรทัดเดียว, PowerShell, WSL2 หรือ npm ได้ตามรูปแบบการตั้งค่าของคุณ ตัวช่วยเริ่มต้นใช้งานจะพาคุณเลือกโมเดล ตั้งค่า API และเลือกช่องทางรับส่งข้อความ หากไม่ต้องการดูแลสภาพแวดล้อมภายในเครื่อง Kimi Claw มีตัวเลือกแบบโฮสต์เต็มรูปแบบที่ให้คุณรัน OpenClaw บนคลาวด์ได้โดยตรง