用途:AI Director 提供 AI 短剧生成的一站式方案,从创意概念到成片,涵盖 X2C 平台账号管理与计费。
多用户:每位用户的 X2C 凭据独立存于 credentials/{USER_ID}.json。调用脚本时需通过环境变量传入 USER_ID 或 TELEGRAM_USER_ID,例如:USER_ID=12345 node {baseDir}/scripts/ad-account-manager.js check-binding。OpenClaw 会从聊天上下文自动传入用户 ID。
主要模块:1)账号管理 ad-account-manager.js,支持发送验证码 send-code、验证并获取 API Key verify、查询绑定 check-binding、查看配置 config、解绑 unbind、用已有密钥直接绑定 bind --key。2)角色管理 ad-character-manager.js,每人最多 5 个自定义角色,支持 list、create(name、gender、image_url 必填,gender 可选 male/female/other,image_url 为公开 URL 且不超过 10MB)、delete。3)编剧 ad-writer,Agent 依据 references/AD-WRITER-GUIDE.md 生成完整剧本,输出标题、梗概、角色小传、大纲、分集与完整剧本。4)制片 ad-producer.js,支持 config、generate-script、script-status、produce-video、video-status 及 full-workflow,生成参数含 --mode(short_video/short_drama)、--duration(60/120/180/300)、--ratio(9:16/16:9)、--style、--language(zh/en)、--character-ids、--wait 等。
质量与迭代:quality-evaluator.js 用 Gemini 对视频质量打分,需 GEMINI_API_KEY;auto-iterate.js 可自动评估、改进提示词并重新生成至阈值。
费用:剧本 short_video 6 积分/$0.06,short_drama 60 积分/$0.60;视频按 60/120/180/300 秒分别为 299/599/799/999 积分,对应 $2.99/$5.99/$7.99/$9.99。
限制:生成前须与用户确认所有参数;仅使用配置内的样式与类别,不得自定义;集数固定(short_video=1、short_drama=10),每集只能提交一次制作;不得自动重试失败生成(消耗积分);生产环境建议用异步任务,避免 --wait 阻塞;视频 URL 需完整输出,不得截断,并移除 &response-content-disposition=attachment 以便浏览器播放。凭据也可通过 X2C_API_KEY 环境变量或 ~/.openclaw/openclaw.json 中相关字段配置。完整 API 文档见 references/X2C-OPEN-API.md。