OPenClaw là cổng AI mã nguồn mở, khi sử dụng thường gặp lỗi HTTP khiến người mới đau đầu. Bài viết này tập trung vào hai mã lỗi phổ biến 403 và 429, giúp bạn nhanh chóng xác định vấn đề và khôi phục cuộc gọi API.
Lỗi 403 – Truy cập bị từ chối: Quyền hạn khóa API và giới hạn IP
Khi nhận lỗi 403, trước tiên hãy kiểm tra xem khóa API đã hết hạn hay chưa được kích hoạt. Trong bảng điều khiển OPenClaw, bạn có thể tạo lại khóa, nhớ sao chép và cập nhật ngay vào tệp cấu hình. Ngoài ra, một số nhà cung cấp mô hình có danh sách trắng IP nguồn – nếu VPS hoặc IP proxy bạn dùng không nằm trong danh sách cho phép, bạn cũng sẽ nhận mã 403. Đăng nhập vào trang quản trị, kiểm tra mục "Cho phép IP", thêm IP xuất hiện hiện tại để gỡ chặn. Một trường hợp khác là sau khi dùng hết hạn mức miễn phí, bạn tiếp tục gửi yêu cầu – tài khoản sẽ bị giới hạn tạm thời, lúc này cần nạp tiền hoặc chuyển sang gói trả phí.
Lỗi 429 – Quá nhiều yêu cầu: Hạn mức tốc độ và chiến lược thử lại
Mã 429 cho biết bạn đã gửi quá nhiều yêu cầu trong thời gian ngắn, vượt ngưỡng tốc độ mà OPenClaw đặt ra. Giải pháp đơn giản: tạm dừng gửi, đợi vài chục giây rồi thử lại. Cách triệt để hơn là thêm logic thử lại với exponential backoff vào mã, ví dụ sau mỗi lần thất bại, chờ 2 giây, 4 giây, 8 giây và tăng dần. Đồng thời kiểm tra gói API của bạn – các gói khác nhau của OPenClaw có giới hạn số yêu cầu mỗi phút (RPM) khác nhau, nâng cấp gói sẽ được hạn mức cao hơn. Nếu dùng khóa chia sẻ, đừng chạy song song quá nhiều yêu cầu với người khác, tốt nhất hãy yêu cầu một khóa API riêng.
Các mã lỗi phổ biến khác: 500 và 502
Thỉnh thoảng bạn gặp lỗi 500 (lỗi máy chủ nội bộ) hoặc 502 (cổng vào quá thời gian) – thường là do backend OPenClaw hoặc nhà cung cấp thượng nguồn gặp vấn đề. Hãy chờ 5 phút rồi thử lại, nếu vẫn xuất hiện, hãy phản hồi trên GitHub Issues hoặc kênh Discord chính thức. Theo dõi trang trạng thái (status.openclaw.com) để xem có thông báo gián đoạn dịch vụ không. Khi debug cục bộ, nên bật log chi tiết – giúp bạn nhanh chóng xác định vấn đề là do cấu hình hay phía máy chủ. Tạo thói quen cập nhật image OPenClaw thường xuyên, vì các phiên bản cũ có bug đã biết cũng có thể gây ra những lỗi này.
