核心用法
youtube-publisher 是一款面向内容创作者和运营人员的 YouTube 自动化上传工具，通过命令行或 Agent 指令即可完成视频发布全流程。用户需先在 Google Cloud Console 创建项目并启用 YouTube Data API v3，配置 OAuth 2.0 桌面应用凭证后，即可实现免浏览器干预的自动化上传。
工具支持丰富的发布参数：标题、描述、标签、分类 ID、隐私状态（private/unlisted/public）、自定义缩略图，以及自动添加到指定播放列表。大文件采用 10MB 分块断点续传机制，网络中断后可自动恢复。完成首次授权后，Token 自动本地存储并支持自动刷新，后续使用无需重复登录。
除上传功能外，还提供频道信息查询、已上传视频列表、播放列表管理等辅助命令，便于运营人员批量管理内容资产。在 OpenClaw 环境中，用户可直接通过自然语言指令触发上传，如"将 demo.mp4 上传为公开视频，标题为教程，标签添加 AI"。
显著优点
官方 API 保障稳定性：基于 Google 官方维护的 Python 客户端库，而非逆向工程或第三方封装，API 兼容性和服务持续性有充分保障。OAuth 2.0 标准授权流程确保账号安全，支持 Token 自动刷新避免频繁重新授权。
功能覆盖完整发布场景：从基础上传到精细化运营需求均有支持——断点续传解决大文件上传痛点，分类 ID 映射涵盖科技、教育等 15+ 垂直领域，隐私状态灵活控制发布节奏，缩略图自定义提升内容吸引力，播放列表集成便于系列内容组织。
开发者体验友好：提供详尽的故障排查指南，覆盖凭证配置、OAuth 同意屏幕、API 配额限制、Token 过期等常见坑点；文档包含完整的分类 ID 参考表和命令示例，降低上手门槛；代码结构清晰，便于二次开发或集成到 CI/CD 流程。
潜在缺点与局限性
API 配额严格限制：YouTube Data API 对上传操作有严格的每日配额限制（通常约 6 个视频/天），高频发布场景（如 MCN 机构批量分发）可能触发限速。此限制来自 Google 平台而非工具本身，需通过申请配额提升或分散到多个项目缓解。
前置配置复杂度：首次使用需在 Google Cloud Console 完成多步骤配置，包括项目创建、API 启用、OAuth 应用注册、测试用户添加等，对非技术背景用户存在认知门槛。凭证文件路径和权限设置也需严格遵循文档指引。
缩略图功能依赖额外验证：自定义缩略图需要频道已完成电话号码验证，部分新账号或地区受限账号可能无法使用该功能。此限制同样来自 YouTube 平台政策。
Token 明文存储风险：OAuth 凭证以明文 JSON 形式存储于本地目录，虽路径受控但存在被其他进程读取的理论风险，多用户共享环境需谨慎。
适合的目标群体
- 独立内容创作者：个人博主、知识分享者、教程制作者，需要稳定、可脚本化的发布工具替代手动网页操作
- 小型运营团队：MCN 机构初级成员、企业新媒体运营，负责规律性内容更新和播放列表维护
- 开发者与自动化爱好者：希望将视频发布集成到内容生产工作流（如配合剪辑脚本、定时任务）的技术用户
- 教育/科技领域创作者：常用分类 ID 27（教育）和 28（科技），工具提供的分类映射表对此类用户尤为实用
不适合：日更超过 6 条的高频发布者、完全无技术背景且不愿学习 Google Cloud 配置的用户、对 Token 安全有极高要求的企业环境。
使用风险
配额耗尽导致服务中断：YouTube API 上传配额为硬性限制，耗尽后当日无法继续上传，可能影响内容排期。建议监控用量并在关键发布前预留配额缓冲。
Token 失效与重新授权：虽然支持自动刷新，但 Google 安全策略变更或用户修改密码可能导致 Token 失效，需删除本地 token.json 重新走授权流程。
OAuth 应用审核状态影响：个人项目默认处于"测试"状态，需手动添加测试用户邮箱才能授权；若未来 Google 政策调整要求正式审核，可能影响使用。
依赖项版本兼容性：依赖 Google 官方库的大版本更新可能引入破坏性变更，建议锁定版本或及时跟进更新说明。
网络稳定性要求：断点续传虽能缓解中断问题，但极端网络环境下仍可能上传失败，重要内容建议保留本地备份。