2026 OpenClaw Batch-Praxis: API & Skript-Templates für Multi-Plattform-Social-PNGs auf Remote Mac

Drei typische Bremsklötze beim Social-PNG-Batch

1. Inkonsistente Größen: Ohne feste Manifest-Datei entstehen fast identische Dateinamen mit abweichenden Pixelmaßen – Upload-Tools und Kampagnen-Reports brechen.
2. API-Schlüssel im Klartext: Keys in Skripten oder Screenshots landen im Chat; ohne Gateway und Rotation ist der Schaden größer als ein fehlgeschlagener Batch.
3. Keine Retry- und Quarantäne-Logik: Ein 429 oder Netzwerk-Timeout bricht den kompletten Lauf, halbfertige PNGs werden trotzdem weitergegeben.

Entscheidungsmatrix: API-Pfad vs. reines Skript

In der Praxis mischen Teams oft: API für Erst-Render, sips für harte Pixel-Assertions und manuelle Qualitätsgates vor dem Upload.

Umgebung auf dem Remote Mac

Wiederholbarkeit braucht eine Maschine, die sich nicht wöchentlich „von selbst“ verändert. Auf der gemieteten oder dedizierten Mac-Instanz sollten Sie Folgendes fixieren:

• Benutzer und Pfade: Ein Login für Batch-Jobs, festes $HOME, absolute Pfade in Configs. Keine iCloud-Desktop-Ordner; besser /Users/batch/jobs/ oder eigenes Volume.
• OpenClaw-Version: Gleicher Release-Tag oder Docker-Image überall. openclaw --version zu Kampagnenbeginn in logs/env-snapshot.txt schreiben.
• Bild-Tools: macOS-sips reicht oft zur Breiten-/Höhenprüfung. Optional ImageMagick oder pngcheck für Alpha-Audits; Installation per Homebrew, Brewfile im Repo pinnen.
• Egress: Prüfen, ob der Mac Modell-API und Storage ohne Browser-Login erreicht. Kurzer Smoke-Test: ein HEAD-Request plus ein Mini-Render.

API-Keys, Gateway, Least Privilege

Den API-Key wie ein Passwort zu behandeln reicht nicht – Sie müssen den Schaden begrenzen, wenn ein Skript leakt oder jemand einen Ordner kopiert.

• Nicht in Git: .env in .gitignore. Unter macOS lieber security add-generic-password oder ein Helper, der Variablen nur für die Job-Session exportiert.
• Gateway statt Roh-Key: Dünner Reverse-Proxy (Caddy/nginx) auf Remote Mac oder in der VPC mit Auth, Rate-Limits und IP-Allowlist. OpenClaw ruft https://gateway.internal/v1/... mit kurzlebigem JWT auf – nicht den Master-Key des Providers.
• Scoped Keys: Im Provider nur Bild-Endpunkte und monatliche Caps. Nach Screen-Sharing mit sichtbarem Terminal rotieren.
• Logs: Authorization-Header aus Access-Logs strippen. Job-Logs nach logs/run-YYYYMMDD-HHMM.jsonl mit Request-IDs, ohne volle Payloads mit Geheimnissen.

Dieselben Regeln gelten für OpenClaw-Skills mit Dateizugriff oder HTTP: Hosts whitelisten, Payload-Größe begrenzen, beliebige Shell nur nach Review.

Plattform-Größenmatrix (Start-Manifest)

Specs ändern sich; versionieren Sie diese Tabelle als JSON oder CSV. Maße in Pixel, PNG, sRGB.

Spalten platform, width, height, slug in manifest.csv – neue Netzwerke sind eine Zeile, kein Umbau der Schleife.

Prompt- und Skript-Templates

LLM-Bildpfad: „Was gezeichnet wird“ und „wie exportiert wird“ trennen. System-Block einfrieren, nur Variablen im User-Block.

SYSTEM (fix):
Du erzeugst Marketing-Stillleben. Ausgabe: ein PNG, sRGB, ohne Rand, ohne Wasserzeichen.
Halte exakt width x height ein. Bei falschen Maßen: ERROR_DIMS, kein Erfolg vortäuschen.

USER (pro Zeile):
Kampagne: {{campaign_slug}}
Brief: {{brief_one_line}}
Größe: {{width}}x{{height}} px
Datei-Stamm: {{campaign_slug}}__{{platform}}__{{width}}x{{height}}

Shell-Glue: Schleife liest manifest.csv, ruft OpenClaw-CLI oder HTTP-Skill mit JSON {"prompt":"...","out":"staging/..."} auf, danach sips -g pixelWidth -g pixelHeight. Nur bei Match per mv nach out/ – lokal oder API gleiche Kontrollfluss.

Retries, Validierung, Benennung

Fehler sind Routine: Rate-Limits, TLS, Policy, falsches Seitenverhältnis. Machen Sie das Versagen ebenso routiniert.

• Retry: Exponentielles Backoff mit Jitter: 2s, 4s, 8s, Deckel 60s; max. 5 Versuche pro Asset. 429 und 5xx retry-fähig; 400 bei Policy nicht – loggen und überspringen.
• Dimensions-Gate: Nach jedem Write width == erwartet && height == erwartet. Bei Abweichung nach failed/dim-mismatch/ plus Zeile in logs/errors.jsonl.
• Namen: {{campaign_slug}}__{{platform}}__{{width}}x{{height}}.png – doppelter Unterstrich trennt Ebenen; klein geschrieben; Bindestriche nur innerhalb von Slugs. Keine Leerzeichen oder lokalisierten Sonderzeichen.
• Idempotenz: Bei Regenerierung Hash oder Kurz-Checksum in .meta.json, um veraltete out/-Dateien zu erkennen.

Ordner-Ausgabe-Konvention

Ein Baum pro Kampagne, damit Design, PM und Skripte dieselbe Sprache sprechen:

~/jobs/{{campaign_slug}}/
  manifest.csv
  inbox/           # optionale Quellen-Exports
  staging/         # Roh-Output, verwerfbar
  out/             # geprüfte PNGs für Upload
  failed/          # Maßfehler, Policy, korrupt
  logs/            # jsonl, env-snapshot
  archive/         # zip von out/ + manifest für Übergabe

Tagesabschluss: zip -r archive/{{campaign_slug}}-$(date +%Y%m%d).zip out manifest.csv logs/env-snapshot.txt liefert ein prüfbares Paket. Anschließend Watch-Folder-Umbenennung: OpenClaw Watch-Folder & PNG-Umbenennung.