Захват камеры (агент)¶

OpenClaw поддерживает захват камеры для агентских рабочих процессов:

• iOS-узел (сопряжён через Gateway (шлюз)): захват фото (jpg) или короткого видеоклипа (mp4, с необязательным аудио) через node.invoke.
• Android-узел (сопряжён через Gateway (шлюз)): захват фото (jpg) или короткого видеоклипа (mp4, с необязательным аудио) через node.invoke.
• Приложение для macOS (узел через Gateway (шлюз)): захват фото (jpg) или короткого видеоклипа (mp4, с необязательным аудио) через node.invoke.

Весь доступ к камере ограничен настройками, контролируемыми пользователем.

iOS-узел¶

Пользовательская настройка (по умолчанию включено)¶

• Вкладка «Настройки» iOS → Камера → Разрешить камеру (camera.enabled)
• По умолчанию: включено (отсутствующий ключ считается включённым).
• При выключении: команды camera.* возвращают CAMERA_DISABLED.

Команды (через Gateway node.invoke)¶

• camera.list

• Полезная нагрузка ответа:

  • devices: массив { id, name, position, deviceType }

• camera.snap

• Параметры:
  • facing: front|back (по умолчанию: front)
  • maxWidth: number (необязательно; по умолчанию 1600 на iOS-узле)
  • quality: 0..1 (необязательно; по умолчанию 0.9)
  • format: в настоящее время jpg
  • delayMs: number (необязательно; по умолчанию 0)
  • deviceId: string (необязательно; из camera.list)
• Полезная нагрузка ответа:
  • format: "jpg"
  • base64: "<...>"
  • width, height

• Ограничение полезной нагрузки: фотографии перекодируются, чтобы удерживать полезную нагрузку base64 ниже 5 МБ.

• camera.clip

• Параметры:
  • facing: front|back (по умолчанию: front)
  • durationMs: number (по умолчанию 3000, с ограничением до максимума 60000)
  • includeAudio: boolean (по умолчанию true)
  • format: в настоящее время mp4
  • deviceId: string (необязательно; из camera.list)
• Полезная нагрузка ответа:
  • format: "mp4"
  • base64: "<...>"
  • durationMs
  • hasAudio

Требование переднего плана¶

Как и canvas.*, iOS-узел разрешает команды camera.* только в переднем плане. Вызовы в фоне возвращают NODE_BACKGROUND_UNAVAILABLE.

Помощник CLI (временные файлы + MEDIA)¶

Самый простой способ получить вложения — использовать помощник CLI, который записывает декодированное медиа во временный файл и выводит MEDIA:<path>.

Примеры:

openclaw nodes camera snap --node <id>               # default: both front + back (2 MEDIA lines)
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 по умолчанию использует обе камеры, чтобы предоставить агенту оба вида.
• Выходные файлы являются временными (в каталоге временных файлов ОС), если вы не создадите собственную обёртку.

Android-узел¶

Пользовательская настройка Android (по умолчанию включено)¶

• Лист настроек Android → Камера → Разрешить камеру (camera.enabled)
• По умолчанию: включено (отсутствующий ключ считается включённым).
• При выключении: команды camera.* возвращают CAMERA_DISABLED.

Разрешения¶

• Android требует разрешений во время выполнения:
• CAMERA для camera.snap и camera.clip.
• RECORD_AUDIO для camera.clip, когда includeAudio=true.

Если разрешения отсутствуют, приложение по возможности запросит их; при отказе запросы camera.* завершаются с ошибкой *_PERMISSION_REQUIRED.

Требование переднего плана Android¶

Как и canvas.*, Android-узел разрешает команды camera.* только в переднем плане. Вызовы в фоне возвращают NODE_BACKGROUND_UNAVAILABLE.

Защита от нагрузки¶

Фотографии перекодируются, чтобы удерживать полезную нагрузку base64 ниже 5 МБ.

Приложение для macOS¶

Пользовательская настройка (по умолчанию выключено)¶

Сопутствующее приложение macOS предоставляет флажок:

• Настройки → Общие → Разрешить камеру (openclaw.cameraEnabled)
• По умолчанию: выключено
• При выключении: запросы к камере возвращают «Camera disabled by user».

Помощник CLI (вызов узла)¶

Используйте основной CLI openclaw для вызова команд камеры на узле macOS.

Примеры:

openclaw nodes camera list --node <id>            # list camera ids
openclaw nodes camera snap --node <id>            # prints 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          # prints MEDIA:<path>
openclaw nodes camera clip --node <id> --duration-ms 3000      # prints MEDIA:<path> (legacy flag)
openclaw nodes camera clip --node <id> --device-id <id>
openclaw nodes camera clip --node <id> --no-audio

Примечания:

• openclaw nodes camera snap по умолчанию установлен в maxWidth=1600, если не переопределён.
• В macOS camera.snap ожидает delayMs (по умолчанию 2000 мс) после прогрева/стабилизации экспозиции перед захватом.
• Полезные нагрузки фото перекодируются, чтобы удерживать base64 ниже 5 МБ.

Безопасность и практические ограничения¶

• Доступ к камере и микрофону вызывает стандартные запросы разрешений ОС (и требует строк использования в Info.plist).
• Видеоклипы ограничены по длительности (в настоящее время <= 60s), чтобы избежать чрезмерно больших полезных нагрузок узла (накладные расходы base64 + ограничения сообщений).

Видео экрана macOS (на уровне ОС)¶

Для видео экрана (не камеры) используйте сопутствующее приложение macOS:

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

Примечания:

• Требуется разрешение macOS Screen Recording (TCC).