Hướng dẫn khắc phục lỗi OpenClaw: Mã lỗi API & sự cố kết nối proxy chi tiết

Gặp lỗi API hoặc không kết nối được proxy khi dùng OpenClaw? Đừng vội cài lại. Hướng dẫn này tổng hợp các mã lỗi phổ biến và cách xử lý, giúp bạn nhanh chóng xác định vấn đề và khôi phục công cụ hoạt động bình thường.

1. Lỗi yêu cầu API: Nguyên nhân thường gặp của mã 401 & 403

Khi OpenClaw gọi API trả về mã 401 Unauthorized, thường là do API Key hết hạn hoặc thiếu quyền. Hãy kiểm tra API Key trong bảng điều khiển xem đã hết hạn chưa, hoặc có bị gán nhầm tài khoản không.

Mã 403 Forbidden thường xảy ra do IP bị đưa vào danh sách đen hoặc hạn chế khu vực địa lý. Thử chuyển node, thay đổi IP đầu ra của proxy, nếu cần thì gỡ bỏ cài đặt hạn chế truy cập của tài khoản.

2. Kết nối proxy thất bại: Timeout mạng & lỗi phân giải DNS

Khi kết nối proxy báo "Connection Timeout" hoặc "Không thể thiết lập kết nối an toàn", trước tiên hãy xác nhận mạng cục bộ có ổn không, sau đó kiểm tra xem cổng proxy của OpenClaw có bị ứng dụng khác chiếm dụng không.

Nếu gặp lỗi phân giải DNS, bạn có thể thủ công đổi DNS hệ thống sang 8.8.8.8 hoặc 114.114.114.114. Nếu vẫn timeout, hãy tắt tường lửa hoặc thêm OpenClaw vào danh sách trắng của chương trình tường lửa.

3. Xử lý khóa tài khoản & lỗi xác thực

Nhập sai mật khẩu nhiều lần hoặc đăng nhập từ nơi khác có thể khiến tài khoản bị khóa tạm thời. Chờ 15-30 phút tài khoản sẽ tự động mở khóa. Nếu vẫn báo "Account Locked", cần lấy lại mật khẩu qua email đăng ký để kích hoạt lại.

Khi token xác thực hết hạn, hãy đăng nhập lại trên ứng dụng OpenClaw và tạo Session Token mới. Lưu ý không đăng nhập đồng thời nhiều thiết bị để tránh xung đột.

4. Lỗi file cấu hình: Parse lỗi & sai tham số

Khi tải file cấu hình tùy chỉnh báo "Parse Error", thường do sai thụt lề định dạng YAML. Dùng công cụ kiểm tra YAML online để xác minh, đảm bảo key-value căn chỉnh đều và không có khoảng trắng thừa.

Lỗi tham số như "Invalid Proxy Address", hãy kiểm tra địa chỉ máy chủ proxy, cổng và giao thức đã nhập có khớp với tài liệu chính thức không. Sau khi sửa, lưu lại và tải lại cấu hình là xong.

5. Vẫn không khắc phục được? Thu thập log để tự kiểm tra

Nếu đã thử tất cả các cách trên mà vẫn còn lỗi, hãy bật tính năng ghi log của OpenClaw, xuất log debug trong 24 giờ gần nhất. Tập trung xem các mục ERROR màu đỏ gần mốc thời gian báo lỗi.

Chụp ảnh hoặc copy nội dung log gửi cho bộ phận hỗ trợ chính thức, kèm theo phiên bản hệ điều hành và môi trường mạng của bạn. Họ thường có thể đưa ra giải pháp cụ thể trong vòng 1-2 ngày làm việc.