① 목표: 원격 Mac에서 OpenClaw 제어판으로 디자인 Skills를 상태 필터 기반 일괄 활성하고, 앱·브라우저 PNG 수출 디렉터리를 감시·실패 재시도·로그 아카이브까지 재현 가능한 단계로 고정합니다.
② 키워드: 게이트웨이·도구·Teams 협업, Skills UI, PNG 배치 납품, 디바운스, JSONL. HowTo·FAQ 포함.
목차
OpenClaw 최근 버전 방향(2026)
2026년 기준 업스트림 흐름은 다음 세 축으로 묶는 편이 운영에 맞습니다. 게이트웨이는 로컬 바인딩·최소 권한 토큰·정책 버전(rules_version) 고정이 기본이며, 원격 노드에서도 동일 스냅샷으로 재현할 수 있게 하는 쪽으로 수렴합니다. 도구/SDK는 파일시스템·렌더·메타데이터 검사기를 얇게 노출하고, 스킬 매니페스트와 CLI가 같은 스키마를 읽도록 맞추는 업데이트가 이어집니다. Teams·협업 측면에서는 워크스페이스 단위 스킬 승인·감사 로그·역할 분리가 강화되어, 디자인 산출물 경로와 자동화 계정을 분리하는 패턴이 권장됩니다. 이 글은 그 전제 위에서 제어판으로 디자인 계열 스킬을 한꺼번에 켠 뒤, 수출 폴더를 감시독에 태우는 실무 런북입니다.
설치·게이트웨이 구성
먼저 전 플랫폼 설치 가이드에 맞춰 CLI와 데몬을 올립니다. 원격 Mac에서는 사용자 전용이 아니라 서비스 계정·고정 PATH를 쓰는 것이 재시도·로그 일관성에 유리합니다. 아래는 검증용 예시 명령입니다(환경에 따라 패키지 관리자명은 바꿉니다).
# 예: 설치 후 게이트웨이 상태·버전 확인
openclaw version
openclaw gateway status
openclaw gateway bind 127.0.0.1:8742 --token "${OPENCLAW_GATEWAY_TOKEN}"
# 워커 셸에서 스킬 목록이 보이는지(비대화형)
ssh batch@remote-mac 'bash -lc "openclaw skills list"'FS 접근은 화이트리스트 루트만 열고, 수출·작업·로그 트리는 NVMe 로컬에 두세요. iCloud·네트워크 볼륨은 감시 대상에서 제외하는 것이 감시·재시도·로그 아카이브 HowTo와 동일한 계약입니다.
제어판 Skills 상태 필터·일괄 활성
제어판 → Skills에서 상단 상태 필터를 disabled 또는 needs_review로 두고, 태그나 카테고리로 design·export·asset을 좁힙니다. 목록에서 다중 선택 후 일괄 활성을 누르면 의존 스킬이 함께 올라오는지 확인하는 승격 대화상자가 뜨는 경우가 많으니, PNG 파이프라인에 필요한 미리보기·메타·이름 규칙 스킬까지 한 번에 켜 두는 것이 좋습니다. CLI로 동일 작업을 재현하려면 다음과 같은 패턴을 쓸 수 있습니다.
# 예: 디자인·비활성 스킬만 조회 후 일괄 활성(플레이스홀더 ID)
openclaw skills list --category design --status disabled --format json > /tmp/skills.json
openclaw skills enable --ids "$(jq -r '.[].id' /tmp/skills.json | paste -sd, -)"UI에서 바꾼 뒤에는 openclaw skills list --status enabled | grep design으로 원격 셸과 일치하는지 반드시 맞춥니다.
수출 디렉터리 감시 전략
디자인 툴이 쓰는 수출 디렉터리를 ~/png_jobs/<프로젝트>/inbox 등으로 표준화하고, 워커는 work·out으로만 이동시킵니다. 트리거는 쓰기 완료 후 무활동 30~60초 디바운스 한 번이 기본이며, fswatch 파이프에 single-flight 락을 걸어 동시 수출을 한 배치로 합칩니다. launchd WatchPaths를 쓸 때는 절대 경로와 동일한 PATH를 ProgramArguments에 넣어야 SSH로 디버깅한 결과와 같아집니다.
EXPORT_ROOT="$HOME/png_jobs/acme/export"
mkdir -p "$EXPORT_ROOT"/{inbox,work,out,failed,logs,archive}
fswatch -o "$EXPORT_ROOT/inbox" | while read -r _; do
flock -n /tmp/oc-png-acme.lock -c 'sleep 45 && ~/bin/openclaw-png-export-job.sh --project acme'
done실패 재시도·로그 아카이브
실패는 일시(transient)·데이터(data)·운영(operational)로 나누고, 일시만 지수 백오프·지터로 재시도합니다. PNG 시그니처 오류·해상도 위반은 failed로 격리하고 자동 재시도하지 않습니다. 로그는 logs/job-YYYYMMDD.jsonl에 두고 전일분은 gzip으로 archive/YYYY-MM-DD.tgz에 넣으며, 운영자용으로 errors.jsonl만 짧게 유지합니다. 상세 패턴은 앞서 인용한 감시·재시도 글과 동일합니다.
PNG 배치 납품 시나리오
야간에 Figma·Sketch에서 @2x PNG를 연속 수출하면 파일 수가 많아집니다. Skills로 이름 규칙·ICC·알파 샘플링을 자동화한 뒤, 감시독이 out을 채우면 PNG 일괄 QC 게이트에서 바이트·치수 임계를 통과한 항목만 납품 폴더로 승격합니다. 팀이 같은 원격 Mac을 쓸 때는 수출 계정과 배치 계정을 나누고, 게이트웨이 토큰은 배치 전용으로 제한하세요.
문제 해결 FAQ
스킬은 켰는데 수출 스크립트가 도구를 못 찾습니다.
launchd·cron 환경의 PATH가 대화형 셸과 다릅니다. 래퍼 스크립트 맨 위에 export PATH=/opt/homebrew/bin:...를 고정하거나, bash -lc로만 실행하세요.
재시도가 같은 PNG에서 무한 루프입니다.
max_attempts_per_file와 next_eligible_at을 매니페스트에 기록하고, 한계에 도달하면 quarantine으로 옮긴 뒤 사람이 승인해야만 재큐에 넣습니다.
디스크가 부족해 배치가 멈췄습니다.
여유 15% 미만 또는 고정 하한(예: 20GB) 미만이면 dequeue를 멈추고 알림을 보냅니다. 아카이브 업로드 후 재개합니다.
요약하면, 게이트웨이·도구·Teams 방향에 맞춰 스킬을 제어판에서 일괄 활성한 다음, 수출 디렉터리를 디바운스·락으로 감시하고 실패·로그를 분류하면 PNG 배치 납품이 팀 간에도 재현됩니다. MacPng 홈에서 서비스 개요를 본 뒤 구매·대여·요금·SSH·VNC 도움말은 로그인 없이 열 수 있으며, 더 읽을 글은 기술 인사이트에서 이어가면 됩니다.