mac-node-snapshot

Overview

Uses node screen.record to record a 1-second clip and extract a high-quality PNG frame. This workflow bypasses common screencapture permission issues and ensures a reliable image return.

Quick start (single command, no scripts)

All paths are relative to {skill}.

mkdir -p "{skill}/tmp" \
&& openclaw nodes screen record --node "<node>" --duration 1000 --fps 10 --no-audio --out "{skill}/tmp/snap.mp4" \
&& ffmpeg -hide_banner -loglevel error -y -ss 00:00:00 -i "{skill}/tmp/snap.mp4" -frames:v 1 "{skill}/tmp/snap.png"

When to use (trigger phrases)

Use this skill when the user asks:

1. "Take a screenshot"
2. "What is on my screen?"
3. "Capture the screen"
4. "Screenshot via screen.record"

Notes

1. Requirements: ffmpeg (ask before installing).
2. If the frame is black, ask the user to wake the screen and retry.
3. Use read on {skill}/tmp/snap.png to attach it to the reply.

Troubleshooting

1. screen_record fails (node disconnected): check nodes status, ensure OpenClaw app is running/paired.
2. screenRecording false: must grant Screen Recording in System Settings; cannot be bypassed.
3. Black frame: screen may be asleep/locked; ask the user to wake and retry.