Mã lỗi OpenClaw thường gặp và cách khắc phục

Gặp lỗi khi dùng OpenClaw đừng vội lo, bài viết này tổng hợp nguyên nhân và các bước xử lý cho một số mã lỗi phổ biến, giúp bạn nhanh chóng khôi phục hoạt động bình thường. Dù bạn mới bắt đầu hay là người dùng lâu năm, hướng dẫn kiểm tra này đều hữu ích.

Mã lỗi E1003: Kết nối mạng quá thời gian chờ

Lỗi này thường xuất hiện khi bạn liên kết lần đầu hoặc chuyển đổi node, nguyên nhân là do môi trường mạng cục bộ không ổn định hoặc xung đột cổng giữa công cụ proxy và OpenClaw. Hãy tắt các phần mềm proxy khác trước, sau đó kiểm tra xem tường lửa hệ thống đã cho phép cổng giao tiếp của OpenClaw chưa. Nếu vẫn gặp vấn đề, thử đổi DNS thành 8.8.8.8 hoặc khởi động lại router để nhận IP mới.

Ngoài ra, một số mạng nội bộ trường học hoặc doanh nghiệp có thể chặn các cổng không tiêu chuẩn. Lúc này, bạn cần bật tính năng "Tối ưu định tuyến tự động" trong cài đặt OpenClaw, hệ thống sẽ tự động chuyển sang node dự phòng ổn định hơn.

Mã lỗi A2001: Xác thực tài khoản thất bại

Khi thấy A2001, nghĩa là có vấn đề với thông tin đăng nhập hoặc liên kết thiết bị. Nguyên nhân phổ biến là mật khẩu đã thay đổi nhưng chưa đồng bộ trong ứng dụng OpenClaw, hoặc tài khoản bị đẩy ra do thiết bị khác đăng nhập. Cách xử lý: trước tiên hãy truy cập trang chính thức để kiểm tra trạng thái tài khoản, xác nhận không có lịch sử đăng nhập bất thường. Sau đó nhập lại tên đăng nhập và mật khẩu trong ứng dụng, đồng thời tick chọn "Giữ trạng thái đăng nhập" để tạo token cục bộ mới.

Nếu vẫn báo lỗi, có thể thiết bị đã đạt giới hạn liên kết. Gói gia đình của OpenClaw cho phép tối đa 5 thiết bị trực tuyến cùng lúc, gói cá nhân là 3 thiết bị. Bạn có thể vào trang "Quản lý thiết bị" để hủy liên kết các thiết bị cũ không dùng, sau đó thử đăng nhập lại.

Mã lỗi B5008: Yêu cầu dịch vụ quá thường xuyên

Lỗi này cho biết bạn đã gửi quá nhiều yêu cầu trong thời gian ngắn, kích hoạt cơ chế giới hạn lưu lượng của OpenClaw. Thường gặp khi chạy script thao tác hàng loạt hoặc nhấp nút đăng ký liên tục. Cách xử lý đơn giản: dừng mọi thao tác, đợi 15-30 phút để hệ thống tự động gỡ giới hạn. Trong thời gian này không nên thử lại, nếu không thời gian khóa sẽ kéo dài.

Nếu bạn sử dụng thủ công bình thường mà vẫn gặp lỗi thường xuyên, hãy kiểm tra xem có plugin hoặc tiện ích mở rộng trình duyệt nào đang ngầm gọi API không. Tắt các tiện ích không cần thiết và khởi động lại ứng dụng, thường sẽ hoạt động trở lại.

Mã lỗi C7002: Xác minh gói cập nhật thất bại

Khi nâng cấp ứng dụng OpenClaw tự động hoặc thủ công, đôi khi gặp lỗi C7002, nguyên nhân là do gói cài đặt tải về không khớp với chữ ký chính thức. Tuyệt đối không tải file cập nhật từ các nguồn không chính thức, vì có thể tiềm ẩn rủi ro bảo mật. Cách xử lý đúng: gỡ cài đặt phiên bản hiện tại, sau đó vào trang chính thức của OpenClaw tải gói cài đặt mới nhất, và tạm tắt phần mềm diệt virus trước khi cài đặt.

Nếu hệ thống của bạn bật UAC (User Account Control), hãy chạy trình cài đặt với quyền quản trị viên. Khi khởi động lần đầu sau cài đặt, nếu xuất hiện thông báo "Không thể xác minh nhà phát hành", hãy chọn "Vẫn chạy" – đây là hiện tượng bình thường do chứng chỉ chưa được bộ nhớ đệm hệ thống nhận diện.