​

Xử lý sự cố node

​

Thứ tự kiểm tra lệnh

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>

• Node đã kết nối và được ghép cặp cho vai trò node.
• nodes describe bao gồm khả năng bạn đang gọi.
• Phê duyệt exec hiển thị đúng chế độ/danh sách cho phép mong đợi.

​

Yêu cầu chạy nền trước

openclaw nodes describe --node <idOrNameOrIp>
openclaw nodes canvas snapshot --node <idOrNameOrIp>
openclaw logs --follow

​

Ma trận quyền

​

Ghép cặp so với phê duyệt

1. Ghép cặp thiết bị: node này có thể kết nối tới gateway (cổng kết nối) không?
2. Phê duyệt exec: node này có thể chạy một lệnh shell cụ thể không?

openclaw devices list
openclaw nodes status
openclaw approvals get --node <idOrNameOrIp>
openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"

​

Mã lỗi node thường gặp

• NODE_BACKGROUND_UNAVAILABLE → ứng dụng đang ở nền sau; đưa lên nền trước.
• CAMERA_DISABLED → công tắc camera bị tắt trong cài đặt node.
• *_PERMISSION_REQUIRED → thiếu/bị từ chối quyền của hệ điều hành.
• LOCATION_DISABLED → chế độ vị trí đang tắt.
• LOCATION_PERMISSION_REQUIRED → chế độ vị trí được yêu cầu chưa được cấp.
• LOCATION_BACKGROUND_UNAVAILABLE → ứng dụng ở nền sau nhưng chỉ có quyền Khi đang dùng.
• SYSTEM_RUN_DENIED: approval required → yêu cầu exec cần phê duyệt rõ ràng.
• SYSTEM_RUN_DENIED: allowlist miss → lệnh bị chặn bởi chế độ danh sách cho phép.

​

Vòng khôi phục nhanh

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow

• Phê duyệt lại ghép cặp thiết bị.
• Mở lại ứng dụng node (đưa lên nền trước).
• Cấp lại quyền hệ điều hành.
• Tạo lại/điều chỉnh chính sách phê duyệt exec.

• /nodes/index
• /nodes/camera
• /nodes/location-command
• /tools/exec-approvals
• /gateway/pairing