A robust macOS screen capture utility that uses short video recordings to extract high-quality PNG snapshots, bypassing traditional permission hurdles.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mac-node-snapshot
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install mac-node-snapshot using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is mac-node-snapshot?
This skill provides a permission-friendly method for capturing macOS screen content within the OpenClaw ecosystem. By utilizing the screen record node capability to generate a brief 1-second video clip and then extracting a specific frame with ffmpeg, it ensures reliable image returns even in complex or headless environments where standard screencapture tools might fail. It is a critical component for users of Openclaw Skills who need visual context from their remote or local Mac machines for agent-led troubleshooting and analysis.
mac-node-snapshot Use Cases
- Capturing the current screen state for AI vision analysis.
- Troubleshooting visual issues in headless macOS environments.
- Verifying UI changes during automated development workflows.
- Responding to user prompts such as "What is on my screen?" or "Take a screenshot".
How mac-node-snapshot Works
- Create a dedicated temporary directory within the skill workspace to store capture assets.
- Execute a 1-second video recording command via the OpenClaw nodes interface with no audio.
- Save the resulting video buffer as an MP4 file in the temporary folder.
- Invoke ffmpeg to extract the first high-quality frame from the video file at the start of the timeline.
- Output the final image as a PNG, allowing Openclaw Skills to read and process the visual data.
mac-node-snapshot Setup
To use this within the Openclaw Skills framework, ensure that ffmpeg is installed on the host machine. You can initialize a capture with the following command sequence:
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"
mac-node-snapshot Data Schema & Taxonomy
The skill manages temporary visual assets and logs during the capture lifecycle:
| File Path | Description | Format |
|---|---|---|
{skill}/tmp/snap.mp4 |
Temporary video buffer used for frame extraction. | MP4 |
{skill}/tmp/snap.png |
The final high-resolution screen snapshot. | PNG |
Note: All paths are relative to the skill directory within Openclaw Skills.
mac-node-snapshot Advanced Features
- Multi-node support allows capturing screens from any paired macOS device in the network.
- Permission-resilient workflow designed to bypass common system-level screen recording blocks.
- Seamless integration with agent vision models by attaching generated PNGs to replies.
- Headless compatibility for automated monitoring and remote management scenarios.
SKILL.md
Loading
Related Openclaw Skills
ABIXUS Deterministic Oracle
A high-performance validation layer ensuring consistency and state verification for autonomous agents on the Polygon PoS network.
MistTrack Crypto AML & Risk Analysis Skill
A comprehensive cryptocurrency AML and security analysis tool for AI agents to track transactions and assess address risks across multiple blockchains.
imsg-media
An automated pipeline for transcribing iMessage voice memos and analyzing images within Openclaw Skills.
MiniMax MCP
An official MiniMax Model Context Protocol server providing AI-powered web search and sophisticated image understanding capabilities.
Social Draft
A dual-platform content automation tool that transforms technical updates into high-engagement Twitter and LinkedIn posts simultaneously.
AI Curriculum Generator
An intelligent educational curriculum generation system featuring automated resource discovery and strict human-in-the-loop escalation policies.
Featured*
