คู่มือจัดการข้อผิดพลาด OpenClaw: รหัสข้อผิดพลาด API และปัญหาเชื่อมต่อพร็อกซี

เจอข้อผิดพลาด API หรือเชื่อมต่อพร็อกซีไม่ได้ขณะใช้ OpenClaw? อย่ารีบติดตั้งใหม่ คู่มือนี้รวบรวมรหัสข้อผิดพลาดที่พบบ่อยและวิธีแก้ไข ช่วยคุณระบุปัญหาได้รวดเร็วและทำให้เครื่องมือกลับมาใช้งานได้ปกติ

1. ข้อผิดพลาดคำขอ API: สาเหตุทั่วไปของรหัส 401 และ 403

เมื่อ OpenClaw เรียก API แล้วได้รับ 401 Unauthorized มักเกิดจากคีย์หมดอายุหรือสิทธิ์ไม่เพียงพอ ตรวจสอบในคอนโซลว่า API Key หมดอายุแล้วหรือไม่ หรืออาจ绑定บัญชีผิด

ส่วน 403 Forbidden มักเกิดจาก IP ถูกขึ้นบัญชีดำหรือข้อจำกัดตามภูมิภาค ลองเปลี่ยนโหนดหรือเปลี่ยน IP 出口ของพร็อกซี หากจำเป็นให้ยกเลิกการตั้งค่าจำกัดการเข้าถึงบัญชี

2. การเชื่อมต่อพร็อกซีล้มเหลว: ปัญหา Network Timeout และ DNS

หากการเชื่อมต่อพร็อกซีแสดง "Connection Timeout" หรือ "ไม่สามารถสร้างการเชื่อมต่อที่ปลอดภัย" ให้ตรวจสอบก่อนว่าเครือข่ายในเครื่องทำงานปกติ จากนั้นตรวจสอบว่าพอร์ตพร็อกซีของ OpenClaw ถูกโปรแกรมอื่นใช้งานอยู่หรือไม่

เมื่อพบข้อผิดพลาด DNS ให้เปลี่ยน DNS ของระบบเป็น 8.8.8.8 หรือ 114.114.114.114 ด้วยตนเอง หากยังหมดเวลาแนะนำให้ปิดไฟร์วอลล์หรือเพิ่ม OpenClaw เป็นโปรแกรมในรายการยกเว้น

3. การจัดการบัญชีถูกล็อกและข้อผิดพลาดเกี่ยวกับการยืนยันตัวตน

การป้อนรหัสผ่านผิดหลายครั้งหรือเข้าสู่ระบบจากสถานที่ผิดปกติอาจทำให้บัญชีถูกล็อกชั่วคราว รอประมาณ 15-30 นาทีระบบจะปลดล็อกอัตโนมัติ หากยังคงได้รับข้อความ "Account Locked" ให้กู้คืนรหัสผ่านผ่านอีเมลที่ลงทะเบียนเพื่อเปิดใช้งานอีกครั้ง

เมื่อโทเค็นยืนยันตัวตนหมดอายุ ให้เข้าสู่ระบบใหม่ในไคลเอนต์ OpenClaw และสร้าง Session Token ใหม่ ระวังอย่าเข้าสู่ระบบพร้อมกันหลายอุปกรณ์เพื่อหลีกเลี่ยงความขัดแย้ง

4. ข้อผิดพลาดไฟล์คอนฟิก: การแยกวิเคราะห์ล้มเหลวและพารามิเตอร์ไม่ถูกต้อง

เมื่อโหลดไฟล์คอนฟิกที่กำหนดเองแล้วได้รับ "Parse Error" มักเกิดจากข้อผิดพลาดการเยื้องในรูปแบบ YAML ใช้เครื่องมือตรวจสอบ YAML ออนไลน์เพื่อให้แน่ใจว่าคีย์เรียงตรงกันและไม่มีช่องว่างเกิน

ข้อผิดพลาดพารามิเตอร์เช่น "Invalid Proxy Address" ให้ตรวจสอบที่อยู่เซิร์ฟเวอร์พร็อกซี พอร์ต และโปรโตคอลที่กรอกว่าตรงกับเอกสารทางการหรือไม่ หลังจากแก้ไขให้บันทึกและโหลดคอนฟิกอีกครั้ง

5. ยังแก้ไม่ได้? รวบรวมล็อกเพื่อตรวจสอบด้วยตนเอง

หากลองทุกวิธีแล้วปัญหายังคงอยู่ ให้เปิดฟังก์ชันบันทึกของ OpenClaw และส่งออกล็อก debug ในช่วง 24 ชั่วโมงล่าสุด ให้เน้นที่รายการ ERROR สีแดงใกล้กับ timestamp ที่เกิดข้อผิดพลาด

ส่งภาพหน้าจอล็อกหรือเนื้อหาไปยังฝ่ายสนับสนุนอย่างเป็นทางการ พร้อมระบุเวอร์ชันระบบปฏิบัติการและสภาพแวดล้อมเครือข่ายของคุณ โดยปกติพวกเขาจะให้แนวทางแก้ไขเฉพาะภายใน 1-2 วันทำการ