Designer, Kolleginnen und Kollegen in der Frontend-Asset-Vorbereitung sowie Verantwortliche für Automatisierung brauchen oft einen Master-Export, der sich in ein konsistentes Batch-PNG-Set aufteilt (1x/2x, Thumbnails, Social-Zuschnitte) – mit vorhersagbarer Namenskonvention. Auf einem Remote Mac kann OpenClaw einen Ordner überwachen, Skalierung und optionale QA-Schritte ausführen und einen sauberen out/-Baum bereitstellen. Dieses tutorialartige HowTo führt durch Umgebungsaufbau, Lauf- und Deployment-Ablauf, eine praxisnahe Größenmatrix, Protokollierung und Fehler-Retry, die Anbindung an die Design-Ablieferung sowie ein FAQ – damit dieselben Schritte morgen auf einem anderen Rechner reproduzierbar bleiben. Grundlagen zur Installation: OpenClaw Installationsleitfaden; für reine Umbenennungs-Pipelines: Design-Pipeline: Ordner überwachen & PNG umbenennen.
Inhalt
Verzeichnisstruktur & Berechtigungen
Batch-Pipelines für Design-Assets scheitern oft leise, wenn Pfade und Dateibesitzer nicht zusammenpassen. Bevor ein Watcher startet, richten Sie den Baum einmal sauber ein und testen Schreibzugriffe.
Empfohlene Ordnerlogik (Wurzel an Home oder freigegebenes Volume anpassen):
~/DesignPipeline/inbox— hier exportieren Figma, Sketch oder Affinity; die Ordnerüberwachung beobachtet ausschließlich dieses Verzeichnis.~/DesignPipeline/staging— der Worker verschiebt oder kopiert „beanspruchte“ PNGs während der Skalierung, damit Teil-Schreibvorgänge ininboxnicht mit dem nächsten Export kollidieren.~/DesignPipeline/out— fertiges Multi-Größen-Set pro Asset, bereit für Git LFS, CDN oder ZIP-Übergabe.~/DesignPipeline/failed— quarantänierte Eingaben plus Zeilen infailed.jsonlfür idempotente Nachläufe.~/DesignPipeline/logs— rotierende Job-Logs (tages- oder deployweise).
Berechtigungs-Checkliste:
- OpenClaw,
fswatchund Shell-Skripte unter einem macOS-Benutzer ausführen – derselbe Account wie bei SSH oder LaunchAgent. - Dieser Benutzer sollte
inboxbislogsbesitzen; keine world-writable Verzeichnisse. Schreibt ein anderes Konto, gruppenbasierte ACLs oder eine kleine Drop-Gruppe nutzen. - Absolute Pfade in der Konfiguration (
$HOME/DesignPipeline/...), damit LaunchAgents undcronsich wie interaktive Shells verhalten. - Preflight: Testdateien per
touchin jedem Ordner; prüfen, ob der Workerinboxlesen undstaging/out/failed/logsschreiben darf.
Sind Rechte vorhersagbar, lässt sich der Watch-Task im Team und bei wiederholten Deployments ohne Überraschungen erneut aufsetzen.
Konfiguration der Überwachungsaufgabe
Die Überwachungsschicht soll auf fertig geschriebene PNGs reagieren – nicht auf jede temporäre Datei Ihrer Design-App.
Kernoptionen:
- OpenClaw Watch-Skill / Task — beobachteten Pfad, Datei-Glob (
*.png) und Cooldown (Debounce 1–3 s) setzen, damit Speicher-Bursts zu einem Job zusammenlaufen. - fswatch + Worker —
brew install fswatch; Events in ein Skript pipen, das Jobs für OpenClaw einreiht oder ImageMagick/sipsdirekt aufruft. Prozess intmux,screenoder per LaunchAgent für 24/7-Betrieb auf dem Remote Mac halten.
Umgebung einrichten (kurz): Laufzeitversionen (Node/Python) und CLI-Tools im README neben der Config pinnen; PATH in LaunchAgent explizit setzen, falls brew-Binaries fehlen.
Deployment-Ablauf (überblick):
- OpenClaw gemäß Plattform-Installationsleitfaden installieren; Versionen dokumentieren.
watch.yamlbzw. Umgebungsvariablen versionieren:INBOX,STAGING,OUT,FAILED,LOG_DIR, maximale Parallelität.- Smoke-Test: eine PNG in
inboxlegen; im Log eine Job-ID und Dateien unterout/<slug>/verifizieren. - LaunchAgent oder Supervisor registrieren, damit der Watcher Logouts überlebt; auf gemieteten Hosts Ruhemodus für lange Batches deaktivieren.
Praktischer Zusatz: .done-Sidecar oder stabile Dateigröße (zwei identische stat-Abfragen im Abstand von 500 ms) – so landen halb geschriebene Exporte nicht in der Queue. Vertiefung zu Retry und Log-Rotation: PNG-Watch-Folder, Retry & Log-Archiv.
Multi-Größen-Vorlagentabelle
Aus einer Quell-PNG wird ein konsistent benanntes Set. Die folgende Starter-Multi-Größen-Vorlage können Sie in Config, CSV oder ein Manifest übernehmen, das der Worker einliest.
| Rolle | Lange Kante / Kasten | Suffix-Token im Dateinamen | Hinweise |
|---|---|---|---|
| Web 1x | 800 px Breite | _w800 |
Baseline für Marketing-Seiten |
| Web 2x | 1600 px Breite | _w1600 |
Retina; sRGB-Profil mit Master abgleichen |
| Thumbnail | 256×256 Cover | _thumb256 |
Quadratische Zuschnitt-Policy pro Marke dokumentieren |
| Open Graph | 1200×630 | _og1200x630 |
Sichere Text-Ränder in der Design-Datei |
| Story / vertikal | 1080×1920 | _story1080x1920 |
Optional; Namens-Playbook: Social-PNG-Batch per API |
Namensvorlage (regex-freundlich): {projekt}__{komponente}__{variante}_{token}.png — kleingeschrieben, doppelter Unterstrich zwischen Semantik-Ebenen, einfacher Unterstrich vor dem Größen-Token. Beispiel: acme__hero__fruehjahr_w1600.png. Speichern Sie projekt und komponente in einer Sidecar-.json oder leiten Sie sie aus übergeordneten Ordnernamen ab, damit Batch-PNG-Ausgaben eindeutig bleiben, wenn Designer weiterhin generische Namen wie Frame 123.png exportieren.
Umsetzung: sips -Z oder ImageMagick -resize mit einheitlichem Filter; Encoder-Einstellungen pro Lauf protokollieren. Nach dem Schreiben Maße validieren (Job fehlschlagen lassen, wenn Breite/Höhe vom Soll abweicht). Ergänzend: PNG-Auto-Naming & Batch-Validierung und Asset-Pipeline: PNG umbenennen.
Protokolle & Fehler-Retry
Robuste Automation trennt „defekte Datei überspringen“ von „transienten Fehler erneut versuchen“.
- Strukturierte Logs: eine Zeile pro Ereignis (JSON oder Schlüssel=Wert) mit
job_id, Quellpfad, Variantenliste, Dauer, Exit-Code. Täglich rotieren, damit die SSD auf einem geteilten Remote Mac planbar bleibt. - Fehlerklassen: korruptes PNG → nach
failed/verschieben und anfailed.jsonlanhängen; Speicher voll / Timeout → Retry mit exponentiellem Backoff (z. B. drei Versuche: 5 s / 20 s / 60 s). - Retry-Playbook: nach Ursachenbehebung
failed.jsonlzuerst mit Dry-Run abspielen, dann begrenzte Batches. Obergrenze pro Asset, um Endlosschleifen bei kaputten Mastern zu vermeiden. - QA-Gate: optional OpenClaw PNG-QA (Dateigröße, Alpha-Anteil, Maße) vor der Promotion von
stagingnachouteinhängen.
Ein „last good“-manifest.json (Hash + Ausgabepfade) hilft dem Frontend, Änderungen zwischen Releases nachzuvollziehen.
Anbindung an die Design-Ablieferung
Automatisierung zahlt sich aus, wenn Downstream-Teams dem Bundle vertrauen.
out/mitmanifest.jsonveröffentlichen: logisches Asset, Varianten, Byte-Größe, Hinweis sRGB/P3 – im Einklang mit PNG-Farbmanagement sRGB vs. Display P3.- Gemischte moderne Formate: Spezifikationen mit WebP/AVIF & PNG in der Ablieferung verknüpfen, damit klar ist, welche Slots Raster-only bleiben.
- Kommunikation: kurzer Eintrag (Chat/Wiki) mit Inbox-Pfad, Namens-Spickzettel und SLA („Exporte stehen innerhalb von N Minuten in
out“).
So schließen sich Design-Tools, OpenClaw-Worker und Frontend-Konsum ohne Ad-hoc-Neuexporte.
FAQ zur Fehlerbehebung
F: Der Watcher feuert doppelt für einen Export.
A: Debounce erhöhen; versteckte Dateien ignorieren; prüfen, ob die App kein Temp-.png~ im gleichen Ordner schreibt.
F: Skalierte PNGs wirken weich oder verfärbt.
A: Master-Export-Profil zuerst fixen; keine doppelte Farbkonvertierung; Abgleich mit sRGB vs. Display P3.
F: „Permission denied“ mitten im Batch.
A: LaunchAgent-Benutzer = interaktiver SSH-Benutzer; in der plist ~ durch $HOME in EnvironmentVariables ersetzen.
F: Speicher voll bei 2x-Varianten.
A: out-Größe schätzen (Summe der Varianten-Bytes); Disk-Wasserstand vor Jobs; alte out-Builds archivieren.
F: API-getriebene Batches statt Ordner-Drop.
A: API-Batch-Playbook nutzen; dieselbe Namensvorlage für zusammengeführte Pipelines beibehalten.
Weitere OpenClaw- und Design-Automation-Artikel im Archiv der Technik-Insights; Zugang und Einrichtung jederzeit über die Hilfe- und Anleitungsseiten – ohne Login-Pflicht für die öffentlichen Hilfetexte.
Watch-Folder-PNG-Sets auf dedizierter Hardware laufen lassen
Wenn Ihr Laptop keine nächtlichen Batch-PNG-Jobs tragen soll, bietet ein Remote Mac einen Ort für OpenClaw, native Design-Apps und Unix-Tooling. Vergleichen Sie Angebote und Knoten auf MacPng ohne Anmeldung, nutzen Sie SSH/VNC-Hilfe zum Verbinden und deployen Sie dieses HowTo unverändert auf Ihrer Instanz. Für Einstieg und Vertiefung: Blog-Übersicht und die verlinkten OpenClaw-Design-Artikel oben.