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 노드 호스트에 권한을 부여해야 합니다.
시스템 설정 열기
시스템 설정 → 개인정보 보호 및 보안 → 화면 및 시스템 오디오 녹음
권한 부여
OpenClaw Node 또는 터미널 앱에 권한 추가
화면 녹화 권한이 없으면 needsScreenRecording 에러가 발생합니다.
권한 부여 후 반드시 노드를 재시작하세요.