Trong quá trình sử dụng OPenClaw, dù là lỗi gọi API hay tài khoản bị chặn đăng nhập, đều có thể khiến công việc gián đoạn. Bài viết này tổng hợp các loại lỗi phổ biến nhất cùng giải pháp cụ thể, giúp bạn nhanh chóng khôi phục hoạt động bình thường, tránh lãng phí thời gian xử lý lặp đi lặp lại.
Lỗi gọi API: Xử lý mã 403, 429, 500
Phản hồi 403 từ API thường báo hiệu thiếu quyền truy cập, nguyên nhân phổ biến nhất là khóa API chưa được cấu hình đúng hoặc đã hết hạn. Hãy kiểm tra xem khóa API đã được kích hoạt trong bảng cài đặt chưa, đồng thời xác nhận danh sách IP trắng không hạn chế mạng hiện tại của bạn. Mã 429 có nghĩa là bạn đã gửi quá nhiều yêu cầu, vượt quá giới hạn tần suất – cần đợi ít nhất 60 giây rồi thử lại, hoặc giảm tần suất gửi yêu cầu. Mã 500 là lỗi máy chủ nội bộ, thường do sự cố tạm thời; chỉ cần đợi vài phút rồi gọi lại là sẽ hết. Nếu mã 500 xuất hiện liên tục, nên liên hệ bộ phận hỗ trợ để kiểm tra trạng thái dịch vụ.
Đăng nhập thất bại: Sai mật khẩu và tài khoản bị khóa
Khi quên mật khẩu, bạn có thể đặt lại qua đường dẫn “Quên mật khẩu” gửi đến email đăng ký. Nếu nhận được thông báo “Tài khoản đã bị khóa”, nguyên nhân thường là do nhập sai mật khẩu nhiều lần, kích hoạt cơ chế bảo vệ an toàn. Hãy đợi 15 phút để tài khoản tự động mở khóa, hoặc liên hệ với bộ phận hỗ trợ chính thức để được mở khóa thủ công. Ngoài ra, một số người dùng sử dụng proxy khiến IP bất thường, bị hệ thống đánh giá là rủi ro – nên tắt proxy hoặc chuyển sang môi trường mạng thường dùng rồi thử lại.
