Web- und UI-Teams speichern PNG aus Chrome, Safari oder Design-Plugins oft in feste Download- bzw. Exportordner — ohne dass Farbprofil, Dateiname und Ablage pro Sprint einheitlich bleiben. Auf einem Remote Mac lässt sich mit OpenClaw ein schlanker Watch-Worker betreiben, der neue PNGs entprellt, ICC/iCCP gegen Ihre Policy prüft, nach Vorlage umbenennt und mit Retry robust in ein Archiv schreibt. Dieser Leitfaden liefert eine Checkliste, eine Entscheidungsmatrix für Validator-Werkzeuge, Schrittfolge inklusive Troubleshooting sowie Verweise auf den OpenClaw-Installationsleitfaden und die vertiefende PNG-Metadaten- und ICC-Dokumentation.
Inhalt
Typische Engpässe vor der Pipeline
- Profil-Drift: Browser und Plugins liefern mal sRGB, mal Display P3 oder gar kein eingebettetes Profil — ohne automatische Prüfung rutschen Ausreißer in CMS und Shop-Frontends.
- Halbfertige Schreibvorgänge: Exporte erscheinen zuerst mit temporärem Namen oder werden von Sync-Tools kurz gesperrt; Worker starten zu früh und verarbeiten leere Dateien.
- Unklare Benennung: Ohne Slug-Schema lassen sich Releases nicht diffbar versionieren; manuelle Umbenennung skaliert nicht auf Remote-Teams.
OpenClaw / Gateway: Minimalinstallation & Berechtigungen
Folgen Sie zuerst dem projektintern dokumentierten Gateway-Setup im Installationsleitfaden: stabile Version pinen, PATH und Arbeitsverzeichnis für den LaunchAgent oder Dienstbenutzer setzen. Auf dem Remote Mac sollten inbox, work, out, failed und logs demselben Unix-Account gehören wie Ihre SSH-Session — sonst entstehen stille Permission-denied-Fehler. Wenn ein CLI-Tool Vollzugriff auf Datenträger anfordert, erteilen Sie dies nur für den Worker-Account und dokumentieren Sie die Ausnahme. Ein periodischer curl-Health-Check am Gateway bleibt optional, erhöht aber die Auditierbarkeit der Kette Skill → Skript.
Ordnerüberwachung: Browser-Export & Plugin-Pfade
Tragen Sie den absoluten Pfad ein, den der Browser oder das Figma-/Sketch-Plugin für PNG wirklich nutzt — typisch ~/Downloads oder ein projektspezifischer Unterordner. Konfigurieren Sie den Watch mit Glob *.png, ignorieren Sie .DS_Store und Namensmuster wie *.crdownload. Setzen Sie Debounce 1–3 Sekunden und bestätigen Sie das Dateiende mit zwei stat-Abfragen im Abstand von etwa 500 ms bei gleicher Größe, bevor der Job startet. Für ausführliche Muster zu Logs und Wiederholungen siehe Watch, Retry & Log-Archiv.
ICC- und Farbprofil-Validierungsregeln
Definieren Sie eine Whitelist erlaubter Profilbeschreibungen — z. B. sRGB IEC61966-2.1 oder ein firmeneigenes ICC unter /Library/ColorSync/Profiles/. Lesen Sie pro PNG die Metadaten mit exiftool oder prüfen Sie mit sips -g profile, ob ein Profil gebunden ist. Policy-Beispiel: fehlendes iCCP → Verschieben nach failed/no_icc/ und JSONL-Eintrag reason=missing_profile; falsches Profil → optional sips -m nur wenn Ihre Lieferrichtlinie eine konvertierte Ausgabe erlaubt — sonst ablehnen, um Doppelkonvertierung zu vermeiden. Abstimmung mit Design zu sRGB vs. Display P3 separat in der Team-Checkliste dokumentieren.
Benennungsvorlage, Archiv & Fehler-Retry
Verwenden Sie ein deterministisches Template wie {projekt}_{viewport}_{YYYYMMDD}_{hash8}.png und schreiben Sie freigegebene Dateien nach out/releases/YYYY-MM-DD/. Schreiben Sie pro Lauf eine Zeile nach logs/processing.jsonl mit Quellpfad, Zielpfad und Validierungsergebnis. Bei transienten Fehlern Retry mit Backoff 5 / 20 / 60 s; nach drei Fehlschlägen Datei nach failed/ verschieben und nicht endlos wiederholen. Korrupte oder null-byte PNGs separat taggen, damit Ops sie manuell sichten kann.
Entscheidungsmatrix: Profil-Prüfung
| Option | Eignung | Hinweis |
|---|---|---|
exiftool |
Schnelle Textausgabe, gut in Skripte parsbar | Installation per Homebrew; Exit-Code in Pipeline auswerten |
sips -g profile |
Native macOS-API, keine Extra-Dependencies | Ausgabeformat fest einregexen; weniger Detail als exiftool |
| OpenClaw-Skill ruft Validator | Zentrale Orchestrierung, wiederverwendbar für andere Assets | Gateway-Verfügbarkeit überwachen |
Ablauf-Checkliste (reproduzierbar)
- Verzeichnisbaum anlegen und Rechte prüfen.
- Watch-Pfad, Glob, Debounce und Ignore-Liste setzen.
- Validator-Befehl und Whitelist in
README.mdam Repo-Rand festhalten. - Rename-Template und Ziel-
releases/-Struktur aktivieren. - Retry-Policy und
failed/-Quarantäne testen (künstlich beschädigte PNG). - Optional: Gateway-Health alle 60 s loggen.
Kennzahlen & Policy-Hinweise (zitierfähig)
- Debounce 1–3 s reduziert Doppeljobs bei burstartigen Schreibvorgängen typischer Browser-Exports messbar.
- Drei Retry-Versuche mit 5 / 20 / 60 s Backoff sind ein gängiger Kompromiss zwischen Robustheit und Warteschlangenlast.
- JSONL pro Datei ermöglicht spätere SQL- oder jq-Auswertung ohne Binärparser.
FAQ: Häufige Fehler & Meldungen
F: „Operation not permitted“ beim Zugriff auf ~/Downloads.
A: TCC und Dienstkonto prüfen; Worker und Terminal/SSH derselben UID zuordnen; ggf. Vollzugriff nur für den Batch-Account.
F: Validator meldet Profil, Browser zeigt trotzdem Farbverschiebung.
A: Anzeige ohne Farbmanagement oder CMS, das iCCP ignoriert — Lieferpolicy mit Frontend abstimmen, nicht nur die Datei „grün“ werten.
F: Gleiche PNG zweimal verarbeitet.
A: Debounce erhöhen, auf temporäre Suffixe filtern, idempotentes Ziel benutzen (Hash im Dateinamen).
F: Leere oder 0-Byte-Dateien in out/.
A: Stabilitäts-Check vor Job; bei Sync-Tools Cooldown nach letztem Schreibzugriff.
MacPng stellt Hilfe und Angebotsübersichten ohne Login bereit — parallel zu diesem HowTo die Hilfe-Seite nutzen.
Dedizierter Apple-Silicon-Knoten für Watch & Validierung
Wenn Browser-Export-Watches und ICC-Checks Ihr lokales Gerät blockieren, lohnt ein Remote Mac mit stabilen Pfaden und LaunchAgents. Preise und Pakete sind auf MacPng ohne Anmeldung einsehbar; Anschluss per SSH/VNC erklärt die Hilfe. Vertiefend: PNG-Auto-Naming & Batch-Validierung, PNG-QA-Batch, sRGB/P3-Checkliste sowie Technik-Insights zu OpenClaw und Design-Automation.