自动短片（autoshorts）

AutoShorts — 每日病毒式短片管道 管道工具位于 ~/Documents/skill-autoshorts/。每天，该技能从 INPUT_FOLDER 中选择一个长视频，提取每个可行的短视频片段（Gemini 3 Flash 决定），将它们显示给用户进行审批，并通过 Upload-Post 发布已批准的内容。

设置（仅当尚未配置时）

• Python 环境

cd ~/Documents/skill-autoshorts && python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt

• FFmpeg

系统二进制文件。使用 ffmpeg -version 验证。若缺失，使用 brew install ffmpeg 安装。

• .env 文件

位于 ~/Documents/skill-autoshorts/.env。所需键： UPLOAD_POST_API_KEY=... UPLOAD_POST_PROFILE=... GEMINI_API_KEY=... INPUT_FOLDER=/abs/path/to/long/videos OUTPUT_FOLDER=/abs/path/to/clip/output WHISPER_MODEL=medium TIMEZONE=Europe/Madrid 如果缺少所需键，询问用户在继续之前提供。

• Upload-Post 账户

在 https://upload-post.com 注册 → https://app.upload-post.com 的仪表板。通过 OAuth 在仪表板中连接 TikTok、Instagram（业务/创作者账户链接到 Facebook 页面）和 YouTube。在“管理用户”中创建一个配置文件 —— 其名称是 UPLOAD_POST_PROFILE（不是社交媒体用户名）。在“设置”中生成 API 密钥。验证：curl -H "Authorization: Apikey $UPLOAD_POST_API_KEY" https://api.upload-post.com/api/uploadposts/me。

编排模型 该技能每天由 openclaw Harness 调用，openclaw 也处理消息桥（Telegram、WhatsApp 或 openclaw 配置的任何通道）。该技能本身不直接与 Telegram 或任何消息应用程序交互 —— 它只运行管道并以文本 + 绝对文件路径呈现候选项。openclaw 将您的输出转发到用户的手机，捕获用户的回复，并将其反馈到对话中。

具体来说：在步骤 5 中，您打印候选表并询问哪些 ID 要发布；openclaw 通过用户选择的通道传递该表以及剪辑文件；用户在手机上回复（例如“1、3、5”）；openclaw 将该回复注入回对话中；您继续执行步骤 6-8。同样的模式适用于工作流中的任何其他“询问用户”点（元数据审查、模拟运行确认等）。如果该技能在 openclaw 之外调用（例如，用户在 Claude Code 中直接运行 /autoshorts），相同的提示将起作用 —— 它们只会出现在终端中，而不是在手机上。

每日工作流 该技能旨在作为每日无限循环运行。每次运行选择一个视频并将其引导通过管道。选择语义为每个周期轮流：每个视频每个周期最多被选取一次。当 INPUT_FOLDER 中的每个视频在当前周期中都已处理时，新周期将自动开始，相同的视频将再次可用 —— 从已剪辑的源生成新剪辑。位于 state/processed.json 的状态文件跟踪每个视频的 cycle_started_at、last_processed_at 和 cycles_count。

在一个周期内，下一个选取的是未处理的最新视频（mtime DESC），因此新材料始终跳过队列。

步骤 0 —— 预飞行（在每次调用时运行，不要跳过） 在执行任何工作之前，检查环境是否已准备好并询问用户提供任何缺失的内容： venv —— ~/Documents/skill-autoshorts/venv/bin/python 是否存在？如果不存在，请运行设置步骤 1。 ffmpeg 在 PATH 中 —— 如果缺失，请询问用户使用 brew install ffmpeg 安装（不要自己安装；系统范围的安装需要确认）。 .env 文件 —— 检查每个所需键是否设置并非空： GEMINI_API_KEY —— 如果缺失，请询问：“Falta la API key de Gemini. Pégamela (la generas en https://aistudio.google.com/apikey).” UPLOAD_POST_API_KEY 和 UPLOAD_POST_PROFILE —— 如果缺失，请询问：“Necesito la API key de Upload-Post y el nombre del profile (Manage Users en https://app.upload-post.com).” INPUT_FOLDER 和 OUTPUT_FOLDER —— 如果缺失，请默认为 ~/Documents/skill-autoshorts/input 和 ~/Documents/skill-autoshorts/output 并将其写入 .env。 WHISPER_MODEL —— 默认为 medium。 TIMEZONE —— 默认为 Europe/Madrid。 Upload-Post 平台健康状况 —— 调用 GET /api/uploadposts/users 并为配置文件上的每个平台读取 reauth_required。如果任何平台需要重新授权，请现在提出它，以便用户知道要么重新授权（https://app.upload-post.com），要么稍后从 --platforms 中删除它。

如果用户在对话中提供 API 密钥，请立即将其写入 .env，绝不回显它，并警告用户该密钥现在在对话日志中，他们应该在测试后旋转它。

输入视频格式：INPUT_FOLDER 中的视频预计已经是 9:16 垂直并准备好发布（1080×1920 典型）。如果用户有烧录字幕，则应已经在源视频上。如果视频以横向或任何非 9:16 比例到达，请提出它。