A powerful macOS command-line utility for capturing audio, screen recordings, screenshots, and camera input, optimized for terminal-based AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install record
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 record 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 record CLI?
The record CLI is a specialized macOS tool designed to bridge the gap between terminal environments and media capture hardware. It allows users and autonomous agents to record high-quality audio, video, and still images directly from the command line without interacting with a GUI. Built with automation in mind, it provides structured output and granular control, making it an essential addition to any developer's toolkit or Openclaw Skills collection. It handles everything from simple screenshots to complex multi-source audio/video recordings while maintaining a pipeline-friendly architecture.
record CLI Use Cases
- Automating bug report screenshots or screen recordings via terminal scripts.
- Integrating voice recording capabilities into AI-driven note-taking applications.
- Capturing webcam photos or videos for automated identity verification or monitoring workflows.
- Enabling AI agents to 'see' the screen or 'hear' audio input to provide context-aware assistance.
- Programmatic media capture for documentation and automated tutorials using Openclaw Skills.
How record CLI Works
- The user or AI agent executes a specific subcommand such as audio, screen, or camera.
- The tool checks for necessary macOS privacy permissions including Microphone, Camera, or Screen Recording access.
- The capture process initiates based on provided flags, either for a specified duration or until a manual stop signal.
- Media is processed and saved to a temporary directory or a user-defined custom output path.
- The tool outputs the resulting file path to stdout or provides a structured JSON response for programmatic consumption within Openclaw Skills.
record CLI Setup
Install the tool via Homebrew on macOS using the following command:
brew install atacan/tap/record
After installation, ensure that your terminal application (e.g., iTerm2, Terminal.app) has the required permissions enabled in System Settings > Privacy & Security for Microphone, Camera, and Screen Recording to enable full functionality for your Openclaw Skills workflow.
record CLI Data Schema & Taxonomy
The record CLI follows a predictable output pattern to ensure interoperability with scripts and Openclaw Skills. It primarily outputs file paths to stdout and status messages to stderr.
| Data Type | Description | Default Format |
|---|---|---|
| Audio | Microphone recordings | .m4a |
| Video | Screen or Camera recordings | .mp4 |
| Image | Screenshots or Photos | .png / .jpg |
| Metadata | JSON structured info | .json (via --json flag) |
Output files are stored in a temporary directory by default unless the --output flag is specified to define a custom path.
record CLI Advanced Features
- JSON Output: Utilize the --json flag to receive machine-readable data for seamless integration with AI agents.
- Timed Captures: Use the --duration flag for non-interactive recordings, which is essential for headless or automated environments.
- Selective Window Capture: Record specific applications or windows using the --window flag rather than capturing the full screen.
- Audio Source Mixing: Capture system audio, microphone input, or both simultaneously during screen recordings.
- Hardware Enumeration: List all available displays, windows, cameras, and audio devices to dynamically configure your Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Skill Search
A multi-modal search engine for AI agents to discover, match, and load specialized capabilities through keyword, semantic, or LLM-powered matching.
Smart Intent Router Skill
An intelligent model dispatching system that uses multi-dimensional analysis to route requests to the most efficient AI model based on complexity and cost.
OpenClaw Reference Manual
A complete technical reference for managing OpenClaw configurations, CLI operations, and multi-channel AI agent deployments.
DocuClaw
A sovereign document intelligence and archival system that extracts structured data from files 100% locally using AI.
speechall-cli
A cross-platform command-line tool for professional speech-to-text transcription powered by multiple leading AI providers.
Translate CLI
A robust command-line interface for translating text, files, and code catalogs using various AI providers and custom prompt templates.
METADATA
Featured*
