Asosiy tarkibga o'tish

​
Kamera tasvirga olish (agent)

OpenClaw agent ish jarayonlari uchun kamera tasvirga olishni qo‘llab-quvvatlaydi:
  • iOS tuguni (Gateway orqali ulangan): node.invoke orqali fotosurat (jpg) yoki qisqa video rolik (mp4, ixtiyoriy audio bilan) olish.
  • Android tuguni (Gateway orqali ulangan): node.invoke orqali fotosurat (jpg) yoki qisqa video rolik (mp4, ixtiyoriy audio bilan) olish.
  • macOS ilovasi (Gateway orqali tugun): node.invoke orqali fotosurat (jpg) yoki qisqa video rolik (mp4, ixtiyoriy audio bilan) olish.
Barcha kamera kirishlari foydalanuvchi boshqaradigan sozlamalar orqali nazorat qilinadi.

​
iOS tuguni

​
Foydalanuvchi sozlamasi (standart yoqilgan)

  • iOS Settings yorlig‘i → Camera → Allow Camera (camera.enabled)
    • Standart: yoqilgan (kalit mavjud bo‘lmasa ham yoqilgan deb hisoblanadi).
    • O‘chirilganda: camera.* buyruqlari CAMERA_DISABLED qaytaradi.

​
Buyruqlar (Gateway orqali node.invoke)

  • camera.list
    • Javob payload:
      • devices: { id, name, position, deviceType } obyektlar massivi
  • camera.snap
    • Parametrlar:
      • facing: front|back (standart: front)
      • maxWidth: son (ixtiyoriy; iOS tugunida standart 1600)
      • quality: 0..1 (ixtiyoriy; standart 0.9)
      • format: hozircha jpg
      • delayMs: son (ixtiyoriy; standart 0)
      • deviceId: satr (ixtiyoriy; camera.list dan)
    • Javob payload:
      • format: "jpg"
      • base64: "<...>"
      • width, height
    • Payload himoyasi: fotosuratlar base64 payload hajmi 5 MB dan oshmasligi uchun qayta siqiladi.
  • camera.clip
    • Parametrlar:
      • facing: front|back (standart: front)
      • durationMs: son (standart 3000, maksimal 60000 gacha cheklanadi)
      • includeAudio: boolean (standart true)
      • format: hozircha mp4
      • deviceId: satr (ixtiyoriy; camera.list dan)
    • Javob payload:
      • format: "mp4"
      • base64: "<...>"
      • durationMs
      • hasAudio

​
Old fon talabi

canvas.* kabi, iOS tuguni faqat foreground holatida camera.* buyruqlariga ruxsat beradi. Background chaqiruvlar NODE_BACKGROUND_UNAVAILABLE ni qaytaradi.

​
CLI yordamchisi (vaqtinchalik fayllar + MEDIA)

Biriktirmalarni olishning eng oson yo‘li — dekodlangan mediani vaqtinchalik faylga yozib, MEDIA:<path> chiqaradigan CLI yordamchisidan foydalanish. Misollar: 
openclaw nodes camera snap --node <id>               # standart: front + back (2 ta MEDIA qatori)
openclaw nodes camera snap --node <id> --facing front
openclaw nodes camera clip --node <id> --duration 3000
openclaw nodes camera clip --node <id> --no-audio
Eslatmalar:
  • nodes camera snap standart bo‘yicha agentga ikkala ko‘rinishni berish uchun ikkala tomonni suratga oladi.
  • Agar o‘zingizning wrapper’ingizni yaratmasangiz, chiqish fayllari vaqtinchalik (OT vaqtinchalik katalogida) bo‘ladi.

​
Android tuguni

​
Android foydalanuvchi sozlamasi (standart yoqilgan)

  • Android Settings oynasi → Camera → Allow Camera (camera.enabled)
    • Standart: yoqilgan (kalit mavjud bo‘lmasa ham yoqilgan deb hisoblanadi).
    • O‘chirilganda: camera.* buyruqlari CAMERA_DISABLED qaytaradi.

​
Ruxsatlar

  • Android ish vaqtida ruxsatlarni talab qiladi:
    • CAMERA — camera.snap va camera.clip uchun.
    • RECORD_AUDIO — camera.clip da includeAudio=true bo‘lsa.
Agar ruxsatlar mavjud bo‘lmasa, ilova imkon qadar so‘rov yuboradi; rad etilsa, camera.* so‘rovlari
*_PERMISSION_REQUIRED xatosi bilan yakunlanadi.

​
Android old fon talabi

canvas.* kabi, Android tuguni ham faqat foreground holatida camera.* buyruqlariga ruxsat beradi. Background chaqiruvlar NODE_BACKGROUND_UNAVAILABLE ni qaytaradi.

​
Payload himoyasi

Fotosuratlar base64 payload hajmi 5 MB dan oshmasligi uchun qayta siqiladi.

​
macOS ilovasi

​
Foydalanuvchi sozlamasi (standart o‘chirilgan)

macOS hamroh ilovasi quyidagi belgilash katagini taqdim etadi:
  • Sozlamalar → Umumiy → Kameraga ruxsat berish (openclaw.cameraEnabled)
    • Standart: o‘chirilgan
    • O‘chirilgan bo‘lsa: kamera so‘rovlari “Camera disabled by user” qaytaradi.

​
CLI yordamchisi (node invoke)

macOS tugunida kamera buyruqlarini chaqirish uchun asosiy openclaw CLI’dan foydalaning. Misollar: 
openclaw nodes camera list --node <id>            # kamera id larini ko‘rsatadi
openclaw nodes camera snap --node <id>            # MEDIA:<path> chiqaradi
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          # MEDIA:<path> chiqaradi
openclaw nodes camera clip --node <id> --duration-ms 3000      # MEDIA:<path> chiqaradi (eski flag)
openclaw nodes camera clip --node <id> --device-id <id>
openclaw nodes camera clip --node <id> --no-audio
Eslatmalar:
  • openclaw nodes camera snap standart bo‘yicha, agar o‘zgartirilmasa, maxWidth=1600 dan foydalanadi.
  • macOS’da camera.snap suratga olishdan oldin qizish/ekspozitsiya barqarorlashishi uchun delayMs (standart 2000ms) kutadi.
  • Foto payloadlari base64 hajmi 5 MB dan oshmasligi uchun qayta siqiladi.

​
Xavfsizlik + amaliy cheklovlar

  • Kamera va mikrofon kirishi odatiy OT ruxsat so‘rovlarini ishga tushiradi (hamda Info.plist’da usage satrlarini talab qiladi).
  • Video roliklar tugun payloadi haddan tashqari kattalashib ketmasligi uchun (base64 overhead + xabar cheklovlari) cheklangan (hozircha <= 60s).

​
macOS ekran videosi (OT darajasida)

Kamera emas, balki ekran videosi uchun macOS hamrohidan foydalaning: 
openclaw nodes screen record --node <id> --duration 10s --fps 15   # MEDIA:<path> chiqaradi
Eslatmalar:
  • macOS’da Screen Recording ruxsati (TCC) talab qilinadi.