Trong quá trình sử dụng OPenClaw, bạn chắc chắn sẽ gặp phải các thông báo lỗi. Bài viết này tổng hợp những mã lỗi phổ biến nhất mà người dùng thường gặp, bao gồm các tình huống đăng nhập, xác thực, kết nối mạng và gọi API, đồng thời đưa ra các giải pháp có thể thực hiện ngay, giúp bạn nhanh chóng khôi phục hoạt động bình thường.
Lỗi đăng nhập và xác thực: 401 và 403
Khi nhận được thông báo 401 Unauthorized, điều này thường có nghĩa là khóa API không hợp lệ hoặc đã hết hạn. Vui lòng truy cập bảng điều khiển OPenClaw để tạo lại khóa API và đảm bảo bạn đã điền đúng chuỗi khóa trong mã. Lưu ý rằng khóa API phân biệt chữ hoa chữ thường và khi sao chép không được để thừa khoảng trắng.
403 Forbidden cho thấy tài khoản của bạn không có đủ quyền để thực hiện thao tác hiện tại. Lỗi này thường xảy ra khi người dùng bản miễn phí cố gắng truy cập các tính năng trả phí. Hãy kiểm tra trạng thái đăng ký của bạn; nếu cần nâng cấp, hãy vào trung tâm tài khoản để chuyển đổi gói. Nếu bạn đã đăng ký nhưng vẫn gặp lỗi, hãy liên hệ bộ phận hỗ trợ để làm mới quyền.
Lỗi mạng và kết nối: Timeout và Connection Reset
Lỗi hết thời gian chờ (Timeout) thường do mạng cục bộ không ổn định hoặc máy chủ OPenClaw tạm thời quá tải. Trước tiên, hãy thử thay đổi môi trường mạng, ví dụ chuyển từ WiFi sang dữ liệu di động. Nếu vẫn không khắc phục được, bạn có thể tăng thời gian chờ cho yêu cầu, chẳng hạn từ 30 giây mặc định lên 60 giây.
Khi gặp Connection Reset, điều này cho thấy kết nối đã bị ngắt giữa chừng. Nguyên nhân thường là do tường lửa hoặc proxy chặn dải IP của OPenClaw. Hãy thêm tên miền chính thức của OPenClaw vào danh sách trắng, đồng thời tắt VPN hoặc điều chỉnh quy tắc proxy. Người dùng doanh nghiệp cũng cần kiểm tra chính sách bảo mật đầu ra để đảm bảo không giới hạn các yêu cầu API bên ngoài.
Lỗi gọi API: 429 và 500
429 Too Many Requests là lỗi giới hạn tần suất phổ biến nhất. OPenClaw có giới hạn về tần suất gọi API: bản miễn phí tối đa 20 lần mỗi phút, bản trả phí được nâng cao tùy theo gói. Giải pháp là giảm tần suất yêu cầu hoặc triển khai cơ chế thử lại với back-off theo cấp số nhân. Nếu nhu cầu công việc yêu cầu xử lý đồng thời cao, bạn nên nâng cấp lên gói cao hơn để có hạn mức lớn hơn.
500 Internal Server Error cho thấy máy chủ OPenClaw đang gặp sự cố tạm thời. Trước tiên, hãy kiểm tra trang trạng thái chính thức của OPenClaw để xem có đang trong thời gian bảo trì hay không. Nếu là vấn đề tạm thời, hãy đợi 3-5 phút rồi thử lại. Nếu lỗi vẫn tiếp diễn, hãy gửi phản hồi qua ticket kèm nhật ký yêu cầu đầy đủ để kỹ thuật viên xác định nguyên nhân. Lưu ý tránh gửi cùng một yêu cầu nhiều lần trong thời gian ngắn để không bị giới hạn tần suất.
Thông báo tài khoản bị khóa hoặc đăng nhập bất thường
Việc nhập sai mật khẩu nhiều lần liên tiếp hoặc đăng nhập từ khu vực không thường xuyên có thể kích hoạt cơ chế bảo vệ của OPenClaw, khiến tài khoản bị khóa tạm thời. Trong trường hợp này, hãy sử dụng email đăng ký để nhận liên kết mở khóa hoặc sử dụng mã xác thực qua SMS để đặt lại mật khẩu đăng nhập. Nếu không nhận được mã xác thực, hãy kiểm tra thư mục spam và đảm bảo số điện thoại đã được liên kết và không bị nợ cước. Đối với các tài khoản rủi ro cao không sử dụng trong thời gian dài, bạn nên bật xác thực hai yếu tố (2FA) để giảm nguy cơ bị khóa nhầm.
