2026 OpenClaw in der Praxis: Auf dem Remote Mac den Unity-SpriteAtlas-Exportordner überwachen und PNG-Atlanten auf POT-Maße, Alphakanal und Byte-Schwellen prüfen

Verzeichnisüberwachungsstrategie · Batch-Befehlsvorlagen · Fehler-Retry und Log-Archivierung · Troubleshooting-FAQ

Vertiefende Artefakte: Sprite-Slice-Matrix (Web/CSS) für Namens- und Dichte-Entscheidungen, Watch, Retry und Log-Rotation als generisches Betriebsgerüst, pngquant/zopflipng wenn Sie nach dem Gate noch Bytes kappen dürfen. Für UI-getriebene Aktivierung siehe Gateway und Kurzbefehle.

Verzeichnisüberwachungsstrategie

Legen Sie im Projekt einen festen Stamm an, z. B. Exports/SpriteAtlas/ auf einer lokalen NVMe — nicht im synchronisierten Creative-Cloud-Ordner, weil Latenz und Zwischenstände Ihre identify-Aufrufe flattern lassen. Ein kleines Editor-Skript (oder ein Postprocessor-Paket) schreibt zuerst atlas_hud_512.png.tmp, schließt den Stream und benennt atomar per mv in .png um. Nur so kann ein Watch sauber zwischen „Datei existiert“ und „Datei konsistent“ unterscheiden.

Installieren Sie fswatch per Homebrew und lassen Sie es nur diesen Unterbaum beobachten. Implementieren Sie ein Ruhefenster (häufig 8–20 Sekunden ohne neues Event), bevor ein Job startet — Unity schreibt oft mehrere Texturen nacheinander, und ein voreiliger Scan meldet Pseudofehler. Ergänzen Sie ein .lock-File im logs/-Verzeichnis, damit niemals zwei Worker gleichzeitig find … -print0 fahren. Auf dem Remote-Host gehört der Dienst in einen LaunchAgent mit ThrottleInterval, damit Crash-Loops den Login nicht fluten.

OpenClaw-seitig mappen Sie nur zwei Schreibbereiche: den Exportstamm und logs/ plus quarantine/. Alles andere bleibt geschlossen — das reduziert Tool-Allowlist-Reviews auf wenige Zeilen und macht Security-Freigaben reproduzierbar.

Beispielinstanz: Projekt /Volumes/StudioNVMe/ClientA_Unity/, Exportziel …/Exports/SpriteAtlas/build_042/. Unity schreibt nach jedem „Apply“ im SpriteAtlas-Importer; Ihr Watch sollte nicht den gesamten Library/-Cache beobachten, sondern ausschließlich den veröffentlichten Staging-Ordner, den Ihr Build-Skript leert und neu füllt. So bleibt die Ereignisflut begrenzt und Sie können pro Build-Nummer ein separates Logfile öffnen.

Batch-Befehlsvorlagen

Die folgende Schleife ist absichtlich POSIX-bash ohne Zusatztools jenseits von ImageMagick; sie schreibt eine JSONL-Zeile pro Datei und setzt ok auf 0, sobald POT, Alpha oder Bytes verletzt sind. Passe MAX_BYTES pro Plattformtabellenzeile an (iOS vs Desktop).

#!/usr/bin/env bash
set -euo pipefail
ROOT="${ATLAS_EXPORT_ROOT:?}"
MAX_BYTES="${MAX_BYTES:-1200000}"
REQUIRE_ALPHA="${REQUIRE_ALPHA:-1}"
LOG_DIR="${LOG_DIR:-./logs}"
mkdir -p "$LOG_DIR" ./quarantine

is_pot() { local n="$1"; [[ "$n" =~ ^[0-9]+$ ]] && (( (n > 0) && (n & (n-1)) == 0 )); }

while IFS= read -r -d '' f; do
  [[ "$f" == *.png ]] || continue
  w=$(magick identify -format '%w' "$f")
  h=$(magick identify -format '%h' "$f")
  ch=$(magick identify -format '%[channels]' "$f")
  bytes=$(stat -f%z "$f")
  ok=1
  is_pot "$w" || ok=0
  is_pot "$h" || ok=0
  [[ "$REQUIRE_ALPHA" == "1" && "$ch" != *rgba* ]] && ok=0
  (( bytes <= MAX_BYTES )) || ok=0
  printf '{"ts":%s,"file":"%s","w":%s,"h":%s,"channels":"%s","bytes":%s,"ok":%s}\n' \
    "$(date +%s)" "$f" "$w" "$h" "$ch" "$bytes" "$ok" >> "$LOG_DIR/atlas-scan.jsonl"
  if [[ "$ok" -eq 0 ]]; then
    base=$(basename "$f")
    mv "$f" "quarantine/${base}.$(date +%s).fail"
  fi
