รวมปัญหาที่คนในชุมชน OpenClaw Thailand รายงานบ่อยที่สุด พร้อม วิธีแก้ทีละขั้นตอน ลองตัวเลือกจากบนลงล่างก่อน
🔧 ปัญหาการติดตั้ง
⚠ command not found: openclaw
- 1.ปิด terminal แล้วเปิดใหม่
- 2.รัน: source ~/.bashrc หรือ source ~/.zshrc
- 3.ตรวจสอบว่า npm global path อยู่ใน PATH: npm config get prefix
- 4.เพิ่ม export PATH=$PATH:$(npm config get prefix)/bin ใน ~/.bashrc
- 5.ถ้ายังไม่ได้ ลองติดตั้งใหม่ด้วย sudo: sudo npm install -g openclaw@latest
⚠ Permission denied / EACCES error
- 1.macOS/Linux: อย่าใช้ sudo กับ npm install แนะนำใช้ nvm แทน
- 2.ติดตั้ง nvm: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
- 3.รัน: nvm install --lts && nvm use --lts
- 4.แล้วติดตั้ง openclaw ใหม่: npm install -g openclaw@latest
⚠ Windows: Installer script ไม่ทำงาน
- 1.ตรวจสอบว่าเปิด PowerShell ในโหมด Administrator
- 2.ตั้งค่า execution policy: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
- 3.ลองรัน installer อีกครั้ง: irm https://openclaw.ai/install.ps1 | iex
- 4.ถ้ายังไม่ได้ แนะนำใช้ WSL2 แทน
🌐 Gateway / Daemon ปัญหา
⚠ Gateway not running / Connection refused
- 1.รัน: openclaw gateway status
- 2.ถ้า stopped: openclaw gateway start
- 3.ถ้ายังไม่ได้: openclaw gateway restart
- 4.ตรวจสอบ log: openclaw gateway logs
openclaw gateway start
openclaw gateway status⚠ Port already in use
- 1.ตรวจสอบ port ที่ใช้: openclaw config get gateway.port
- 2.ฆ่า process ที่ใช้ port นั้น (macOS/Linux): lsof -ti:PORT | xargs kill -9
- 3.หรือเปลี่ยน port: openclaw config set gateway.port 3001
- 4.Restart gateway: openclaw gateway restart
🔑 Model / API Key ปัญหา
⚠ Invalid API Key / Authentication error
- 1.ตรวจสอบ key ว่า copy ครบ ไม่มี space หน้าหลัง
- 2.ตรวจสอบว่า key ถูก provider: Claude key ขึ้นต้น sk-ant-, OpenAI ขึ้นต้น sk-
- 3.ตั้งค่า key ใหม่: openclaw config set anthropic.apiKey YOUR_KEY
- 4.ตรวจสอบว่ามี credit เหลือในบัญชี provider
⚠ Rate limit / Too many requests
- 1.รอ 1-2 นาทีแล้วลองใหม่
- 2.ใช้ model ที่ถูกกว่า เช่น Claude Haiku แทน Sonnet
- 3.ตรวจสอบ usage limit ในบัญชี provider
- 4.พิจารณา upgrade tier ของ API
🌍 Browser Automation ปัญหา
⚠ Browser ไม่เปิดหรือ timeout
- 1.ตรวจสอบว่าติดตั้ง Chrome/Chromium แล้ว
- 2.เปิด remote debugging ด้วย: google-chrome --remote-debugging-port=9222
- 3.หรือ: openclaw browser launch
- 4.ตรวจสอบด้วย: openclaw browser status
คำสั่ง Diagnostic ที่ควรรู้
openclaw doctor # ตรวจสอบ config ทั้งหมด
openclaw --version # ดู version
openclaw gateway status # สถานะ gateway
openclaw config list # ดู config ทั้งหมดยังแก้ไม่ได้?
ถามในชุมชน ระบุ OS, version, และ error message ให้ครบ
