หากคุณกำลังพยายามติดตั้ง OpenClaw (ซึ่งมักถูกอ้างอิงในฟอร์กหรือแพ็คเกจของชุมชนในชื่อ Moltbot/Clawdbot) เพื่อใช้งานในเครื่องของคุณ ส่วนที่ยากมักไม่ใช่การโคลนคลังโค้ด แต่เป็นการจัดการเวอร์ชันรันไทม์ ตัวแปรสภาพแวดล้อม และปัญหาการสร้างสำหรับแพลตฟอร์มเฉพาะ
คู่มือนี้จะนำเสนอขั้นตอนการติดตั้งที่ใช้งานได้จริงและรองรับหลายแพลตฟอร์ม พร้อมด้วยขั้นตอนการแก้ไขข้อบกพร่องที่จะช่วยเมื่อเกิดปัญหาขึ้น
การตั้งค่า OpenClaw โดยทั่วไป
การแจกจ่าย OpenClaw ส่วนใหญ่มีรูปแบบการใช้งานเหมือนกัน:
- โคลนซอร์สโค้ดจาก Git
- ติดตั้งการพึ่งพาภาษา/รันไทม์
- กำหนดค่าไฟล์
.env(โทเค็น, ฐานข้อมูล, คีย์ API) - เริ่มต้นพื้นที่เก็บข้อมูล (SQLite/Postgres/Redis ขึ้นอยู่กับการสร้าง)
- เรียกใช้สคริปต์การโยกย้าย/เริ่มต้น
- เริ่มบริการและตรวจสอบปลายทางสถานะ
แม้ว่าฟอร์กเฉพาะของคุณจะแตกต่างกัน แต่รายการตรวจสอบนี้ครอบคลุมการติดตั้งเกือบทั้งหมด
ข้อกำหนดเบื้องต้น (ทุกระบบปฏิบัติการ)
ก่อนดำเนินการตามขั้นตอนเฉพาะของระบบปฏิบัติการ ให้ยืนยันพื้นฐานเหล่านี้:
- Git: สำหรับการโคลนและการดึงข้อมูลอัปเดต
- รันไทม์: โดยทั่วไปคือ Node.js (LTS) หรือ Python (3.10+) ขึ้นอยู่กับฟอร์ก
- ตัวจัดการแพ็คเกจ: npm/pnpm/yarn สำหรับ Node, pip/poetry สำหรับ Python
- ฐานข้อมูล (ไม่บังคับ): SQLite สำหรับการเริ่มต้นอย่างรวดเร็วในเครื่อง, Postgres สำหรับการใช้งานในทีม/staging
- เชลล์เทอร์มินัล: PowerShell (Windows), zsh/bash (macOS/Linux)
ตรวจสอบเครื่องมือของคุณ
bash git --version node -v npm -v python3 --version pip --version
หากเอกสารโครงการของคุณระบุเวอร์ชันที่แน่นอน ให้กำหนดเวอร์ชันเหล่านั้นตอนนี้ ความคลาดเคลื่อนของเวอร์ชันเป็นสาเหตุอันดับ 1 ของความล้มเหลวในการติดตั้งที่บอกว่า "ใช้งานได้บนเครื่องของฉัน"
ติดตั้ง OpenClaw บน macOS/Linux
บน macOS หรือ Linux ให้เรียกใช้ตัวติดตั้งแบบรวมศูนย์:
curl -fsSL https://openclaw.ai/install.sh | bash
สำหรับวิธีการติดตั้งทางเลือกและความต้องการระบบโดยละเอียด โปรดดูที่ส่วน การติดตั้ง
1. เรียกใช้ Onboarding Wizard
openclaw onboard --install-daemon
วิซาร์ดนี้จะตั้งค่าการตรวจสอบสิทธิ์ การกำหนดค่าเกตเวย์ และ ช่องทางการส่งข้อความ ทางเลือก (WhatsApp, Telegram, ฯลฯ)
สำหรับคำแนะนำฉบับเต็ม โปรดดูที่ เอกสารประกอบ Onboarding Wizard
2. ตรวจสอบเกตเวย์
หากคุณติดตั้งบริการเบื้องหลัง (daemon) มันควรจะทำงานอยู่แล้ว ตรวจสอบสถานะด้วย:
openclaw gateway status
3. เปิด Control UI
เปิดใช้งานแดชบอร์ด:
openclaw dashboard
ตอนนี้คุณสามารถเข้าถึงอินสแตนซ์ OpenClaw ของคุณผ่าน Control UI ที่เป็นเว็บเบราว์เซอร์ได้แล้ว
ติดตั้ง OpenClaw บน Windows
บน Windows (ด้วย PowerShell) ให้เรียกใช้ตัวติดตั้งแบบรวมศูนย์:
iwr -useb https://openclaw.ai/install.ps1 | iexสำหรับวิธีการติดตั้งทางเลือกและความต้องการระบบโดยละเอียด โปรดดูที่ส่วน การติดตั้ง
1. เรียกใช้ Onboarding Wizard
openclaw onboard --install-daemon
วิซาร์ดนี้จะตั้งค่าการตรวจสอบสิทธิ์ การกำหนดค่าเกตเวย์ และ ช่องทางการส่งข้อความ ทางเลือก (WhatsApp, Telegram, ฯลฯ)
สำหรับคำแนะนำฉบับเต็ม โปรดดูที่ เอกสารประกอบ Onboarding Wizard
2. ตรวจสอบเกตเวย์
หากคุณติดตั้งบริการเบื้องหลัง (daemon) มันควรจะทำงานอยู่แล้ว ตรวจสอบสถานะด้วย:
openclaw gateway status
3. เปิด Control UI
เปิดใช้งานแดชบอร์ด:
openclaw dashboard
ตอนนี้คุณสามารถเข้าถึงอินสแตนซ์ OpenClaw ของคุณผ่าน Control UI ที่เป็นเว็บเบราว์เซอร์ได้แล้ว
การติดตั้งโดยใช้ Docker (แนะนำเพื่อความสอดคล้องกัน)
หากคุณต้องการปัญหาการพึ่งพาระดับโฮสต์น้อยลง ให้เรียกใช้ OpenClaw ด้วย Docker Compose
ตัวอย่างรูปแบบ docker-compose.yml:
yaml version: '3.9' services: app: build: . ports: - "3000:3000" env_file: - .env depends_on: - db - redis
db: image: postgres:15 environment: POSTGRES_USER: openclaw POSTGRES_PASSWORD: openclaw POSTGRES_DB: openclaw ports: - "5432:5432"
redis: image: redis:7 ports: - "6379:6379"
เริ่มต้น:
bash docker compose up --build
วิธีการนี้ช่วยให้ได้สภาพแวดล้อมที่ทำซ้ำได้ใน macOS, Windows และ Linux โดยเฉพาะสำหรับทีม
ข้อผิดพลาดในการติดตั้งและวิธีแก้ไขที่พบบ่อย
1) MODULE_NOT_FOUND หรือข้อผิดพลาดในการนำเข้า
สาเหตุ: ไม่ได้ติดตั้งการพึ่งพา, ไฟล์ lockfile ผิดพลาด, หรือรันไทม์ไม่เข้ากัน
วิธีแก้ไข:
- ลบ
node_modulesและติดตั้งใหม่ด้วยnpm ci - จับคู่รันไทม์กับเอกสารโครงการ (
.nvmrc,pyproject.toml,runtime.txt) - อย่าผสมตัวจัดการแพ็คเกจ เว้นแต่ว่าคลังโค้ดจะรองรับ
2) การเชื่อมต่อฐานข้อมูลถูกปฏิเสธ
สาเหตุ: บริการฐานข้อมูลหยุดทำงาน หรือ DATABASE_URL ผิดพลาด
วิธีแก้ไข:
- ยืนยันสถานะบริการ (
systemctl status postgresql,brew services list) - ตรวจสอบโฮสต์/พอร์ต/ผู้ใช้/รหัสผ่าน/ชื่อฐานข้อมูล
- ทดสอบการเชื่อมต่อแยกต่างหากด้วย
psql
3) พอร์ตกำลังถูกใช้งานอยู่
วิธีแก้ไข: ค้นหาและหยุดกระบวนการที่ขัดแย้งกัน
macOS/Linux:
bash lsof -i :3000 kill -9
Windows:
powershell netstat -ano | findstr :3000 taskkill /PID /F
4) ปฏิเสธการเข้าถึงบน Linux/macOS
สาเหตุ: สคริปต์ไม่มีสิทธิ์ในการเรียกใช้งาน
bash chmod +x ./scripts/*.sh
หลีกเลี่ยงการเรียกใช้คำสั่งแอปด้วย sudo เว้นแต่จำเป็นอย่างยิ่ง
5) ไม่ได้โหลดตัวแปรสภาพแวดล้อม
วิธีแก้ไข:
- ตรวจสอบให้แน่ใจว่า
.envอยู่ในไดเรกทอรีรูทของโครงการ - รีสตาร์ทกระบวนการหลังจากเปลี่ยน
.env - ตรวจสอบว่าแพ็คเกจโหลด (
dotenv) ได้รับการเริ่มต้นตั้งแต่เนิ่นๆ
รายการตรวจสอบหลังการติดตั้งเพื่อเพิ่มความปลอดภัย
เมื่อ OpenClaw เริ่มทำงานสำเร็จแล้ว ให้ดำเนินการเหล่านี้ก่อนที่จะแชร์กับเพื่อนร่วมทีม:
- เปลี่ยนรหัสลับเริ่มต้น
- บังคับใช้โทเค็น API ที่รัดกุม
- จำกัด CORS และ URL สำหรับการเรียกกลับ
- ตั้งค่าระดับการบันทึกที่ปลอดภัยสำหรับการใช้งานจริง
- เพิ่ม Health/Readiness Probes
- กำหนดค่ากลยุทธ์การสำรองข้อมูลสำหรับวอลุ่ม DB
หากคุณเปิดเผยออกไปนอก localhost ให้วางไว้หลัง Reverse Proxy (Nginx/Caddy) ที่มี TLS
ตรวจสอบและทดสอบ OpenClaw API อย่างรวดเร็ว
หลังการติดตั้ง คุณควรตรวจสอบพฤติกรรมของปลายทาง ไม่ใช่แค่การเริ่มต้นกระบวนการเท่านั้น
รูปแบบที่รวดเร็ว:
- นำเข้าไฟล์ OpenAPI ของ OpenClaw (หากมีให้)
- สร้างตัวแปรสภาพแวดล้อมสำหรับ URL โลคอล/staging
- สร้างการตรวจสอบการถดถอยสำหรับการตรวจสอบสิทธิ์, CRUD และปลายทาง webhook
นี่คือจุดที่ Apidog ช่วยลดความยุ่งยาก คุณสามารถออกแบบ, ดีบัก, ทดสอบ และจัดทำเอกสาร API ในพื้นที่ทำงานเดียว เพื่อให้การตรวจสอบการตั้งค่าไม่กระจายไปในเครื่องมือหลายตัว
เวิร์กโฟลว์ที่ใช้งานได้จริงใน Apidog:
- นำเข้า Schema และสร้างคอลเล็กชันคำขอ
- เพิ่มการทดสอบอัตโนมัติด้วยการยืนยันตามสถานการณ์
- จำลองการพึ่งพาที่ขาดหายไปด้วยการตอบสนองแบบไดนามิก
- แบ่งปันเอกสารแบบอินเทอร์แอคทีฟกับทีมของคุณเมื่อมีความเสถียร
หากคุณกำลังทดสอบฟอร์กของ OpenClaw ที่มีการเปลี่ยนแปลงบ่อยครั้ง เวิร์กโฟลว์เดียวจะเร็วกว่าการดูแลสคริปต์ด้วยตนเองบวกกับเอกสารแยกต่างหาก
กลยุทธ์การอัปเกรดสำหรับฟอร์กของ OpenClaw
ฟอร์กโอเพนซอร์สของบอท/เครื่องมือมีการพัฒนาอย่างรวดเร็ว ใช้เส้นทางการอัปเดตที่ทำซ้ำได้:
bash git fetch origin git checkout main git pull npm ci npm run migrate npm test npm run dev
สำหรับการสร้างด้วย Python:
bash pip install -r requirements.txt python manage.py migrate pytest
ใช้การทดสอบแบบ Branch-based ก่อนที่จะรวมการเปลี่ยนแปลงจาก Upstream หากทีมของคุณใช้สัญญา API การตรวจสอบความแตกต่างของ Schema จะช่วยป้องกันการเปลี่ยนแปลงที่ทำให้เกิดการหยุดทำงานโดยไม่รู้ตัว
ความคิดสุดท้าย
การติดตั้ง OpenClaw (Moltbot/Clawdbot) บน macOS, Windows หรือ Linux ทำได้ง่ายเมื่อคุณควบคุมตัวแปรสามอย่าง: เวอร์ชันรันไทม์, การกำหนดค่าสภาพแวดล้อม และ การพึ่งพาบริการ
หากคุณกำลังติดตั้งสำหรับทีม Docker Compose มักเป็นพื้นฐานที่น่าเชื่อถือที่สุด หากคุณกำลังติดตั้งเพื่อการพัฒนาในเครื่อง การตั้งค่าแบบ Native ก็ใช้ได้ — เพียงกำหนดเวอร์ชันและคอมมิตสคริปต์การเริ่มต้น
เมื่อ OpenClaw ทำงานแล้ว ให้ถือว่าการตรวจสอบ API เป็นส่วนหนึ่งของการติดตั้งที่ทำได้อย่างถูกต้อง คุณสามารถนำเข้าและทดสอบปลายทางใน Apidog สร้างการตรวจสอบอัตโนมัติ และซิงค์เอกสารประกอบในขณะที่ฟอร์กของคุณพัฒนาไป
ทดลองใช้ฟรี — ไม่ต้องใช้บัตรเครดิต — และใช้เพื่อล็อกเวิร์กโฟลว์ OpenClaw API ของคุณตั้งแต่การบูตครั้งแรกไปจนถึงการทดสอบการถดถอย