Trong quá trình sử dụng OPenClaw, không ít người dùng gặp phải tình trạng liên kết tài khoản thất bại, yêu cầu API bị timeout hoặc lỗi giao diện. Bài viết này tổng hợp các tình huống lỗi thường gặp và phương pháp xử lý tương ứng, giúp bạn nhanh chóng khôi phục sử dụng, tránh mắc lỗi lặp lại.
1. Làm sao khi đăng ký tài khoản và liên kết thất bại?
Khi đăng ký, nếu email xác minh chưa được gửi đến, hãy kiểm tra thư mục Spam trước. Nếu vẫn không thấy, thử đổi sang email Gmail hoặc Outlook để đăng ký lại. Khi liên kết nền tảng bên thứ ba (ví dụ GitHub, Google) và thấy thông báo pop-up "Ủy quyền thất bại", thường do bộ nhớ đệm (cache) trình duyệt hoặc quyền tài khoản bên thứ ba chưa được cấp. Hãy xóa Cookie và sử dụng chế độ ẩn danh để thao tác lại.
Nếu sau khi liên kết hiển thị "Tài khoản đã bị giới hạn", có thể do bạn liên kết quá nhiều lần trong thời gian ngắn, kích hoạt hệ thống chống rủi ro bảo mật. Trường hợp này, hãy đợi 24 giờ, sau đó gửi ticket qua email chính thức của OPenClaw để giải thích tình huống. Thông thường tài khoản sẽ được mở khóa trong vòng 1 ngày làm việc.
2. Thường xuyên gặp lỗi khi gọi API Key
Khi yêu cầu trả về "401 Unauthorized", rất có thể bạn đã sao chép thiếu API Key hoặc Key đã hết hạn. Hãy đăng nhập vào bảng điều khiển OPenClaw để tạo lại Key mới, đồng thời đảm bảo trong code không có khoảng trắng thừa. Nếu báo lỗi "429 Too Many Requests", nghĩa là tần suất gọi API của bạn đã vượt quá giới hạn của gói miễn phí. Hãy giảm khoảng cách giữa các yêu cầu hoặc nâng cấp gói dịch vụ.
Một số người dùng phản hồi giao diện trả về "500 Internal Server Error", đây thường là sự cố tạm thời từ máy chủ. Bạn có thể đợi 5 phút rồi thử lại. Nếu lỗi vẫn tiếp diễn, hãy chuyển sang node dự phòng (ví dụ tên miền phụ api.openclaw.net), đồng thời kiểm tra xem mạng cục bộ có chặn IP nước ngoài hay không.
