mac-node-snapshot
by taozhe6
Coding Agents & IDEsBrief
A robust, permission-friendly method to capture macOS screens via OpenClaw screen.record.
Description
What This Skill Does
Captures macOS screenshots by recording a 1-second clip via OpenClaw's screen.record node, then extracting a PNG frame with ffmpeg. Works in headless environments where standard screencapture commands often fail due to permission restrictions.
Routes through the screen.record node instead of screencapture, avoiding the permission errors that block standard screenshot tools in headless or automated contexts.
When to Use It
- Answering 'what's on my screen?' questions
- Capturing UI state during manual testing
- Attaching a screenshot to a bug report
- Documenting current screen contents in a remote session
- Debugging visual layout without leaving the terminal
Example Workflow
User asks: Take a screenshot of my screen
- 1
Creates a tmp directory inside the skill folder
- 2
Records a 1-second clip using openclaw nodes screen record with no audio
- 3
Extracts the first video frame as a PNG using ffmpeg
- 4
Reads the PNG file and attaches it to the reply
A PNG screenshot of the current screen attached to the agent's response
Requirements
- ffmpeg installed on the system
- Screen Recording permission granted in macOS System Settings > Privacy & Security
Installation
clawhub install taozhe6/mac-node-snapshotRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.