HƯỚNG DẪN KHẮC PHỤC LỖI "PAIRING REQUIRED / DISCONNECTED (1008)" TRÊN OPENCLAW

Posted Date: March 5, 2026

Giới thiệu

Trong quá trình vận hành hệ thống OpenClaw, người dùng thường gặp phải thông báo lỗi "Disconnected (1008) - Pairing required" khi truy cập vào Control Dashboard hoặc Web UI. Lỗi này thường gây hiểu lầm là hệ thống bị sập, nhưng thực tế đây là một cơ chế bảo mật thiết bị (Device Pairing) của OpenClaw Gateway nhằm đảm bảo chỉ những trình duyệt được quản trị viên phê duyệt mới có quyền điều khiển.

Bài viết này sẽ hướng dẫn bạn chi tiết các bước để xác thực thiết bị và khắc phục triệt để lỗi này.

1. Nguyên nhân gây lỗi

Cơ chế bảo mật của OpenClaw Gateway hoạt động dựa trên việc định danh trình duyệt (Browser Fingerprint).

Yêu cầu xác thực: Mỗi khi một trình duyệt hoặc thiết bị mới truy cập Dashboard, hệ thống sẽ tạo một lệnh chờ (Pairing Request).
Trạng thái chờ: Trong khi chờ Admin phê duyệt trên server, kết nối sẽ bị ngắt và trả về mã lỗi 1008.
Phạm vi: Mỗi trình duyệt (Chrome, Firefox, Safari) trên mỗi thiết bị (PC, Mobile) chỉ cần được phê duyệt một lần duy nhất.

2. Quy trình khắc phục chi tiết

Bước 1: Khởi tạo yêu cầu (Yêu cầu quan trọng)

Khi gặp thông báo lỗi trên Dashboard, bạn KHÔNG ĐƯỢC ĐÓNG TAB.

Lưu ý: Hãy giữ nguyên tab trình duyệt đang báo lỗi. Việc này giúp duy trì phiên làm việc để Gateway có thể ghi nhận yêu cầu kết nối từ thiết bị của bạn.

Bước 2: Kiểm tra danh sách yêu cầu trên Server

Truy cập vào terminal của server đang chạy OpenClaw và thực hiện lệnh sau để lấy mã định danh (Request ID):

openclaw pairing list --channel web

(Hoặc sử dụng lệnh openclaw devices list để kiểm tra tổng quát).

Kết quả trả về sẽ có dạng:

260fc95b-af6e-41a2-8667-7d76c53c3aa3 | Control UI from https://yourdomain.com

Bước 3: Phê duyệt thiết bị (Approve)

Sao chép chuỗi mã ID ở bước trên và chạy lệnh phê duyệt chính thức:

openclaw pairing approve <MÃ_ID_CỦA_BẠN>

Ví dụ: openclaw pairing approve b6172438-67a2-48f2-87b7-7803e4709c58

Bước 4: Kiểm tra kết quả

Sau khi lệnh được thực thi trên server, Dashboard trên trình duyệt của bạn sẽ tự động Reconnect và chuyển sang trạng thái hoạt động bình thường mà không cần tải lại trang.

3. Xử lý các tình huống phát sinh

Vấn đề	Giải pháp xử lý
Không thấy ID trong danh sách	Kiểm tra log thời gian thực: openclaw logs --follow \| grep -i pair. Nếu thấy dòng "New pairing request", hãy chạy lại lệnh ở Bước 2.
Đã Approve nhưng vẫn báo lỗi	Thử nhấn Ctrl + F5 (Hard Reload) để trình duyệt nhận diện lại chứng chỉ xác thực mới.
Gateway không phản hồi	Kiểm tra xem dịch vụ OpenClaw có đang chạy không: systemctl status openclaw.

4. Tóm tắt quy trình nhanh (Quick Fix)

Mở Dashboard và giữ nguyên tab.
Lấy ID: openclaw pairing list --channel web
Xác nhận: openclaw pairing approve <ID>
Hoàn tất: Dashboard sẽ tự động hoạt động.

Kết luận

Lỗi "Pairing Required (1008)" thực chất là một lớp khiên bảo vệ quan trọng của OpenClaw, giúp ngăn chặn các truy cập trái phép vào hệ thống điều khiển của bạn. Chỉ với vài thao tác xác thực đơn giản trên server, bạn đã có thể thiết lập một kết nối an toàn và ổn định cho thiết bị của mình. Hy vọng hướng dẫn này giúp bạn quản lý hệ thống OpenClaw một cách chuyên nghiệp và hiệu quả hơn.

CloudFly đơn vị tiên phong tại Việt Nam cung cấp dịch vụ Cloud Server và Cloud Hosting tùy chỉnh cấu hình

CLOUDFLY tự hào là đơn vị tiên phong tại Việt Nam cung cấp dịch vụ Cloud Server, Cloud Hosting tùy chỉnh cấu hình. Chúng tôi nhận được sự tin tưởng và hợp tác với hơn 15.000 khách hàng trong và ngoài nước. Sẵn sàng đồng hành và đem lại những giải pháp tối ưu nhất cho bạn.

Nếu quý khách hàng gặp khó khăn hay có bất kì thắc mắc nào. Hãy liên hệ theo thông tin bên dưới.

CloudFly - Đơn giản hóa ứng dụng trên đám mây

HOTLINE: 0904.558.448

WEBSITE: https://cloudfly.vn/

FACEBOOK: https://www.facebook.com/cloudfly.vn

TELEGRAM CHANNELS: https://t.me/cloudflyvn