2026 OpenClaw 실전: 원격 Mac에서 Figma 수출 폴더를 감시해 PNG 일괄 워터마크·체크섬·버전 아카이브까지 재현하기

① 수출 디렉터리 규범과 권한

캠페인마다 절대 경로 하나로 Figma 로컬 수출을 고정하세요. SSH·launchd·OpenClaw는 동일 macOS 사용자만 쓰게 해 TCC·잠금을 단순화합니다.

권장 트리: inbox(감시) → staging(원자적 mv) → watermarked → archive(tar·매니페스트) · failed · logs(JSONL).

권한: 루트 chmod 750, plist에 HOME·절대 경로, ImageMagick은 brew install imagemagick. 네트워크 볼륨은 디바운스·로컬 복사로 보완. 수출 품질은 투명도 비교로 선행합니다.

감시 트리거 템플릿(fswatch·락):

ROOT="$HOME/FigmaDelivery"
INBOX="$ROOT/inbox"
fswatch -o "$INBOX" | while read -r _; do
  sleep 2
  flock -n "$ROOT/.watermark.lock" \
    bash -lc '$HOME/bin/figma-png-watermark-batch.sh --debounce-ok'
done

스크립트 내부에 추가 디바운스·크기 안정 확인·임시파일 제외를 넣으세요. PNG 세트 감시 참고.

② 워터마크 매개변수(위치·투명도·세이프 존)

가독·은은함·UI 세이프 존을 스크립트 상수로 고정하세요. 마크는 RGBA PNG(넓은 폭의 2×). SVG는 별도 래스터 후 캐시해 핫 경로에 넣지 마세요.

단일 파일 합성 템플릿(ImageMagick v7, 경로만 조정):

MAGICK_WATERMARK="$HOME/FigmaDelivery/assets/mark_rgba.png"
IN="$1"
OUT="$2"
magick "$IN" "$MAGICK_WATERMARK" -gravity SouthEast -geometry +32+32 \
  -compose dissolve -define compose:args=35 -composite "$OUT"

루프에서 stage=composite·ms 로그. 이후 무손실 축소는 ICC·재압축 단계로 분리합니다.

③ 체크섬 체크리스트와 버전 아카이브

체크섬으로 납품 바이트를 증거 번들화합니다.

매니페스트: 파일별 경로·sha256·크기·UTC mtime; 작업별 job_id·pipeline_version·워터마크 자산 해시·git_sha(선택). PNG QA 통과 후에만 manifest.jsonl append.

트리 전체 체크섬:

(cd "$WATERMARKED_DIR" && find . -name '*.png' -print0 | \
  sort -z | xargs -0 shasum -a 256) > "$ARCHIVE_DIR/manifest-${JOB_ID}.sha256"

아카이브: archive/drop_YYYYMMDDThhmmssZ_${GIT_SHORT:-local}.tar.gz에 산출물·매니페스트, 티켓에 동일 이름 기록. CMS용 스키마는 CLI 체인과 통일.

④ OpenClaw 트리거와 로그 환류

OpenClaw는 셸 엔트리포인트만 호출·종료 코드를 신뢰하세요. 트리거: fswatch→큐, 스킬 figma_png_watermark.run(JSON 인자·경로 allow-list), 또는 launchd 정각 배치.

로그: 단계별 JSONL 한 줄(stage·exit·ms)을 tail·웹훅. 스킬·런북은 스킬 가이드·지식 베이스로 버전 관리.

재시도: 일시 오류는 5s·20s·60s 백오프 최대 3회, 손상·정책 위반은 failed/. 감시·재시도 HowTo와 동일 서술을 유지하세요.

⑤ 자주 묻는 실패 FAQ

색이 탁함: 수출·합성 모두 sRGB, CMYK 마크 금지. 색 관리 체크리스트.

이중 워터마크: inbox→staging mv 또는 inode 캐시, job_id로 재실행 추적.

빈 tarball: tar 전 cd·절대 경로, stage=archive에 ls 로그.

4K 느림: magick 동시 실행 제한. 4K 일괄 큐 전략.

IPTC 후행: IPTC 감시를 워터마크 다음 단계로.

요약: 원격 Mac에 경로·매니페스트·JSONL을 고정하면 PNG 납품 분쟁이 줄고, 다중 크기 감시와 동일 어휘로 런북을 통합하세요. MacPng 홈·구매·대여·요금·도움말에서 노드를 고른 뒤 위 파이프라인을 그대로 올리면 됩니다.