대상: Lottie·타임라인 모션을 PNG 시퀀스로 넘기는 모션·옵스·플랫폼 팀.
목표: 원격 Mac에서 감시·상한 큐·분류 재시도·JSONL 로그·바이트·볼륨 임계·아카이브를 문서로 고정(OpenClaw는 좁은 도구만). FPS·색·명명은 Lottie → PNG 수용 매트릭스와 맞추면 QA가 같아집니다.
목차
장시간 모션 배치에 원격 Mac
수출은 짧은 시간에 대량 프레임을 쓰고 디스크·CPU를 몰아씁니다. 노트북은 절전·스로틀에 끊기기 쉽습니다. 전용 원격 Mac은 launchd/tmux로 상시 워커·절대 경로를 고정하고 큐·재시도·로그 런북을 팀이 공유합니다. 야간 처리와 주 후 재현에 유리하며 JSONL·매니페스트로 옵스·QA 시선을 맞출 수 있습니다.
디렉터리 레이아웃과 디바운스 감시
NVMe(클라우드 동기 제외)에 inbox·work·out·failed·quarantine·logs·archive를 두고 Lottie·사이드카만 받습니다. 워처는 안정 규칙 통과 후에만 enqueue합니다.
- Quiet window: 마지막 관측 쓰기 이후 대략 30~60초(스튜디오별 조정) 동안 매칭 파일이 없을 때 한 번 enqueue.
- 무시 목록:
.DS_Store, 에디터 임시, 0바이트 플레이스홀더를 건너뛰어 부분 수출이 중복 작업을 만들지 않게 함. - Single-flight:
job_id당 뮤텍스로 빠른 저장을 하나의 dequeue로 합치고coalesced_events를 감사 로그에 남김.
fswatch·launchd WatchPaths·소형 Python 등 구현은 하나로 정하고 스테이징과 동일 계약을 유지하세요. OpenClaw 전 준비는 전 플랫폼 설치 가이드를 따릅니다.
# 디바운스 드라이버 예시(값은 README에 고정): 감시 루트당 프로세스 1개
WATCH="$HOME/motion_jobs/demo/inbox"
fswatch -o "$WATCH" | while read -r _; do
sleep 45
~/bin/motion-dequeue.sh --job demo --debounce-ok
done큐·재시도·로깅
동시 상한(예: 시퀀스 2~4)으로 발열·IO를 예측 가능하게 두고, 실패는 API처럼 분류합니다.
| 분류 | 예시 | 정책 |
|---|---|---|
| 일시(transient) | GPU 바쁨, 짧은 파일 락, 네트워크 볼륨 순간 끊김 | 백오프+지터 재시도, 시도 상한·매 시도 로그 |
| 데이터(data) | 프레임 수 불일치, PNG 시그니처 손상, ICC 정책 위반 | 맹목 재시도 없음, quarantine+매니페스트 사유 |
| 운영(operational) | 디스크 워터마크, 렌더러 바이너리 누락 | 전역 dequeue 일시정지, 수정 후 운영자 resume |
시도마다 JSONL 한 줄(trace_id·class·exit_code·next_eligible_at 등), 일별 logs/·gzip은 감시·재시도·로그 아카이브 HowTo와 동일 패턴이 운영에 유리합니다.
PNG 시퀀스 생성(단계 템플릿)
스택이 스튜디오마다 다르므로 단계 템플릿을 Git에 두고 플레이스홀더만 채운 뒤 OpenClaw 또는 셸 래퍼가 고정 값으로 실행합니다. 런북에 검증되지 않은 “한 줄 마법”을 넣지 않습니다.
- A 입력: 버전·FPS·프레임·WxH를 매트릭스와 대조, README 비면 거부.
- B 렌더:
<RENDERER> <INPUT> --fps <N> --size <WxH> --out <패턴>— 실제 값은 Brewfile 등에 고정. - C 검사: 프레임 수·알파·바이트 히스토그램을 manifest 기준과 비교.
- D 승격:
out/YYYY-MM-DD/<slug>/로 원자 이동·manifest.jsonlappend.
job YAML에서만 매개변수를 읽게 하면 프로덕션 실행이 diff로 추적됩니다.
용량 임계·알림·아카이브
dequeue 전 여유 공간(예: 약 15% 미만 또는 GB 하한 선착) 미달 시 일시 정지. 렌더 후 시퀀스 합계·프레임당 바이트를 YAML과 비교해 초과 시 quarantine·웹훅/메일.
성공 시 archive/YYYY-MM/<job_id>/로 옮기고 JSONL을 붙여 커밋·렌더 빌드 추적 가능하게 둡니다.
OpenClaw 게이트웨이: 최소 도구 권한
공유 호스트에서는 도구 면을 넓히지 않습니다.
- 바인드·인증:
127.0.0.1등, 토큰은 워커만 읽기·프롬프트에 비밀 금지. - FS 허용 목록: ACL로
~/motion_jobs/**만 — Mail·무관 레포 제외. - 도구: 리뷰된 “템플릿 실행·JSONL append”만; 임의 셸은 VCS 허용 목록과 쌍만.
- 관측: 도구 호출마다 큐와 동일
trace_id.
최소 권한이 프롬프트 트릭보다 우선입니다.
문제 해결 FAQ
같은 수출에 작업이 두 번 enqueue됩니다.
single-flight 락 누락이거나 fswatch와 GUI 동기 도구가 같은 트리에서 동시에 울리는 경우가 많습니다. 루트당 워처 프로세스 하나로 제한하고 시작 시 pid를 로그에 남기세요.
로컬에선 정상인데 워커에서 ICC 검사에 실패합니다.
렌더러 기본값이 Display P3인데 QA는 sRGB만 허용하는 식입니다. job README에 색 정책을 고정하고 CI와 동일한 CLI 경로로 검증하세요.
재시도가 즉시 소진됩니다.
종료 코드로 일시·데이터를 분리하고, 데이터 결함에는 사람이 매니페스트 플래그를 수정하기 전까지 재queue하지 마세요. GPU 시간 낭비를 막습니다.
OpenClaw가 DAM을 대체하나요?
아니요. macOS 네이티브 단계·큐·알림 자동화에 적합하고, 권리 메타·승인은 DAM이나 git LFS 정책이 담당하는 구성이 일반적입니다.
요약: 폴더 계약·디바운스·single-flight·YAML 임계·Git 템플릿·좁은 게이트웨이. 원격 Mac으로 야간 배치·팀 런북을 맞추려면 대여·구매·요금·SSH·VNC(로그인 불필요), 더 읽을 글은 기술 인사이트입니다.
원격 Mac에서 OpenClaw 모션 파이프라인
Lottie → PNG 배치를 디자이너 노트북에서 분리하고, Apple Silicon에서 렌더 버전을 고정한 뒤 큐·로그 런북을 팀 전체가 공유하세요.