Kamera-Capture für Agent-Workflows mit OpenClaw

Kennst du das? Du baust einen Agenten, der physische Aufgaben verstehen oder dokumentieren soll, aber er ist quasi blind. Meistens scheitert es daran, dass der Zugriff auf die Hardware über verschiedene Betriebssysteme hinweg extrem mühsam ist. Du musst dich mit unterschiedlichen Berechtigungen herumschlagen und die Daten mühsam konvertieren, bevor dein Agent sie verarbeiten kann.

OpenClaw löst das Problem, indem es Kameras auf mobilen Geräten und Desktop-Rechnern über ein einheitliches Gateway anspricht. Dein Agent kann so ganz einfach Fotos oder Videos anfordern.

Voraussetzungen

• iOS node, Android node oder macOS app
• Eine aktive Verbindung über ein Gateway
• Das OpenClaw CLI Tool
• Korrekte Hardware-Berechtigungen in den OS-Einstellungen

Schnellstart

Der schnellste Weg, um Medien zu erfassen, ist der CLI helper. Er kümmert sich um die Dekodierung der base64-Daten und speichert sie als Datei.

# Ein Foto aufnehmen (bei iOS werden standardmäßig Front- und Rückkamera erfasst)
openclaw nodes camera snap --node <id>

# Einen 3-sekündigen Videoclip aufnehmen
openclaw nodes camera clip --node <id> --duration 3000

# Ein Foto nur mit der Frontkamera aufnehmen
openclaw nodes camera snap --node <id> --facing front

# Video ohne Ton aufnehmen
openclaw nodes camera clip --node <id> --no-audio

Die CLI gibt den Pfad zur Datei im Format MEDIA:<path> aus.

Platform Details

iOS und Android

Auf mobilen Geräten ist die Kamera-Funktion standardmäßig in den App-Einstellungen aktiviert. Beachte jedoch zwei wichtige Punkte:

1. Vordergrund-Pflicht: Die App muss aktiv im Vordergrund laufen. Ist sie im Hintergrund, gibt der Node den Fehler NODE_BACKGROUND_UNAVAILABLE zurück.
2. Berechtigungen: Android fragt Berechtigungen für CAMERA und RECORD_AUDIO zur Laufzeit ab. Werden diese verweigert, schlagen die Requests fehl.

macOS

In der macOS App ist die Kamera aus Sicherheitsgründen standardmäßig deaktiviert. Du musst sie erst unter Settings → General → Allow Camera einschalten.

Für macOS gibt es zusätzliche CLI-Optionen:

# Verfügbare Kamera-IDs auflisten
openclaw nodes camera list --node <id>

# Foto mit spezifischer Breite und Verzögerung
openclaw nodes camera snap --node <id> --max-width 1280 --delay-ms 2000

# Bildschirmaufnahme statt Kamera
openclaw nodes screen record --node <id> --duration 10s --fps 15

Fehlerbehebung

• CAMERA_DISABLED: Prüfe die Kamera-Einstellungen innerhalb der OpenClaw App auf dem Zielgerät.
• NODE_BACKGROUND_UNAVAILABLE: Stelle sicher, dass die App auf dem Smartphone gerade aktiv auf dem Bildschirm zu sehen ist.
• *_PERMISSION_REQUIRED: Die OS-Abfrage für den Kamerazugriff wurde abgelehnt. Prüfe die System-Einstellungen deines Geräts.
• Payload-Limit: Fotos werden automatisch rekomprimiert, um die base64-Payload unter 5 MB zu halten. Videoclips sind auf maximal 60 Sekunden begrenzt.

Du hast Fragen zum Setup? Nutze den AI Setup Assistant.

Nächste Schritte

• Gateway Konfiguration
• Node Management CLI
• iOS Node Setup
• Android Node Setup