การแก้ไขปัญหาโหนด¶
ใช้หน้านี้เมื่อโหนดแสดงว่าเชื่อมต่ออยู่ในสถานะ แต่เครื่องมือของโหนดทำงานล้มเหลว
ลำดับขั้นคำสั่ง¶
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. nodes describeมีความสามารถที่คุณเรียกใช้อยู่- การอนุมัติการรันคำสั่งแสดงโหมด/รายการอนุญาตตามที่คาดหวัง
ข้อกำหนดการทำงานเบื้องหน้า¶
canvas.*, camera.*, และ screen.* ใช้งานได้เฉพาะเมื่ออยู่เบื้องหน้าบนโหนด iOS/Android
ตรวจสอบและแก้ไขอย่างรวดเร็ว:
openclaw nodes describe --node <idOrNameOrIp>
openclaw nodes canvas snapshot --node <idOrNameOrIp>
openclaw logs --follow
หากคุณเห็น NODE_BACKGROUND_UNAVAILABLE ให้นำแอปโหนดขึ้นมาอยู่เบื้องหน้าแล้วลองใหม่
41. เมทริกซ์สิทธิ์¶
| ความสามารถ | iOS | Android | แอปโหนด macOS | รหัสความล้มเหลวที่พบบ่อย |
|---|---|---|---|---|
camera.snap, camera.clip |
กล้อง(+ไมค์สำหรับเสียงคลิป) | กล้อง(+ไมค์สำหรับเสียงคลิป) | กล้อง(+ไมค์สำหรับเสียงคลิป) | *_PERMISSION_REQUIRED |
screen.record |
การบันทึกหน้าจอ(+ไมค์ไม่บังคับ) | พรอมป์ต์การจับภาพหน้าจอ(+ไมค์ไม่บังคับ) | การบันทึกหน้าจอ | *_PERMISSION_REQUIRED |
location.get |
ขณะใช้งานหรือเสมอ(ขึ้นกับโหมด) | ตำแหน่งเบื้องหน้า/เบื้องหลังตามโหมด | สิทธิ์ตำแหน่ง | LOCATION_PERMISSION_REQUIRED |
system.run |
n/a(พาธโฮสต์โหนด) | n/a(พาธโฮสต์โหนด) | 42. ต้องการการอนุมัติการ Exec | SYSTEM_RUN_DENIED |
การจับคู่เทียบกับการอนุมัติ¶
สิ่งเหล่านี้เป็นด่านที่ต่างกัน:
- การจับคู่อุปกรณ์: โหนดนี้เชื่อมต่อกับ Gatewayได้หรือไม่?
- การอนุมัติการรันคำสั่ง: โหนดนี้สามารถรันคำสั่งเชลล์เฉพาะได้หรือไม่?
การตรวจสอบอย่างรวดเร็ว:
openclaw devices list
openclaw nodes status
openclaw approvals get --node <idOrNameOrIp>
openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"
- หากยังไม่ได้จับคู่ ให้อนุมัติอุปกรณ์โหนดก่อน
หากยังไม่มีการจับคู่ ให้อนุมัติอุปกรณ์โหนดก่อน
หากการจับคู่ปกติแต่
system.runล้มเหลว ให้แก้ไขการอนุมัติการรันคำสั่ง/รายการอนุญาต
รหัสข้อผิดพลาดของโหนดที่พบบ่อย¶
NODE_BACKGROUND_UNAVAILABLE→ แอปทำงานอยู่เบื้องหลัง; นำขึ้นมาอยู่เบื้องหน้าCAMERA_DISABLED→ ปิดสวิตช์กล้องในค่าตั้งค่าโหนด*_PERMISSION_REQUIRED→ ขาดสิทธิ์ของระบบปฏิบัติการหรือถูกปฏิเสธLOCATION_DISABLED→ โหมดตำแหน่งปิดอยู่LOCATION_PERMISSION_REQUIRED→ ไม่ได้รับโหมดตำแหน่งที่ร้องขอLOCATION_BACKGROUND_UNAVAILABLE→ แอปอยู่เบื้องหลังแต่มีเพียงสิทธิ์ขณะใช้งานเท่านั้นSYSTEM_RUN_DENIED: approval required→ คำขอ exec ต้องการการอนุมัติแบบชัดเจนSYSTEM_RUN_DENIED: allowlist miss→ คำสั่งถูกบล็อกโดยโหมดรายการอนุญาต
ลูปการกู้คืนอย่างรวดเร็ว¶
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow
หากยังติดขัด:
- อนุมัติการจับคู่อุปกรณ์ใหม่
- เปิดแอปโหนดใหม่(ให้อยู่เบื้องหน้า)
- อนุญาตสิทธิ์ของระบบปฏิบัติการใหม่
- สร้างหรือปรับนโยบายการอนุมัติการรันคำสั่งใหม่
เกี่ยวข้อง: