Skip to content
TakoAPI
Back to skills

mac-node-snapshot

by taozhe6

Coding Agents & IDEs
968Downloads reported by clawskills.sh
1Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

INPUT

User asks: Take a screenshot of my screen

AGENT
  1. 1

    Creates a tmp directory inside the skill folder

  2. 2

    Records a 1-second clip using openclaw nodes screen record with no audio

  3. 3

    Extracts the first video frame as a PNG using ffmpeg

  4. 4

    Reads the PNG file and attaches it to the reply

OUTPUT

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-snapshot

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links