Camera Capture（攝影機擷取）

攝影機擷取（Agent）

OpenClaw 支援 Agent 工作流程的攝影機擷取：

• iOS 節點（透過 Gateway 配對）：透過 node.invoke 擷取照片（jpg）或短影片剪輯（mp4，可選音訊）。
• Android 節點（透過 Gateway 配對）：透過 node.invoke 擷取照片（jpg）或短影片剪輯（mp4，可選音訊）。
• macOS App（透過 Gateway 的節點）：透過 node.invoke 擷取照片（jpg）或短影片剪輯（mp4，可選音訊）。

所有攝影機存取都在使用者控制的設定後面。

iOS 節點

使用者設定（預設開啟）

• iOS 設定標籤 → 攝影機 → 允許攝影機（camera.enabled）
  • 預設：開啟（遺漏的鍵被視為啟用）。
  • 關閉時：camera.* 命令傳回 CAMERA_DISABLED。

命令（透過 Gateway node.invoke）

• camera.list

  • 回應有效負載：
    • devices：{ id, name, position, deviceType } 陣列

• camera.snap

  • 參數：
    • facing：front|back（預設：front）
    • maxWidth：數字（選擇性；iOS 節點預設 1600）
    • quality：0..1（選擇性；預設 0.9）
    • format：目前 jpg
    • delayMs：數字（選擇性；預設 0）
    • deviceId：字串（選擇性；來自 camera.list）
  • 回應有效負載：
    • format: "jpg"
    • base64: "<...>"
    • width、height
  • 有效負載守衛：照片被重新壓縮以保持 base64 有效負載在 5 MB 以下。

• camera.clip

  • 參數：
    • facing：front|back（預設：front）
    • durationMs：數字（預設 3000，上限 60000）
    • includeAudio：布林值（預設 true）
    • format：目前 mp4
    • deviceId：字串（選擇性；來自 camera.list）
  • 回應有效負載：
    • format: "mp4"
    • base64: "<...>"
    • durationMs
    • hasAudio

前景要求

如同 canvas.*，iOS 節點僅允許前景中的 camera.* 命令。後台呼叫傳回 NODE_BACKGROUND_UNAVAILABLE。

CLI 輔助程式（暫存檔案 + MEDIA）

取得附件的最簡單方式是透過 CLI 輔助程式，它將已解碼的媒體寫入暫存檔案並列印 MEDIA:<path>。

範例：

openclaw nodes camera snap --node <id>               # 預設：前後兩個（2 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 預設為兩個面以給予 Agent 兩個檢視。
• 輸出檔案是暫存的（在作業系統暫存目錄中），除非你建置自己的包裝程式。