YouTube 视频发布（youtube-publish）

通过 YouTube Data API v3 上传视频，支持断点续传、标题/描述/标签、可见性设置。使用 Google OAuth2 认证。

前置条件

1. Google Cloud Console 创建项目，启用 YouTube Data API v3
2. 配置 OAuth2 凭据（client_secret.json），设置重定向 URI
3. 首次运行需浏览器授权，后续自动使用 refresh token
4. 安装依赖：pip install google-auth-oauthlib google-api-python-client

配置

将 OAuth2 凭据文件保存为 ~/.openclaw/credentials/youtube_client_secret.json

首次授权后 refresh token 自动保存到 ~/.openclaw/credentials/youtube_token.json

使用方式

通过 PATH 调用 wrapper，无需拼接脚本路径。

python3 /home/wukong/wiseflow-pro/skills/youtube-publish/scripts/publish_youtube.py \
  --title "视频标题" \
  --video video.mp4 \
  --description "视频描述" \
  --tags AI,科技,工具 \
  --visibility public

Shorts 发布：

python3 /home/wukong/wiseflow-pro/skills/youtube-publish/scripts/publish_youtube.py \
  --title "#shorts 标题" \
  --video shorts.mp4 \
  --visibility public

参数说明

Agent 工作流

1. 检查 OAuth2 凭据文件是否存在
2. 准备视频 + 标题 + 可见性
3. 运行 publish_youtube.py 脚本
4. 首次运行会输出授权 URL，用户需在浏览器中完成授权
5. 检查 stdout JSON 输出：
   • {"ok": true, "video_id": "xxx", "url": "https://youtu.be/xxx"} → 成功
   • {"ok": false, "error": "AUTH_REQUIRED"} → 需要用户完成 OAuth2 授权
   • {"ok": false, "error": "..."} → 其他错误

错误处理

上传韧性（resumable + 自动续传）

脚本采用 256KiB 分片 resumable upload，遇 SSLEOFError / 读超时 / 连接重置时，自动用 Content-Range: bytes */<total> 查询 YouTube 已持久化的 offset 并从该处继续；Expect: 100-continue 已禁用。无需人工干预。

可调环境变量：