设计#视频生成#视频剪辑

openstoryline-use:让智能体开服务、对话剪视频、在同一会话里改到满意

FireRedTeam 的 openstoryline-use 让智能体启动本地 OpenStoryline 剪辑服务,对话剪视频,并在同一会话里多轮改稿。

Skill 资料

安装命令
npx skills add FireRedTeam/FireRed-OpenStoryline --skill openstoryline-use

三条对话气泡对应创建会话、确认剪辑计划和沿用同一 session_id 改 BGM,底部是素材轨道经 filter_clips、generate_script、render_video 输出 mp4

FireRed-OpenStoryline 是一个能用自然语言剪视频的开源 Agent 应用,但它要自己开 MCP 服务和 Web 服务、填模型密钥、传素材、等渲染,一步走错整条流程就卡住。openstoryline-use 是它仓库里随附的操作手册式 skill:应用装好之后,智能体照它的步骤启动服务、创建剪辑会话、提交需求并核对产出的 output_*.mp4。

仓库按 Apache-2.0 开源,截至 2026-10-08 有 3,464 星,最近一次推送在 2026 年 7 月 31 日。它不是纯文档 skill,还带着 bridge_openstoryline.py 这类脚本。

它让智能体按什么顺序做事

openstoryline-use 默认应用已经装好,安装另有一个姊妹 skill openstoryline-install。它的步骤是:先向你要 LLM 和 VLM 各三项配置(模型名、base_url、api_key),用仓库里的 scripts/update_config.py 写进 config.toml;再按长驻进程启动 MCP 服务和 uvicorn agent_fastapi:app,MCP 服务可能要几分钟才就绪,期间不许杀进程;然后 POST /api/sessions 拿到 session_id,上传素材,用 bridge 脚本把你的需求发给剪辑 Agent。

等待阶段,它看 Web 服务日志里的节点推进,比如 filter_clips、group_clips、generate_script、generate_voiceover、render_video;只要日志还在走,就不当作失败。出片后它要汇报 session_id 和 .mp4 的完整路径。你想改,它就复用同一个 session_id 继续聊,系统重跑相应节点,在新的 render_video_* 目录里生成新的 output_*.mp4。

它约束了什么

  • 只听本机:服务默认绑定 127.0.0.1,你明确要手机或局域网访问才改成 0.0.0.0,并提醒只在可信网络用。
  • 不乱杀进程:启动命令后面禁止追加 head、grep、timeout、pkill 之类会截断日志或提前退出的包装。
  • 会话不丢:session_id 必须保存;服务提示上一条消息没完成时,等它,不新建会话。
  • 先问再动:素材路径、模型和密钥都向你要,不替你猜。
  • 端口冲突就换端口,不去抢占别的进程。

适合谁

已经把 OpenStoryline 跑通、想让智能体代为开服务和反复改稿的人。它不管下载素材和选模型,装好之后的运行和改稿才归它管,配音和转场的费用也要自己承担。另有一份面向 OpenClaw 加飞书的脚本,剪完直接把视频发进飞书。想让智能体从零装起,用姊妹 skill openstoryline-install,它会检查 Python 3.11 以上、ffmpeg、wget、unzip,再运行 download.sh 拉取模型和资源包。

先说清几个限制。这个 skill 的本职是驱动一个需要你自备模型密钥的应用:LLM 和 VLM 六个字段必填,找素材要 Pexels 密钥,配音要 MiniMax、字节或 302 的账号。AI 转场依赖第三方视频生成服务,官方 README 也提示成本偏高、效果不稳定。开源版自带的字体和音乐只能做基础效果,官方建议自建素材库来提升观感。

仓库里 .storyline/skills 下还有五个风格类 Skill,例如粗剪和字幕模仿,它们是应用内部的剪辑 Agent 在用,不会装进你的编码智能体,别把它们和这里的 skill 混为一谈。同类工具里,jianying-headless 走的是生成剪映草稿再人工精修的路线,而 OpenStoryline 是从素材检索到渲染一次对话跑完。