เจอ API Call ล้มเหลวหรือ Connection Timeout ขณะใช้ OPenClaw? บทความนี้รวบรวมแนวทางการตรวจสอบและวิธีแก้ไขข้อผิดพลาดที่พบบ่อย ช่วยให้คุณกลับมาทำงานได้เร็วขึ้น โดยไม่ต้องมานั่งมองหน้าจอ Error
API 401 Unauthorized Error: ตรวจสอบ Key และสิทธิ์
การได้รับ Error 401 มักหมายถึงคำขอไม่มีข้อมูล Credential ที่ถูกต้อง ก่อนอื่นให้ตรวจสอบว่า API Key ของคุณถูกวางลงใน Environment Variable หรือไฟล์ Config อย่างถูกต้องหรือไม่ ระวังอย่าให้มีช่องว่างหรือขึ้นบรรทัดใหม่เกินความจำเป็น หากคุณคัดลอก Key จาก Console แล้ววางโดยตรง แนะนำให้พิมพ์ใหม่ด้วยตนเอง — ปัญหาส่วนใหญ่มักเกิดจากการคัดลอกตัวอักษรหลุด นอกจากนี้ Model หรือ Endpoint บางตัวจำเป็นต้องเปิดสิทธิ์เพิ่มเติม ให้ไปที่ Developer Console เพื่อยืนยันว่าได้ติ๊ก "อนุญาตการเข้าถึง" ไว้แล้ว
429 Rate Limit: ปรับช่วงเวลาการเรียกและโควต้า
การส่งคำขอจำนวนมากในเวลาสั้น ๆ จะทำให้ถูกจำกัด Rate ส่งผลให้ได้รับ Code 429 อย่ารีบ Retry โดยไม่คิด ให้หยุดก่อน 5-10 วินาที แล้วใช้กลยุทธ์ Exponential Backoff เพื่อเริ่มต้นใหม่ คุณสามารถตั้งค่า Request Queue หรือเพิ่ม Sleep Mechanism เพื่อหลีกเลี่ยงการเกิน Rate Limit หากเกิดบ่อยครั้ง ให้ตรวจสอบว่าบัญชีอยู่ในช่วงทดลองใช้หรือไม่ (โควต้าช่วงทดลองมักต่ำกว่า) การอัปเกรดแพ็กเกจหรือขอเพิ่มโควต้าจะแก้ปัญหาได้ที่ต้นตอ นอกจากนี้ ให้ยืนยันว่าแอปพลิเคชันอื่นกำลังใช้ API Key เดียวกันอยู่หรือไม่ — การใช้ Key ร่วมกันทำให้โดน Limit ได้ง่ายมาก
Connection Timeout หรือ Socket Hang Up: เช็คเครือข่ายและ Proxy
"Connection Timeout" หรือ "Socket Hang Up" ส่วนใหญ่เกิดจากเครือข่ายไม่เสถียรหรือตั้งค่า Proxy ไม่ถูกต้อง ลองเชื่อมต่อตรงไปยังเซิร์ฟเวอร์หลักของ OPenClaw โดยใช้คำสั่ง ping หรือ curl เพื่อทดสอบ Latency หากใช้ Proxy ให้ยืนยันว่า Protocol และ Port ถูกต้อง และ Proxy ไม่ได้บล็อก Traffic เครือข่ายภายในองค์กรบางแห่งอาจปิดกั้น Port ที่ไม่ได้มาตรฐาน ให้ลองใช้ Port HTTPS (443) เพื่อเลี่ยงข้อจำกัด นอกจากนี้ การตั้งค่า Timeout สั้นเกินไปก็ทำให้เกิด Error ปลอมได้ ลองปรับ Timeout Parameter จากค่าเริ่มต้น 10 วินาที เป็น 30 วินาที
500 Internal Server Error: ตรวจสอบรูปแบบ Request Body ก่อน
เมื่อเซิร์ฟเวอร์ส่ง Error 500 กลับมา อย่าคิดว่าเซิร์ฟเวอร์ล่มทันที — ส่วนใหญ่เกิดจากรูปแบบ Request ที่คุณส่งไม่ถูกต้อง ตรวจสอบว่า JSON ถูกต้องหรือไม่ ชื่อ Field สะกดถูกต้องหรือไม่ (เช่น "model" เขียนเป็น "module") โดยเฉพาะ Boolean และ Number ต้องไม่มีเครื่องหมายคำพูดครอบ เช่น "temperature": true จะทำให้ระบบพังทันที หาก Request Body มีขนาดใหญ่ ให้ลองแบ่งส่งเป็นชิ้นเล็ก ๆ หรือตรวจสอบว่า Message Array มี Role ที่ไม่รองรับหรือไม่ (เช่น เผลอใช้ Role "function" แต่ Model ไม่รองรับ)
403 Forbidden: สถานะบัญชีและข้อจำกัดทางภูมิภาค
Error 403 อาจเกิดจากบัญชีถูกล็อกหรือข้อจำกัดทางภูมิภาค ให้เข้าสู่ระบบเว็บไซต์หลักของ OPenClaw เพื่อตรวจสอบสถานะบัญชี ดูว่ามีการค้างชำระหรือคำเตือนละเมิดข้อกำหนดหรือไม่ Model บางตัวเปิดให้บริการเฉพาะบางภูมิภาค หากคุณใช้ IP จากพื้นที่ที่ไม่รองรับ ให้ลองเปลี่ยนโหนดหรือใช้โหมด Global นอกจากนี้ บัญชีทดลองใช้ฟรีบางประเภทอาจมีสิทธิ์เข้าถึงลดลงเมื่อเวลาผ่านไป การต่ออายุหรืออัปเกรดเป็นแผนเสียเงินมักจะช่วยยกเลิก Error 403 ได้