done < <(find "$ROOT" -type f -name '*.png' -print0)

Erweiterung für Teams, die mehrere Verträge im selben Ordner halten: lesen Sie pro Unterordner eine Mini-policy.yaml (max_bytes, require_alpha) ein und rufen Sie das Snippet in einer inneren Funktion auf. So bleibt Unity flexibel, der Scanner aber strikt versioniert.

Für Stichproben auf dem Terminal genügt oft eine Einzeiler-Sonde, bevor Sie den Daemon aktivieren:

f=/Volumes/StudioNVMe/ClientA_Unity/Exports/SpriteAtlas/build_042/hud.png
magick identify -format 'w=%w h=%h ch=%[channels] depth=%[bit-depth]\n' "$f"
stat -f 'bytes=%z' "$f"

Vergleichen Sie die Ausgabe mit Ihrer README: z. B. w=1024 h=512 ch=rgba depth=8 und bytes unterhalb der vereinbarten Obergrenze. Wenn depth=16 auftaucht, obwohl das Spiel 8-Bit erwartet, ist das ein Inhaltsfehler — nichts, was ein Retry behebt, sondern ein Rückfall in den Importer.

Fehler-Retry und Log-Archivierung

Trennen Sie transiente von permanenten Fehlern. Resource temporarily unavailable, kurzzeitig verschwindende Netzwerk-Mounts oder E/A-Störungen dürfen mit exponentiellem Backoff (2s, 4s, 8s, Deckel 60s) erneut versucht werden — aber nur, wenn die Datei noch im Exportordner liegt und weiterhin .png endet. POT-Verletzungen, falsche Kanäle oder überschrittene Byte-Limits sind keine Kandidaten für Auto-Retry: verschieben Sie sie nach quarantine/, annotieren Sie reason_code (pot, alpha, size) und lassen Sie OpenClaw eine Benachrichtigung auslösen.

JSONL wächst schnell; rotieren Sie nächtlich per gzip atlas-scan.jsonl && mv … archive/$(date +%F)/. Erfolgreiche Läufe können auf eine aggregierte Zeile pro Job reduziert werden, sobald CI grün war. Für Auditierbarkeit hängen Sie magick -version einmal pro Lauf als Kopfzeile an — sonst erklärt ein Minor-Upgrade plötzlich andere Kanalstrings.

Wenn OpenClaw Skills für Benachrichtigungen nutzt, halten Sie die Payload minimal: Pfad, reason_code, erste 120 Zeichen der letzten JSONL-Zeile. So bleiben Chat-Kanäle lesbar und Sie verletzen keine Geheimnisrichtlinien durch komplette Verzeichnislistings. Die Skills-Oberfläche selbst beschreibt der Artikel Skills-UI PNG-Watchdog — dieselben Filter lassen sich auf reason_code=size zuschneiden, damit nur Asset-Techs alarmiert werden.

Troubleshooting-FAQ

POT ok, aber Inhalt wirkt weich: Das Gate prüft keine inhaltliche Schärfe — das ist Pixels Per Unit plus Kamera-Orthographie. Dokumentieren Sie erwartete PPU-Werte neben dem Atlasnamen. Bytes schwanken täglich bei gleicher Szene: Prüfen Sie, ob unterschiedliche TextureImporter-Presets pro Plattform aktiv sind; fixieren Sie den Build-Target im Watch-Job. Nur nachts rote Logs: Energiesparmodus und externe Platten — pmset bzw. Hintergrundaktivität prüfen und launchd-StandardOutPath auf der internen SSD halten.

Gateway antwortet 401/403: Token in derselben Shellquelle wie der Agent (nicht nur im interaktiven Terminal) exportieren; Pfade case-sensitiv gegen die Allowlist diffen. Zu viele False Positives nach Unity-Upgrade: Vergleichen Sie identify-Ausgaben vor/nach Update; manchmal wechselt die Kanalnotation von rgba zu synonymen Schreibweisen — passen Sie den String-Match bewusst an, statt ihn zu lockern.

Kurzfassung: Atomarer Export (.tmp → .png), entprellter fswatch, ein Worker-Lock, magick identify plus stat, getrennte Retry-Pfade und täglich gzippte JSONL. Damit lässt sich dieselbe Pipeline auf jedem gemieteten Apple-Silicon-Knoten erneut ausrollen.