A Python-powered automation tool for uploading videos, managing custom thumbnails, and handling OAuth2 authentication for YouTube channels.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install youtube-uploader
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 youtube-uploader 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 YouTube Uploader?
The YouTube Uploader skill is a professional-grade automation utility designed to bridge the gap between video production and distribution. By leveraging the power of Openclaw Skills, developers can programmatically interface with the YouTube Data API v3 to handle complex tasks like OAuth2 consent flows, video metadata management, and multi-channel support. This skill is essential for creators and developers who need to integrate video publishing directly into their CI/CD pipelines or AI-driven content workflows.
Built with reliability in mind, this tool allows for precise control over every aspect of the upload process, from privacy settings to category selection. By using Openclaw Skills for your YouTube management, you ensure a secure and scalable way to maintain a video presence without manual browser-based uploads.
YouTube Uploader Use Cases
- Automating the publishing pipeline for recurring video content series.
- Managing multiple YouTube brand accounts through a single authenticated CLI.
- Programmatically uploading custom thumbnails immediately after a video is processed.
- Scheduling video releases for global audiences using ISO 8601 timestamps.
- Integrating YouTube distribution into automated digital marketing and social media workflows.
How YouTube Uploader Works
- The user provides a Google Cloud OAuth2 client secret to initiate the authentication lifecycle.
- The skill opens a browser for secure Google OAuth consent and generates persistent refresh tokens.
- Credentials and channel metadata are stored locally to allow for headless operations in the future.
- Upload commands transmit video files and metadata (titles, tags, categories) to YouTube's servers via secure API calls.
- The skill captures the unique Video ID returned by YouTube, enabling immediate follow-up actions like thumbnail updates.
YouTube Uploader Setup
Prerequisites
Ensure you have a Google Cloud project with the YouTube Data API v3 enabled and a Desktop app OAuth2 client ID. Download your client_secret.json file.
Authentication
Run the following command to authenticate your first channel:
python3 {baseDir}/scripts/youtube-upload.py auth --client-secret /path/to/client_secret.json
Uploading Content
To upload a video with specific metadata, use the following structure:
python3 {baseDir}/scripts/youtube-upload.py upload \
--file /path/to/video.mp4 \
--title "My Automated Video" \
--privacy private
YouTube Uploader Data Schema & Taxonomy
| Component | Location / Format | Description |
|---|---|---|
| Credentials | ~/.openclaw/youtube/channels.json |
Stores OAuth2 access and refresh tokens for authenticated channels. |
| Main Script | scripts/youtube-upload.py |
The core Python logic for interacting with the YouTube Data API. |
| Category Map | references/categories.md |
A reference list of YouTube category IDs (e.g., ID 22 for People & Blogs). |
| Metadata | JSON Output | Upload commands return JSON containing the videoId and url. |
YouTube Uploader Advanced Features
- Multi-channel Management: Use the
--channel-idflag to target specific authenticated accounts for each operation. - Custom Thumbnails: Support for JPEG, PNG, BMP, and GIF files up to 2MB for verified channels.
- Scheduled Publishing: Automate precisely timed releases by setting the
--publish-atflag with private visibility. - Token Maintenance: Includes a dedicated refresh subcommand to manually renew expired access tokens.
- Granular Privacy Controls: Support for public, private, and unlisted visibility states during the initial upload.
SKILL.md
Loading
Related Openclaw Skills
spotify-player
A terminal-centric skill for managing Spotify playback and track searching through high-performance CLI tools.
ClawDoctor
ClawDoctor is a behavioral cost coach that analyzes your AI agent sessions to identify financial waste and provide actionable coaching to reduce spending.
LegiScan Bill Tracker
An automated monitoring tool that tracks state legislative bills using keyword filtering via the LegiScan API.
ANSIClaw
A sophisticated tool for generating BBS-compatible ANSI art through the Clawbius REST API using Python-driven automation and iterative AI refinement.
Android SMS Gateway
A self-hosted SMS gateway solution that turns an Android device into a private HTTP API for sending and receiving messages.
Neutron Agent Memory
A persistent memory solution for AI agents that leverages semantic search and structured context storage to maintain state across sessions.
Featured*
