> ## Documentation Index
> Fetch the complete documentation index at: https://oc-guide.openclaw-korea.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 화면 녹화

> 노드 화면을 캡처하고 녹화하기

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

## 스크린샷

```bash theme={null}
openclaw nodes screen --node "my-macbook" --mode snap
```

AI 도구:

```
nodes.screen_record(
  node="my-macbook",
  durationMs=0  # 0이면 스크린샷
)
```

## 화면 녹화

```bash theme={null}
# 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`          | 프레임 레이트         | 기본    |

```bash theme={null}
# 멀티 모니터에서 두 번째 화면
openclaw nodes screen --node "my-macbook" --screen-index 1

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

## 활용 사례

<CardGroup cols={2}>
  <Card title="🖥️ 원격 모니터링" icon="desktop">
    서버 대시보드나 모니터링 화면 원격 확인
  </Card>

  <Card title="📹 작업 기록" icon="video">
    중요 작업 과정을 영상으로 기록
  </Card>

  <Card title="🐛 버그 리포트" icon="bug">
    화면 캡처 후 AI가 버그 분석
  </Card>

  <Card title="📊 대시보드 체크" icon="chart-line">
    Grafana 등 모니터링 도구 정기 캡처
  </Card>
</CardGroup>

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

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

## 권한 설정

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

<Steps>
  <Step title="시스템 설정 열기">
    시스템 설정 → 개인정보 보호 및 보안 → 화면 및 시스템 오디오 녹음
  </Step>

  <Step title="권한 부여">
    OpenClaw Node 또는 터미널 앱에 권한 추가
  </Step>

  <Step title="재시작">
    노드 호스트를 재시작합니다:

    ```bash theme={null}
    openclaw node restart
    ```
  </Step>
</Steps>

<Info>
  화면 녹화 권한이 없으면 `needsScreenRecording` 에러가 발생합니다.
  권한 부여 후 반드시 노드를 재시작하세요.
</Info>