① 대상: 디자이너, 프론트엔드 소재 준비 담당, 자동화 운영자 — 마스터 PNG 한 장에서 배치 PNG(1x/2x, 썸네일, 소셜 크롭)를 예측 가능한 이름 규칙으로 뽑아야 할 때.
② 키워드: OpenClaw, 원격 Mac, 배치 PNG, 폴더 감시, 이름 규칙. 환경·실행·배포·오류를 HowTo로 정리했습니다. 선행: 설치 가이드, 감시·PNG 자동 이름 변경.
디렉터리 구조와 권한
경로·소유자가 어긋나면 배치 PNG 파이프라인이 조용히 멈춥니다. 감시 전 트리를 한 번 고정하세요.
권장 레이아웃(루트는 홈 또는 전용 볼륨으로 조정):
~/DesignPipeline/inbox— 디자인 도구가 여기로 보냄. 폴더 감시는 이 디렉터리만 봅니다.~/DesignPipeline/staging— 워커가 “클레임”한 PNG를 리사이즈하는 동안 둠.inbox의 부분 쓰기와 다음 보내기가 충돌하지 않게 합니다.~/DesignPipeline/out— 자산별 다중 크기 세트. Git LFS·CDN·압축 납품의 최종물.~/DesignPipeline/failed— 격리 입력과 멱등 재실행용failed.jsonl.~/DesignPipeline/logs— 일 단위 또는 배포별 로그 로테이션.
권한·환경 체크리스트: OpenClaw·fswatch·스크립트를 SSH와 같은 macOS 사용자로 실행하고, 그 사용자가 트리 전체를 소유(Figma 등 다른 UID면 ACL). 설정은 $HOME/... 절대 경로. touch로 읽기·쓰기 사전 확인.
iCloud 등 동기 폴더는 감시에서 빼세요. 전체 그림은 디자인 소재 파이프라인(PNG 이름)과 맞추면 온보딩이 빨라집니다.
감시 작업 구성
감시 계층은 디자인 앱이 만드는 임시 파일이 아니라 쓰기가 끝난 PNG에만 반응해야 합니다.
핵심 옵션
- OpenClaw 감시 태스크 — 경로, 글롭(
*.png), 쿨다운(디바운스 1~3초)으로 연속 저장을 한 작업으로 합칩니다. - fswatch + 워커 —
brew install fswatch후 이벤트를 큐에 넣어 OpenClaw 또는 ImageMagick·sips로 넘깁니다.tmux/screen또는 LaunchAgent로 원격 Mac 상시 가동을 보장합니다.
배포·실행 요약: 설치 후 버전을 README에 고정하고, watch.yaml·환경 변수로 경로·동시 작업 수를 스냅샷합니다. PNG 한 장으로 스모크한 뒤 LaunchAgent로 상시 구동·절전 해제를 확인하세요. .done 또는 두 번 연속 동일 stat으로 쓰기 완료를 보장하면 미완성 파일이 큐에 안 들어갑니다. 재시도·로그는 감시·재시도·로그 아카이브 HowTo와 함께 쓰면 좋습니다.
다중 크기 템플릿 표
원본 PNG를 배치 PNG 세트로 펼칠 때 쓰는 시작 표입니다(설정·CSV·JSON 매니페스트에 복사 가능).
| 역할 | 긴 변·박스 | 파일명 접미 토큰 | 비고 |
|---|---|---|---|
| 웹 1x | 너비 800px | _w800 |
랜딩·캠페인 기본 |
| 웹 2x | 너비 1600px | _w1600 |
레티나; 마스터와 동일 ICC(sRGB 권장) |
| 썸네일 | 256×256 커버 | _thumb256 |
정사각 크롭 정책은 브랜드 문서에 명시 |
| Open Graph | 1200×630 | _og1200x630 |
안전 여백은 디자인 파일에서 확보 |
| 스토리·세로 | 1080×1920 | _story1080x1920 |
캠페인 이름 규칙은 소셜 PNG 배치 가이드와 통일 |
이름 템플릿: {project}__{component}__{variant}_{token}.png(소문자·이중 밑줄·크기 접미). 예: acme__hero__spring-promo_w1600.png. Frame 123.png류는 폴더·.json에서 project·component를 채워 충돌 방지.
sips -Z 또는 ImageMagick -resize 필터를 고정하고, 기록한 해상도가 기대와 다르면 실패 처리해 out 오염을 막습니다. PNG 자동 이름·일괄 검증과 연결하세요.
로그와 실패 재시도
나쁜 입력은 격리하고, 일시 오류만 백오프 재시도합니다.
- 로그:
job_id·경로·변형·종료 코드를 한 줄 JSON으로 남기고 일 단위 로테이션. - 분류: 손상 PNG는
failed/+failed.jsonl; 디스크·타임아웃은 지수 백오프(예: 3회 5s/20s/60s). - 재시도: 원인 수정 후
failed.jsonl드라이런→상한 배치. 자산당max_retry로 무한 루프 차단. - QC:
staging→out전 PNG 일괄 QC 선택 연결.
“마지막 정상 매니페스트”(해시·경로)를 단일 소스로 두고 릴리스 diff에 씁니다.
디자인 납품과의 연결
out/+manifest.json(자산 ID·변형·바이트·색 메모) — 색 관리 체크리스트와 정합.- WebP·AVIF 병행 시 혼용 납품 가이드로 PNG 슬롯 고정.
- 팀 공지에 inbox 경로·이름 치트시트·SLA(N분 내
out) 명시.
디자인 도구→워커→프론트가 재수출 없이 닫힌 루프로 이어집니다.
문제 해결 FAQ
한 번 보냈는데 감시가 두 번 도는 것 같아요.
디바운스 시간을 늘리고, 숨김 파일·임시 .png~를 무시하세요. 디자인 앱이 같은 폴더에 임시를 쓰는지 확인합니다.
리사이즈 PNG가 흐리거나 색이 바뀌어요.
마스터 보내기 프로파일을 먼저 고정하고 이중 색 변환을 피하세요. sRGB·Display P3 가이드와 비교 검증합니다.
배치 중간에 Permission denied가 납니다.
LaunchAgent 사용자와 대화형 SSH 사용자가 같은지 확인하고, plist의 EnvironmentVariables에는 ~ 대신 $HOME을 씁니다.
2x 변형 만들다 디스크가 부족해요.
out 예상 용량 ≈ 변형별 바이트 합으로 산정하고, 작업 전 디스크 워터마크를 두며 오래된 out 빌드는 아카이브합니다.
폴더 드롭 대신 API로 배치하고 싶어요.
API 배치 가이드로 키 기반 작업을 쓰되, 병합 파이프라인에서는 동일 이름 규칙을 유지합니다.
OpenClaw·디자인 자동화는 기술 인사이트에서 이어 읽으세요. 구매·대여·요금은 로그인 없이 비교하고, 도움말로 이 HowTo를 그대로 배포하세요.