Khi tích hợp API OpenClaw, không ít nhà phát triển gặp phải nhiều lỗi khác nhau. Bài viết này tổng hợp những mã lỗi thường gặp nhất cùng giải pháp, giúp bạn nhanh chóng xác định vấn đề và tránh mắc sai lầm.
Lỗi xác thực: 401 Unauthorized
Nguyên nhân phổ biến nhất gây ra lỗi 401 là khóa API không hợp lệ hoặc đã hết hạn. Hãy kiểm tra bảng điều khiển OpenClaw của bạn, đảm bảo trạng thái khóa là "Active", và xác nhận trường Authorization trong header yêu cầu có định dạng chính xác, ví dụ Bearer your_api_key. Nếu khóa vừa được tạo, bạn có thể cần đợi vài phút hoặc sao chép lại, tránh thừa khoảng trắng.
Yêu cầu hết thời gian: 408 Request Timeout
Thường xuyên gặp lỗi hết thời gian chờ thường liên quan đến môi trường mạng hoặc tải máy chủ. Trước tiên, hãy kiểm tra kết nối từ máy của bạn đến endpoint API OpenClaw, ví dụ dùng lệnh curl. Nếu mạng bình thường, hãy thử giảm giá trị tham số max_tokens trong một lần yêu cầu, hoặc nâng cấp lên gói có hạn ngạch đồng thời cao hơn. Ngoài ra, tránh gửi nhiều yêu cầu ngắn vào giờ cao điểm, nên áp dụng cơ chế thử lại với exponential backoff.
