AutoClipper

Description

Automatically create clips and videos from media files in a specified folder. Uses Agent Swarm for intelligent task delegation and supports cron-based scheduling.

AutoClipper

Automatic Video Clip & Highlight Generator for OpenClaw.

v1.0.0 — Design draft. Automatically scan a folder for media files, create clips/highlights using ffmpeg, and organize output. Cron-ready for scheduled automation.

Installation

CODEBLOCK0

Usage

• - Screen recording highlights: Auto-clip moments from Loom/obsidian recordings
• Meeting recaps: Extract key segments from meeting recordings
• Content creation: Batch-process raw footage into short clips
• Security camera clips: Pull motion-triggered segments from camera feeds
• Gaming highlights: Auto-clip "best of" moments from recordings

CODEBLOCK1

Purpose

AutoClipper enables OpenClaw agents to automatically:

• - Monitor a watch folder for new media files (videos, screen recordings, camera clips)
• Analyze media to understand what's worth clipping (via Agent Swarm delegation)
• Generate clips using ffmpeg (highlights, segments, trimmed videos)
• Produce compilations by stitching multiple clips together
• Schedule runs via cron for fully automated workflows

Architecture

CODEBLOCK2

Components

1. Watch Folder Scanner

• - Monitors a configured input directory
• Filters by file extensions: .mp4, .mov, .mkv, .avi, INLINECODE4
• Tracks processed files (to avoid re-processing)
• Configurable: watchFolder, fileExtensions, INLINECODE7

2. Media Analyzer (via Agent Swarm)

• - Delegates analysis to appropriate model (MiniMax for code/technical, Kimi for creative)
• Determines:

• - Returns structured clip plan: INLINECODE8

3. Clip Engine (ffmpeg)

• - Trim: Extract segments without re-encoding (fast)
• Transcode: Convert to target format/codec
• Highlight: Auto-detect "interesting" segments (via scene detection)
• Compile: Stitch multiple clips into single video
• Overlay: Add watermarks, timestamps, captions

4. Output Manager

• - Organized output folder structure: INLINECODE9
• Configurable naming: INLINECODE10
• Optional: Notify via OpenClaw message (Discord, WhatsApp, etc.)

5. Cron Scheduler

• - Standalone script for cron integration
• Configurable schedule: 0 * * * * (hourly), 0 9 * * * (daily at 9am)
• Dry-run mode for testing
• Lock file to prevent overlapping runs

Configuration (config.json)

CODEBLOCK3

Tools Needed

Agent Swarm integration

When AutoClipper finds new media, it delegates analysis:

CODEBLOCK4

Prompt template for media analysis:
CODEBLOCK5

Directory Structure

CODEBLOCK6

Keywords

• - video, clip, clips, highlight, highlights
• trim, cut, extract, segment
• ffmpeg, transcode, encode, convert
• folder, watch, monitor, automation
• cron, schedule, batch, process
• screen recording, meeting, recording

Skill Name Ideas

1. 1. AutoClipper ✓ (chosen)
2. ClipForge
3. MediaMason
4. VideoHarvest
5. HighlightHub
6. ClipStream
7. MediaSnip
8. AutoTrim

Implementation Phases

Phase 1: Core (MVP)

• - [ ] Folder scanner with extension filtering
• [ ] Basic ffmpeg trim operation
• [ ] Simple processed file tracking
• [ ] CLI entry point

Phase 2: Intelligence

• - [ ] Agent Swarm integration for clip planning
• [ ] Scene detection for auto-highlighting
• [ ] Metadata extraction with ffprobe

Phase 3: Automation

• - [ ] Cron launcher script
• [ ] Continuous watcher mode
• [ ] Notification system
• [ ] Output organization

Phase 4: Advanced

• - [ ] Multi-clip compilation
• [ ] Overlay/watermark support
• [ ] Custom clip templates
• [ ] Node camera integration

Notes

• - Performance: Use -c copy for fast trimming (no re-encode)
• Storage: Auto-cleanup processed files or move to archive
• Error handling: Skip corrupted files gracefully, log failures
• Idempotency: Same input file should not produce duplicate output