> ## Documentation Index
> Fetch the complete documentation index at: https://openclawhub.vn/llms.txt
> Use this file to discover all available pages before exploring further.

# Chụp Ảnh và Video

# Chụp Ảnh và Video (agent)

OpenClaw hỗ trợ **chụp ảnh và quay video** cho quy trình làm việc của 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`.

Tất cả truy cập camera đều được kiểm soát bởi **cài đặt của người dùng**.

## 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

Giống như `canvas.*`, node iOS chỉ cho phép các lệnh `camera.*` trong **nền trước**. Các lệnh chạy nền sau trả về `NODE_BACKGROUND_UNAVAILABLE`.

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

Cách dễ nhất để lấy tệp đính kèm là qua trợ giúp CLI, ghi phương tiện đã giải mã vào tệp tạm thời và in `MEDIA:<path>`.

Ví dụ:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

Lưu ý:

* `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`.

Nếu thiếu quyền, ứng dụng sẽ nhắc khi có thể; nếu bị từ chối, các yêu cầu `camera.*` sẽ thất bại với lỗi `*_PERMISSION_REQUIRED`.

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

Giống như `canvas.*`, node Android chỉ cho phép các lệnh `camera.*` trong **nền trước**. Các lệnh chạy nền sau trả về `NODE_BACKGROUND_UNAVAILABLE`.

### 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

Ảnh được nén lại để giữ payload base64 dưới 5 MB.

## Ứng dụng macOS

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

Ứng dụng đồng hành macOS cung cấp một hộp kiểm:

* **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)

Sử dụng CLI chính `openclaw` để gọi các lệnh camera trên node macOS.

Ví dụ:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

Lưu ý:

* `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)

Để quay video *màn hình* (không phải camera), sử dụng ứng dụng đồng hành macOS:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes screen record --node <id> --duration 10s --fps 15   # in MEDIA:<path>
```

Lưu ý:

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