Hướng dẫn OpenClaw cho người mới #2: Pairing node lỗi unauthorized hoặc token hết hạn

Mục tiêu

Giúp bạn kết nối app với node thành công khi gặp lỗi ủy quyền hoặc token.

Nhận diện lỗi phổ biến

• unauthorized: token sai/hết hạn hoặc quyền chưa hợp lệ.
• bootstrap token invalid/expired: token cũ đã hết hạn.
• Local chạy, remote lỗi: bind/public URL/tailnet chưa đúng.

Quy trình xử lý

1. Tạo token mới, không tái dùng token cũ.
2. Kiểm tra đồng bộ thời gian hệ thống (clock drift dễ làm token fail).
3. Xác nhận gateway đang chạy ổn định trước khi pair lại.
4. Kiểm tra cấu hình remote: gateway.bind, URL public, và mạng tailnet (nếu dùng).
5. Test theo thứ tự: cùng LAN trước, sau đó mới test kết nối internet.

Mẹo tăng tỷ lệ pair thành công

• Luôn copy nguyên văn lỗi để đối chiếu docs.
• Mỗi lần chỉ thay đổi 1 biến cấu hình rồi thử lại.
• Đảm bảo app và node dùng đúng endpoint dự kiến.

Nguồn chính thống tham khảo

• OpenClaw Docs
• OpenClaw Source (GitHub)
• Node connection & pairing guidance