Nodes and media
การแก้ไขปัญหา Node
ใช้หน้านี้เมื่อ Node ปรากฏในสถานะ แต่เครื่องมือของ Node ทำงานล้มเหลว
ลำดับคำสั่ง
openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probeจากนั้นเรียกใช้การตรวจสอบเฉพาะสำหรับ Node:
openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>สัญญาณที่บ่งชี้ว่าทำงานปกติ:
- Node เชื่อมต่อและจับคู่แล้วสำหรับบทบาท
node nodes describeมีความสามารถที่คุณกำลังเรียกใช้- การอนุมัติการเรียกใช้แสดงโหมด/รายการอนุญาตที่คาดไว้
ข้อกำหนดสำหรับการทำงานเบื้องหน้า
canvas.*, camera.* และ screen.* ทำงานได้เฉพาะเบื้องหน้าบน Node iOS/Android
การตรวจสอบและแก้ไขอย่างรวดเร็ว:
openclaw nodes describe --node <idOrNameOrIp>openclaw nodes canvas snapshot --node <idOrNameOrIp>openclaw logs --followหากพบ NODE_BACKGROUND_UNAVAILABLE ให้นำแอป Node มาไว้เบื้องหน้าแล้วลองอีกครั้ง
ตารางสิทธิ์
| ความสามารถ | iOS | Android | แอป Node บน macOS | รหัสข้อผิดพลาดที่พบบ่อย |
|---|---|---|---|---|
camera.snap, camera.clip |
กล้อง (+ ไมโครโฟนสำหรับเสียงในคลิป) | กล้อง (+ ไมโครโฟนสำหรับเสียงในคลิป) | กล้อง (+ ไมโครโฟนสำหรับเสียงในคลิป) | *_PERMISSION_REQUIRED |
screen.record |
การบันทึกหน้าจอ (+ ไมโครโฟนเป็นตัวเลือก) | พรอมต์จับภาพหน้าจอ (+ ไมโครโฟนเป็นตัวเลือก) | การบันทึกหน้าจอ | *_PERMISSION_REQUIRED |
computer.act |
ไม่มี | ไม่มี | การช่วยการเข้าถึง + การบันทึกหน้าจอ | COMPUTER_DISABLED, ACCESSIBILITY_REQUIRED |
location.get |
ขณะใช้งานหรือเสมอ (ขึ้นอยู่กับโหมด) | ตำแหน่งเบื้องหน้า/เบื้องหลังตามโหมด | สิทธิ์เข้าถึงตำแหน่ง | LOCATION_PERMISSION_REQUIRED |
system.run |
ไม่มี (เส้นทางโฮสต์ของ Node) | ไม่มี (เส้นทางโฮสต์ของ Node) | ต้องได้รับการอนุมัติการเรียกใช้ | SYSTEM_RUN_DENIED |
การจับคู่เทียบกับการอนุมัติ
มีด่านแยกกันสามรายการที่ควบคุมว่าคำสั่งของ Node จะสำเร็จหรือไม่:
- การจับคู่อุปกรณ์: Node นี้สามารถเชื่อมต่อกับ Gateway ได้หรือไม่
- นโยบายคำสั่ง Node ของ Gateway: รหัสคำสั่ง RPC ได้รับอนุญาตจาก
gateway.nodes.allowCommands/denyCommandsและค่าเริ่มต้นของแพลตฟอร์มหรือไม่ - การอนุมัติการเรียกใช้: Node นี้สามารถเรียกใช้คำสั่งเชลล์ที่ระบุภายในเครื่องได้หรือไม่
การจับคู่ Node เป็นด่านด้านข้อมูลประจำตัว/ความเชื่อถือ ไม่ใช่ส่วนสำหรับอนุมัติแต่ละคำสั่ง สำหรับ system.run นโยบายเฉพาะ Node อยู่ในไฟล์การอนุมัติการเรียกใช้ของ Node นั้น (openclaw approvals get --node ...) ไม่ได้อยู่ในระเบียนการจับคู่ของ Gateway
การตรวจสอบอย่างรวดเร็ว:
openclaw devices listopenclaw nodes statusopenclaw approvals get --node <idOrNameOrIp>openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"- ไม่มีการจับคู่: อนุมัติอุปกรณ์ Node ก่อน
nodes describeไม่มีคำสั่ง: ตรวจสอบนโยบายคำสั่ง Node ของ Gateway และตรวจสอบว่า Node ได้ประกาศคำสั่งนั้นจริงเมื่อเชื่อมต่อหรือไม่- การจับคู่ปกติ แต่
system.runล้มเหลว: แก้ไขการอนุมัติการเรียกใช้/รายการอนุญาตบน Node นั้น
สำหรับการเรียกใช้ host=node ที่อาศัยการอนุมัติ Gateway จะผูกการเรียกใช้เข้ากับ systemRunPlan มาตรฐานที่เตรียมไว้ด้วย หากผู้เรียกในภายหลังแก้ไขคำสั่ง ไดเรกทอรีทำงาน หรือข้อมูลเมตาของเซสชันก่อนส่งต่อการเรียกใช้ที่ได้รับอนุมัติ Gateway จะปฏิเสธการเรียกใช้นั้นเนื่องจากการอนุมัติไม่ตรงกัน แทนที่จะเชื่อถือเพย์โหลดที่ถูกแก้ไข
รหัสข้อผิดพลาดทั่วไปของ Node
| รหัส | ความหมาย |
|---|---|
NODE_BACKGROUND_UNAVAILABLE |
แอปทำงานอยู่เบื้องหลัง ให้นำแอปมาไว้เบื้องหน้า |
CAMERA_DISABLED |
การสลับเปิด/ปิดกล้องถูกปิดใช้งานในการตั้งค่าของ Node |
*_PERMISSION_REQUIRED |
ไม่มีสิทธิ์ของระบบปฏิบัติการหรือถูกปฏิเสธ |
LOCATION_DISABLED |
โหมดตำแหน่งปิดอยู่ |
LOCATION_PERMISSION_REQUIRED |
ไม่ได้ให้สิทธิ์สำหรับโหมดตำแหน่งที่ร้องขอ |
LOCATION_BACKGROUND_UNAVAILABLE |
แอปทำงานอยู่เบื้องหลัง แต่มีเพียงสิทธิ์ขณะใช้งาน |
COMPUTER_DISABLED |
เปิดใช้งาน Allow Computer Control ในแอป macOS แล้วอนุมัติการอัปเดตการจับคู่ |
ACCESSIBILITY_REQUIRED |
ให้สิทธิ์การช่วยการเข้าถึงแก่ชุดแอป OpenClaw ปัจจุบันในการตั้งค่าระบบของ macOS |
SYSTEM_RUN_DENIED: approval required |
คำขอเรียกใช้ต้องได้รับการอนุมัติอย่างชัดเจน |
SYSTEM_RUN_DENIED: allowlist miss |
คำสั่งถูกบล็อกโดยโหมดรายการอนุญาต บนโฮสต์ Node ของ Windows รูปแบบที่ครอบด้วยเชลล์ เช่น cmd.exe /c ... จะถือว่าไม่อยู่ในรายการอนุญาตเมื่อใช้โหมดรายการอนุญาต เว้นแต่จะได้รับอนุมัติผ่านขั้นตอนการสอบถาม |
วงรอบการกู้คืนอย่างรวดเร็ว
openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>openclaw logs --followหากยังคงติดขัด:
- อนุมัติการจับคู่อุปกรณ์อีกครั้ง
- เปิดแอป Node อีกครั้ง (เบื้องหน้า)
- ให้สิทธิ์ของระบบปฏิบัติการอีกครั้ง
- สร้างใหม่/ปรับนโยบายการอนุมัติการเรียกใช้
สำหรับการควบคุมคอมพิวเตอร์ ให้ตรวจสอบด้วยว่าเอเจนต์ที่รองรับการมองเห็นเปิดเผยเครื่องมือ computer, screen.snapshot ทำงานสำเร็จโดยมีสิทธิ์การบันทึกหน้าจอ และ /phone status แสดงการอนุญาต Gateway แบบชั่วคราวหรือถาวรตามที่คุณต้องการ รายการใน gateway.nodes.denyCommands จะมีผลเหนือกว่า allowCommands เสมอ
