什么是 YouTube 发布助手？

YouTube 发布助手是一个强大的自动化工具，旨在简化直接从本地环境或通过 AI 代理向 YouTube 发布内容的过程。通过利用 OAuth 2.0 和 YouTube Data API v3，此技能为处理视频物流提供了安全高效的方式。它是 Openclaw 技能生态系统的核心部分，专为需要将视频发布集成到自动化流水线的开发人员而设计。

该技能不仅限于简单的上传，还提供对视频生命周期的全面控制，包括大文件的断点续传、元数据优化和隐私管理。无论您是管理单个频道还是复杂的内容网络，YouTube 发布助手都能确保您的媒体内容可靠且一致地送达。

下载入口:https://github.com/openclaw/skills/tree/main/skills/pdpaer/you@tube-publisher

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

YouTube 发布助手 应用场景

• 使用 Openclaw 技能自动化交付生成的视频内容。
• 使用预定义的标签、类别和描述批量上传视频。
• 管理内部或不公开列出视频分发的隐私设置。
• 以编程方式将新上传的视频添加到特定频道播放列表。
• 将视频发布集成到 AI 驱动的内容创作工作流中。

1. 用户提供 Google Cloud 控制台的 OAuth 2.0 凭据文件以建立安全连接。
2. 技能启动一次性身份验证流程，生成用于未来访问的持久令牌。
3. 触发上传命令时，脚本将视频拆分为 10MB 的块，以实现可靠的断点续传过程。
4. 标题、标签和缩略图等元数据在上传期间或之后通过 API 调用应用。
5. 技能坚控上传状态并提供最终视频 ID 和 URL 的反馈。

YouTube 发布助手 配置指南

首先，您必须从 Google Cloud 控制台获取 OAuth 客户端 ID。启用 YouTube Data API v3 并下载 JSON 凭据。将此文件放置在技能目录中：

mv ~/Downloads/client_secret_*.json ~/.openclaw/workspace/skills/you@tube-publisher/client_secret.json

安装必要的 Python 依赖项：

pip3 install google-api-python-client google-auth-oauthlib google-auth-httplib2

运行初始授权以生成您的访问令牌：

python3 ./scripts/you@tube_upload.py auth

YouTube 发布助手 数据架构与分类体系

YouTube 发布助手在 Openclaw 技能工作区内的以下结构中组织其配置和运行数据：

所有视频上传都可以使用元数据进行自定义，包括标题、描述、标签、类别 ID（例如 28 代表科技，27 代表教育）以及隐私状态（私有、不公开或公开）。

name: you@tube-publisher
description: "YouTube 视频自动上传工具。支持视频上传、设置标题/描述/标签/缩略图、管理频道和播放列表。基于 YouTube Data API v3 + OAuth 2.0。"
metadata:
  {
    "openclaw":
      {
        "emoji": "??",
      },
  }

you@tube-publisher

YouTube 视频自动上传与管理工具

基于 YouTube Data API v3 + OAuth 2.0，支持从命令行自动上传视频到 YouTube。

架构

本地 Mac (Python)
    ↓ OAuth 2.0 认证
Google YouTube Data API v3
    ↓ 断点续传上传
YouTube 频道

功能

• ? 视频上传（支持大文件断点续传，10MB 分块）
• ? 设置标题、描述、标签、分类
• ? 隐私状态控制（private / public / unlisted）
• ? 自定义缩略图
• ? 添加到播放列表
• ? 频道信息查询
• ? 已上传视频列表
• ? OAuth 2.0 自动刷新 Token

快速开始

第一步：Google Cloud Console 配置

?? 这一步必须手动完成，只需做一次。

1. 打开 Google Cloud Console
2. 创建新项目（或选择已有项目）
3. 启用 API：
   • 搜索 "YouTube Data API v3" → 点击 "启用"
4. 创建 OAuth 凭证：
   • 左侧菜单 → "API 和服务" → "凭据"
   • "创建凭据" → "OAuth 客户端 ID"
   • 应用类型选 "桌面应用"
   • 名称随意（如 "OpenClaw YouTube"）
   • 下载 JSON 文件
5. 保存凭证文件：

   mv ~/Downloads/client_secret_*.json ~/.openclaw/workspace/skills/you@tube-publisher/client_secret.json
   

注意： 如果项目处于"测试"状态，需要在 OAuth 同意屏幕 → 测试用户 中添加你的 Google 邮箱。

第二步：安装依赖

pip3 install google-api-python-client google-auth-oauthlib google-auth-httplib2

第三步：首次授权

python3 {baseDir}/scripts/you@tube_upload.py auth

浏览器会自动打开 Google 授权页面，登录并授权后，Token 自动保存到本地。后续使用无需再授权。

第四步：上传视频

# 基本上传（默认 private）
python3 {baseDir}/scripts/you@tube_upload.py upload video.mp4 r
  --title "视频标题" r
  --description "视频描述" r
  --tags AI OpenClaw 自动化

# 公开发布 + 设置缩略图
python3 {baseDir}/scripts/you@tube_upload.py upload video.mp4 r
  --title "OpenClaw 实战教程" r
  --description "详细教程..." r
  --tags AI OpenClaw 教程 r
  --privacy public r
  --thumbnail cover.png r
  --category 28

# 上传并添加到播放列表
python3 {baseDir}/scripts/you@tube_upload.py upload video.mp4 r
  --title "系列教程 #1" r
  --playlist PLxxxxxx

其他命令

# 查看频道信息
python3 {baseDir}/scripts/you@tube_upload.py channels

# 列出最近上传的视频
python3 {baseDir}/scripts/you@tube_upload.py list
python3 {baseDir}/scripts/you@tube_upload.py list -n 20

# 列出播放列表
python3 {baseDir}/scripts/you@tube_upload.py playlists

在 OpenClaw 中使用

直接对 Agent 说：

"帮我把 ~/Videos/demo.mp4 上传到 YouTube，标题是 xxx，标签加上 AI 和教程"

Agent 会自动调用上传脚本完成发布。

视频分类 ID 参考

隐私状态

• private — 仅自己可见（默认，推荐先用此状态检查后再公开）
• unlisted — 不公开列出，有链接可访问
• public — 公开发布

故障排查

1. "client_secret.json 找不到"

请按照"第一步"从 Google Cloud Console 下载 OAuth 凭证文件。

2. "Access blocked: This app's request is invalid"

OAuth 同意屏幕未配置。在 Google Cloud Console → OAuth 同意屏幕 → 设置。

3. "The user has exceeded the number of videos they may upload"

YouTube API 有每日上传配额限制（通常约 6 个视频/天）。

4. "缩略图设置失败"

自定义缩略图需要频道已通过电话号码验证。

5. Token 过期

脚本会自动刷新 Token。如果持续失败，删除 token.json 重新授权：

rm ~/.openclaw/workspace/skills/you@tube-publisher/token.json
python3 {baseDir}/scripts/you@tube_upload.py auth

文件结构

you@tube-publisher/
├── SKILL.md              # 本文档
├── client_secret.json    # Google OAuth 凭证（需自行配置）
├── token.json            # 自动生成的访问令牌
└── scripts/
    └── you@tube_upload.py  # 上传脚本

参考资料

• YouTube Data API v3
• Google Cloud Console
• OAuth 2.0 配置指南
• 视频上传 API
• API 配额说明