Skip to main content
Mac 노드의 화면을 스크린샷 또는 영상으로 녹화할 수 있습니다. 원격 모니터링, 튜토리얼 제작, 작업 기록에 활용합니다.

스크린샷

openclaw nodes screen --node "my-macbook" --mode snap
AI 도구:
nodes.screen_record(
  node="my-macbook",
  durationMs=0  # 0이면 스크린샷
)

화면 녹화

# 10초 녹화
openclaw nodes screen --node "my-macbook" --duration 10s
AI 도구:
nodes.screen_record(
  node="my-macbook",
  durationMs=10000,
  includeAudio=false
)

옵션

옵션설명기본값
durationMs녹화 시간 (밀리초)스크린샷
includeAudio오디오 포함false
screenIndex모니터 번호 (멀티 모니터)0
maxWidth최대 가로 해상도원본
quality화질 (1-100)80
fps프레임 레이트기본
# 멀티 모니터에서 두 번째 화면
openclaw nodes screen --node "my-macbook" --screen-index 1

# 저해상도로 빠르게
openclaw nodes screen --node "my-macbook" --max-width 1280 --quality 50

활용 사례

🖥️ 원격 모니터링

서버 대시보드나 모니터링 화면 원격 확인

📹 작업 기록

중요 작업 과정을 영상으로 기록

🐛 버그 리포트

화면 캡처 후 AI가 버그 분석

📊 대시보드 체크

Grafana 등 모니터링 도구 정기 캡처

자동화: 대시보드 모니터링

# 매 시간 서버 대시보드 캡처
openclaw cron add --name "dashboard-check" \
  --every "1h" \
  --message "my-macbook 화면 캡처해서 대시보드 상태 확인해. 이상 있으면 알려줘" \
  --session isolated --announce

권한 설정

macOS에서 화면 녹화를 사용하려면 시스템 설정 → 개인정보 보호 → 화면 기록에서 OpenClaw 노드 호스트에 권한을 부여해야 합니다.
1

시스템 설정 열기

시스템 설정 → 개인정보 보호 및 보안 → 화면 및 시스템 오디오 녹음
2

권한 부여

OpenClaw Node 또는 터미널 앱에 권한 추가
3

재시작

노드 호스트를 재시작합니다:
openclaw node restart
화면 녹화 권한이 없으면 needsScreenRecording 에러가 발생합니다. 권한 부여 후 반드시 노드를 재시작하세요.