Gặp lỗi kết nối hoặc timeout khi sử dụng OpenClaw? Bài viết này tổng hợp các mã lỗi OpenClaw thường gặp và cách sửa, giúp bạn khôi phục dịch vụ nhanh chóng. Dù là lỗi API hay lỗi client, chỉ cần làm theo các bước là có thể giải quyết.
Lỗi liên quan đến xác thực và quyền hạn
Mã lỗi 401 hoặc 403 thường cho thấy khóa API không hợp lệ hoặc thiếu quyền truy cập. Trước tiên hãy kiểm tra xem API Key đã được sao chép chính xác chưa, đảm bảo bao gồm đầy đủ ký tự và không có khoảng trắng thừa. Nếu khóa vẫn còn trong thời hạn hiệu lực, hãy thử tạo lại trong bảng điều khiển OpenClaw và cập nhật vào tệp cấu hình.
Một số người dùng gặp thông báo "Rate Limit Exceeded" cho thấy tần suất yêu cầu vượt quá giới hạn của phiên bản miễn phí. Giải pháp là giảm khoảng thời gian gọi, hoặc nâng hạn mức trong phiên bản trả phí. Có thể xem lượng sử dụng hiện tại qua bảng điều khiển chính thức và lập kế hoạch nhịp độ yêu cầu hợp lý.
Lỗi kết nối và mạng
Mã lỗi 500 hoặc 503 đại diện cho lỗi tạm thời từ phía máy chủ. Khuyên bạn nên đợi 5 phút rồi thử lại, đồng thời kiểm tra xem mạng cục bộ có thể truy cập trang web OpenClaw bình thường không. Nếu thường xuyên xuất hiện lỗi "Connection Timeout", hãy thử chuyển đổi DNS hoặc sử dụng proxy node.
Đối với lỗi "SSL Handshake Failed", cần cập nhật chứng chỉ gốc của hệ thống hoặc tắt tính năng chặn của tường lửa. Người dùng Windows có thể chạy "certmgr.msc" để nhập chứng chỉ mới nhất, người dùng Mac sửa qua Keychain. Lưu ý không tùy tiện sửa đổi quy tắc xác thực SSL để tránh giảm mức bảo mật.
