youtube
Upload videos and custom thumbnails to YouTube. Use when the user wants to publish, upload, or post a video to YouTube, set a thumbnail, or manage YouTube channel authentication.
- License 许可
- MIT
- 最近更新
- 2026-06-10
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- youtube
- homepage
- https://developers.google.com/youtube/v3
- metadata
- { "openclaw": { "emoji": "📺", "requires": { "bins": [ "python3" ] } } }
- description
- Upload videos and custom thumbnails to YouTube. Use when the user wants to publish, upload, or post a video to YouTube, set a thumbnail, or manage YouTube channel authentication.
03 SKILL.md 正文
YouTube Uploader
Upload videos with full metadata and custom thumbnails to YouTube via OAuth2.
Setup (one-time)
The user needs a Google Cloud project with the YouTube Data API v3 enabled and an OAuth2 client ID (type "Desktop app"). Download the client_secret.json file.
Authenticate
python3 {baseDir}/scripts/youtube-upload.py auth --client-secret /path/to/client_secret.json
This opens a browser for Google OAuth consent, then saves credentials to ~/.openclaw/youtube/channels.json. Multiple channels can be authenticated by repeating the command with different Google accounts.
List authenticated channels
python3 {baseDir}/scripts/youtube-upload.py channels
Upload a video
python3 {baseDir}/scripts/youtube-upload.py upload \
--file /path/to/video.mp4 \
--title "Video Title" \
--description "Video description" \
--tags "tag1,tag2,tag3" \
--category 22 \
--privacy private \
--channel-id UCxxxxxxxx
Required: --file, --title
Optional: --description, --tags (comma-separated), --category (default 22 = People & Blogs), --privacy (private/unlisted/public, default private), --publish-at (ISO 8601 for scheduled publish, requires privacy=private), --made-for-kids, --channel-id (uses first channel if omitted)
Returns JSON with videoId and url.
Upload a custom thumbnail
python3 {baseDir}/scripts/youtube-upload.py thumbnail \
--video-id VIDEO_ID \
--file /path/to/thumbnail.jpg \
--channel-id UCxxxxxxxx
Supports JPEG, PNG, BMP, GIF. Max 2MB per YouTube API. The channel must be verified for custom thumbnails.
Refresh token manually
python3 {baseDir}/scripts/youtube-upload.py refresh --channel-id UCxxxxxxxx
Workflow tips
- Always upload as
--privacy privatefirst, verify, then update privacy if needed. - Upload thumbnail immediately after video upload using the returned
videoId. - If auth expires, re-run the
authsubcommand. - When the user doesn't specify a category, default to 22. See
references/categories.mdfor the full list.
References
- See
references/categories.mdfor YouTube video category IDs.
04 同仓库更多 Skills
youtube-content
YouTube transcripts to summaries, threads, blogs.
xurl
X/Twitter via xurl CLI: post, search, DM, media, v2 API.
touchdesigner-mcp
Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
teams-meeting-pipeline
Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.