​

Chụp Ảnh và Video (agent)

• Node iOS (kết nối qua Gateway): chụp ảnh (jpg) hoặc video ngắn (mp4, có thể kèm âm thanh) qua node.invoke.
• Node Android (kết nối qua Gateway): chụp ảnh (jpg) hoặc video ngắn (mp4, có thể kèm âm thanh) qua node.invoke.
• Ứng dụng macOS (node qua Gateway): chụp ảnh (jpg) hoặc video ngắn (mp4, có thể kèm âm thanh) qua node.invoke.

​

Node iOS

​

Cài đặt người dùng (mặc định bật)

• Tab Cài đặt iOS → Camera → Cho phép Camera (camera.enabled)
  • Mặc định: bật (khóa bị thiếu được coi là đã bật).
  • Khi tắt: các lệnh camera.* trả về CAMERA_DISABLED.

​

Lệnh (qua Gateway node.invoke)

• camera.list
  • Phản hồi:
    • devices: mảng { id, name, position, deviceType }
• camera.snap
  • Tham số:
    • facing: front|back (mặc định: front)
    • maxWidth: số (tùy chọn; mặc định 1600 trên node iOS)
    • quality: 0..1 (tùy chọn; mặc định 0.9)
    • format: hiện tại là jpg
    • delayMs: số (tùy chọn; mặc định 0)
    • deviceId: chuỗi (tùy chọn; từ camera.list)
  • Phản hồi:
    • format: "jpg"
    • base64: "<...>"
    • width, height
  • Giới hạn payload: ảnh được nén lại để giữ payload base64 dưới 5 MB.
• camera.clip
  • Tham số:
    • facing: front|back (mặc định: front)
    • durationMs: số (mặc định 3000, tối đa 60000)
    • includeAudio: boolean (mặc định true)
    • format: hiện tại là mp4
    • deviceId: chuỗi (tùy chọn; từ camera.list)
  • Phản hồi:
    • format: "mp4"
    • base64: "<...>"
    • durationMs
    • hasAudio

​

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

​

Trợ giúp CLI (tệp tạm thời + MEDIA)

openclaw nodes camera snap --node <id>               # mặc định: cả trước + sau (2 dòng MEDIA)
openclaw nodes camera snap --node <id> --facing front
openclaw nodes camera clip --node <id> --duration 3000
openclaw nodes camera clip --node <id> --no-audio

• nodes camera snap mặc định chụp cả hai hướng để cung cấp cho agent cả hai góc nhìn.
• Các tệp đầu ra là tạm thời (trong thư mục tạm của hệ điều hành) trừ khi bạn tự xây dựng trình bao bọc.

​

Node Android

​

Cài đặt người dùng Android (mặc định bật)

• Bảng Cài đặt Android → Camera → Cho phép Camera (camera.enabled)
  • Mặc định: bật (khóa bị thiếu được coi là đã bật).
  • Khi tắt: các lệnh camera.* trả về CAMERA_DISABLED.

​

Quyền

• Android yêu cầu quyền chạy thời gian:
  • CAMERA cho cả camera.snap và camera.clip.
  • RECORD_AUDIO cho camera.clip khi includeAudio=true.

​

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

​

Lệnh Android (qua Gateway node.invoke)

• camera.list
  • Phản hồi:
    • devices: mảng { id, name, position, deviceType }

​

Giới hạn payload

​

Ứng dụng macOS

​

Cài đặt người dùng (mặc định tắt)

• Cài đặt → Chung → Cho phép Camera (openclaw.cameraEnabled)
  • Mặc định: tắt
  • Khi tắt: các yêu cầu camera trả về “Camera bị vô hiệu hóa bởi người dùng”.

​

Trợ giúp CLI (node invoke)

openclaw nodes camera list --node <id>            # liệt kê id camera
openclaw nodes camera snap --node <id>            # in MEDIA:<path>
openclaw nodes camera snap --node <id> --max-width 1280
openclaw nodes camera snap --node <id> --delay-ms 2000
openclaw nodes camera snap --node <id> --device-id <id>
openclaw nodes camera clip --node <id> --duration 10s          # in MEDIA:<path>
openclaw nodes camera clip --node <id> --duration-ms 3000      # in MEDIA:<path> (cờ cũ)
openclaw nodes camera clip --node <id> --device-id <id>
openclaw nodes camera clip --node <id> --no-audio

• openclaw nodes camera snap mặc định maxWidth=1600 trừ khi được ghi đè.
• Trên macOS, camera.snap chờ delayMs (mặc định 2000ms) sau khi khởi động/ổn định phơi sáng trước khi chụp.
• Payload ảnh được nén lại để giữ base64 dưới 5 MB.

​

An toàn + giới hạn thực tế

• Truy cập camera và micro kích hoạt các nhắc nhở quyền của hệ điều hành thông thường (và yêu cầu chuỗi sử dụng trong Info.plist).
• Video clip bị giới hạn (hiện tại <= 60s) để tránh payload node quá lớn (overhead base64 + giới hạn tin nhắn).

​

Video màn hình macOS (cấp độ hệ điều hành)

openclaw nodes screen record --node <id> --duration 10s --fps 15   # in MEDIA:<path>

• Yêu cầu quyền Ghi màn hình của macOS (TCC).