2026 OpenClaw in Practice: Remote Mac Steps to Batch-Validate App Icon PNG Dimensions vs Contents.json and Generate Fix Reports

Why catalog drift still happens

1. Scale math errors: one master is copied to 2× and 3× without recomputing pixels; filenames match Contents.json while geometry does not.
2. Stale JSON: PNG renames without updating every images entry create orphans and missing references.
3. Silent resizes: optimizers or padding steps change edge lengths while previews still look fine.

A gate before merge or upload turns these into single-line report rows instead of midnight build breaks.

Choose your automation shape

Install, configure, and run (five moves)

1. Install OpenClaw and helpers: install OpenClaw on the worker using the project’s standard bootstrap, add jq, and confirm sips -g pixelWidth -g pixelHeight works on sample PNGs.
2. Pin the target catalog: export APPICON_DIR=/path/to/AppIcon.appiconset and REPORT_PATH=./logs/appicon_fix_report.md. Record git rev-parse HEAD at the top of the report for traceability.
3. Lint Contents.json: run plutil -lint Contents.json. Fix syntax before any pixel logic; malformed JSON causes false negatives.
4. Compute expected pixels: for each images[] item with a filename, parse size like 60x60 and scale like 2x. Expected edge length equals base points multiplied by the integer scale factor (2× → 2, 3× → 3).
5. Measure and diff: for every referenced PNG, read actual width and height. Append a Markdown row when they differ. Exit non-zero if any mismatch remains so CI or OpenClaw can quarantine the job.

Watch hook and batch script templates

Debounced watch: after inbox/appicon/ is idle ~45s, copy to work/, validate, promote to out/ with report.md, or move failures to failed/.

Batch slice: loop all *.appiconset trees under Assets.xcassets for white-label repos; concatenate nightly Markdown.

#!/usr/bin/env bash
set -euo pipefail
DIR="${1:?path to AppIcon.appiconset}"
REPORT="${2:-./appicon_validation_report.md}"
JSON="$DIR/Contents.json"
{
  echo "# AppIcon validation"
  echo "- host: $(hostname)"
  echo "- path: $DIR"
  echo ""
  echo "| filename | expected | actual | status |"
  echo "|---|---:|---:|---|"
} > "$REPORT"
while read -r name w h; do
  [[ -z "${name:-}" ]] && continue
  fp="$DIR/$name"
  if [[ ! -f "$fp" ]]; then
    echo "| $name | ${w}x${h} | missing | FIX: add file |" >> "$REPORT"
    continue
  fi
  read -r aw ah < <(sips -g pixelWidth -g pixelHeight "$fp" \
    | awk '/pixelWidth/ {w=$2} /pixelHeight/ {print w, $2}')
  if [[ "$aw" -eq "$w" && "$ah" -eq "$h" ]]; then
    echo "| $name | ${w}x${h} | ${aw}x${ah} | OK |" >> "$REPORT"
  else
    echo "| $name | ${w}x${h} | ${aw}x${ah} | FIX: re-export |" >> "$REPORT"
  fi
done < <(jq -r '.images[] | select(.filename!=null)
  | [.filename,
      ((.size|split("x")[0]|tonumber) * (.scale|sub("x";"")|tonumber)),
      ((.size|split("x")[1]|tonumber) * (.scale|sub("x";"")|tonumber))]
  | @tsv' "$JSON")
echo "Wrote $REPORT"

Extend the jq filter for ipad-only rows or missing scale; always derive expected pixels from JSON. After geometry passes, stack PNG QA batch for alpha, ICC, and byte caps.

Numbers and policies worth quoting

• Classic scales: 1× / 2× / 3× map to multipliers 1, 2, and 3 for edge length from size in Contents.json.
• Debounce & retention: use thirty to sixty seconds idle on watched trees; keep ~thirty days of Markdown or JSONL beside logs/ for diffable release history.

FAQ: common errors

Run this flow on a dedicated remote Mac so laptops stay free for creative work while OpenClaw owns overnight validation. Browse the full Tech Insights library for adjacent automation articles.