OpenCreator：不自己写 Agent loop，十个创作工具挂在 Codex 上，Linux 桌面版缺席
今天拆的是 OpenCreator：一个不自己写 Agent 内核、把 Codex CLI 当执行引擎来用的本地创作工作台；文章给全它在这一层的位置、四条上手路径、十处已知阻塞，以及那笔分别落在 Codex 与各家模型服务上的账。
krillinai/OpenCreator 的
apps/ 下装着四样东西：一个 React 前端、一个本地 Runtime、一个 Electron 宿主和一个命令行验收工具——唯独没有 Agent 内核，因为内核用的是别人的 Codex CLI。1 2026-10-03 查时 12,562 star / 1,288 fork / 872 次提交 / 45 个 tag / 36 个 release / 5 个分支，Apache-2.0，TypeScript，默认分支 master，主分支最后一次推送是 2026-10-02 21:55（UTC+08）。2它以前叫 KrillinAI——一个给视频做字幕翻译与配音的工具，那一批 2025 年提的问题单今天还挂在列表里。改名发生在 2026-09-05：当天 17:00 发的还是「KrillinAI v3.0.0」，18:34 发的下一版署名就换成了「OpenCreator v3.0.1」。3 从 v3.0.0 到这一个月里的 v3.2.4，一共发了 9 个版本，最新一版落在 2026-10-02 21:56（UTC+08），距现在不到十小时。3
它在链条上站在哪一层
把前几期拆过的方案按层摆一遍：HyperFrames 和 Remotion 是渲染底座，负责把一份工程拍成 mp4；hypit 是工作流描述语言；OpenChatCut 和 Diffusion Studio 是编辑器；Toonflow 是画布工作台；video-use 是装进编码 Agent 的剪辑技能包；上一期 ViMax 最特别，它自己造了一套 Agent runtime。
OpenCreator 也不在这几层里，但它跟 ViMax 的做法正好相反：ViMax 把 Agent loop 自己重写了一遍，OpenCreator 一个字节都不写。它 2026-07-03 那份架构文档把原则写成一句话——「能用 Codex 的就用 Codex，不重新实现一套 Agent loop、Skills runtime 或 MCP runtime」。4
同一份文档的第 3 节列了十条「第一版明确不做」，前八条读完，它把自己摆在哪儿就清楚了：不自研 Agent loop、不自研 Skills runtime、不自研 MCP runtime、不做长期记忆系统、不做企业登录与租户与审批与审计治理、不做多 Agent 协作编排、不做云端 Agent 执行服务、不 fork Codex 的界面当产品底座；后两条说的是节奏——第一版不做完整桌面界面，也不做 Electron 打包。4
所以它在这一层是宿主外壳：Codex 负责思考、调工具、读写文件、跑命令，OpenCreator 负责进程生命周期、事件、状态、日志、调度，以及外面那层给你看的界面。4
它在这一层怎么做事
外壳分四块：
apps/web 是唯一的 React 前端，apps/daemon 是本地 Runtime（Fastify 加 SQLite），管项目、Run、审批、定时、记忆与通知；apps/desktop 用 Electron 加载同一份 Web 构建产物，只额外提供目录选择、窗口生命周期、托盘和系统通知；apps/harness 是给命令行做验收用的。Web 和桌面端共用一套界面与 Runtime 行为，不是两份实现。5它跟 Codex 的接法写得很硬：用
codex exec --json 作为唯一执行内核，prompt 从 stdin 进，Codex 的事件以 JSONL 从 stdout 出，再由 daemon 归一化成自己的事件协议、经 SSE 推给界面；前端不直接拉 Codex，也不依赖 Codex 原始的 JSONL 格式。4 剩下的事全部透传：Skills 装进当前 CODEX_HOME/skills 交给 Codex 原生加载，MCP 用 codex mcp 或原生 config 管，Profile 走 codex -p，模型走 --model，沙箱走 --sandbox，登录走 codex login。4创作那一侧是十项工具：视频翻译、视频下载、封面生成、图像生成、文章写作、小红书帖子、短视频脚本、火柴人动画、智能配音、视频生成，另有两项标着「开发中」——长视频切片 Auto Clips 和数字人。5 视频翻译那一档官方写的是 14 种源语言、101 种目标语言；视频下载支持 YouTube、Bilibili、X、TikTok、Instagram、抖音、Facebook、小红书和 Pinterest，但官方同时写明可用性因视频和地区而异、部分源需要平台 cookie，小红书必须贴完整的公开链接并带
xsec_token，Pinterest 只支持单个 pin，而且它不会自动导入浏览器的 cookie。5再往下一层是可复用的东西：仓库根目录
template/ 下有 108 份模板（按 template.json 计数），6 skills/ 下有 7 个技能包——CLI、字幕、配音、横版渲染、竖版渲染、封面，以及一个只做计划校验的 pipeline。7
docs/images/product/opencreator-dashboard-en.png：左侧导航是 Home / Dashboard / Plugins / My Projects / Settings，中间顶部并排摆着 Stick Figure Animation、Translate & Dub Video 和 Digital Avatar 三张入口图，下面按 Video Creation、Image Creation、Audio、Video Editing、Avatars 分成十二个方块——其中 Auto Clips 与 Digital Avatar 在 README 的工具表里标的是「开发中」。5同一份材料内部还有两处口径对不上，一并摆出来。官网首页写的是「GitHub Stars 12.0K、Contributors 21、Countries represented 98」，而仓库当天是 12,562 star，README 自己写的是「至少 99 个国家与地区的 GitHub 用户点过 star」。18 另一处是能力状态：官网把「智能剪辑——自动找出精彩片段」当已上线能力展示，仓库自己的工具表把它标成开发中。58
你要给什么，它交回什么
| 你提供 | 它交回 |
|---|---|
| 一台 macOS（Apple 芯片或 Intel）或 64 位 Windows 10/11 的机器；Linux 桌面版官方明确说还没有8 | 十项创作工具加一个 Agent 会话，两种操作方式共用同一份工程状态5 |
| 一个能用的 Codex 登录态，或者一套自己的模型服务配置5 | 复用 Codex 的模型、工具调用、会话与审批流，不另起一套4 |
| 每一类 AI 服务各自的 Base URL、API Key、模型名——模型、转写、语音、图像、视频分开配5 | 工程、Run、附件与脱敏日志留在本机 .runtime/ 下；Codex 的会话与配置留在 $CODEX_HOME，要单独备份5 |
| 一句自然语言，或者直接在可视化工作台里改5 | 每次修正生成一个新版本，旧版本的设置与产出都留着5 |
接受 pipeline 只能干跑：真实工作要按阶段一条条跑，靠 krillinai_manifest.json 记产出与断点9 | 一个嵌在桌面端里的 CLI 与 Server，可以单独打包单独跑5 |
docs/images/product/opencreator-ai-services-en.png：设置里的 AI Services 把模型、转写、语音、图像、视频拆成五个页签，每一类各自填 Base URL、API Key 与模型名；模型那一栏下面写着「OpenCreator Agent 与文本任务共用这份 OpenAI 兼容配置」，两个勾分别标着 Agent ready 与 Text tasks ready。上面那一栏就是「你要给什么」的实物——没有一份配置是全站通用填一次的。5最短上手路径
第一条，桌面安装包（最短）。 从 releases 下载对应安装包（macOS Apple 芯片、macOS Intel 或 Windows x64），装完直接打开，不需要 Node.js 或 pnpm——安装包内置了 Codex CLI。首次启动会扫描你本机的 Codex 配置，认出可用的登录态或 API Key 就让你确认「Use local Codex and continue」，也可以在同一流程里配别的供应商。5 但真正的模型任务仍然要有一个可用的 ChatGPT 登录或 API Key。58
docs/images/product/opencreator-codex-setup.png：装完第一次打开，先过这一关——选供应商、填模型名、Base URL、API Key，或者点 Skip for now。跳过它，上面那十项创作工具就都停在入口。5第二条，从源码起 Web。 需要 Node.js 22 以上、pnpm 9.15.0（仓库用
packageManager 字段钉住）、一个能在终端里跑的 Codex CLI，以及一个有效的 Codex 登录。5git clone https://github.com/krillinai/OpenCreator.git
cd OpenCreator
corepack enable
pnpm install
pnpm web:dev打开
http://127.0.0.1:19861/；开发服务器按需拉起本地 daemon，并通过同源代理注入一个临时 Runtime token，不用手工复制。5第三条，只要内核。
pnpm daemon:dev 单独起 daemon，它只监听回环地址，把连接地址和临时 token 打印一次到 stdout。5第四条，只用内嵌的 CLI 与 Server。
pnpm krillinai:build 会在 .runtime/build/krillinai/<平台>-<架构>/ 下生成 krillinai-cli 与 krillinai-server 两个可执行文件加一个 manifest。9 单独跑的时候，CLI 从进程工作目录读 config/config.toml：源码检出状态下要把工作目录切到 runtime/krillinai，再从 config-example.toml 复制一份配置，所有 --workdir、输入、输出路径都写成绝对路径。9 v3.2.4 的发布页里，Server 那一边多给了 Linux x64 的包——桌面端没有 Linux，Server 有。3按钱排的验收顺序：先确认 Codex 通——故障排查文档给的是
codex exec --json --skip-git-repo-check --sandbox read-only "Reply with OK only."；10 再跑一个不花钱的环节（模板浏览、脚本、文章）；最后才动图像与视频。会卡住的地方
没有 Codex 登录态，什么都跑不起来。 症状是装好之后所有工具都停在入口。触发条件是本机没有可用的 ChatGPT 登录或 API Key。这不是可选依赖：设计文档把
CODEX_AUTH_REQUIRED（Codex 未登录或凭证不可用）列为核心错误码之一，4 README 也写明「真正的模型任务需要一个可用的 ChatGPT 登录或 API Key 设置」。5 你能做的：先单独验证 Codex 本身，codex --version 之后跑一次只读的 codex exec --json，10 通了再进 OpenCreator。它默认共用你全局的
$CODEX_HOME。 症状是你在 OpenCreator 里装的技能或 MCP，跑到别的 Codex 项目里也出现了。触发条件是你没有做隔离。README 明确写着默认使用当前的 $CODEX_HOME、改动全局 Skills 或 MCP 配置前先确认影响，备份时 .runtime/ 与 $CODEX_HOME 也要分开备。5 你能做的：用 CODEX_HOME=/path/to/codex-home 起一个隔离环境。5想换掉 Agent 内核，这里没有路。 症状是你习惯 Claude Code，想把它接进来复用同一套工作台。触发条件是你的 Agent 不在 Codex 这一支。唯一执行内核被写成
codex exec --json，自研 loop 还被列进「第一版非目标」。4 你能做的：把它当「给 Codex 用的工作台」接受下来，或者去看自带 MCP、能挂别的客户端的方案（第 16 期 OpenChatCut 是那一路）。Linux 桌面版没有。 症状是你在 Linux 上翻遍 releases 也只找到 Server。触发条件是你拿 Linux 当工作机。官方 FAQ 的原话是「A Linux desktop build is not yet available」，安装包只有 macOS 两种和 Windows x64。8 你能做的：Linux 上走源码那条路（Node 22 加 pnpm 9.15 加 Codex CLI），或者只用 KrillinAI Server 跑视频翻译那一条产线。35
pipeline 命令只能干跑。 症状是你写了一份「字幕→配音→竖版双语」的计划，执行时拿到 unsupported_command。触发条件是你以为它有编排器。技能文档自己写着：非 dry-run 的 pipeline 执行不受支持，真实工作要按阶段一条条跑、共享同一个 --workdir；出错时先读 krillinai_manifest.json，别把贵的那一段重跑。11 你能做的：把每个阶段当独立任务提交，用 manifest 决定从哪一段续。端口 19861 是写死的。 症状是页面一直显示正在连接。触发条件是 19861 被别的进程占了。项目自带的故障排查文档第一条就是它——「该端口被占用时 Vite 会直接退出」；健康检查在
http://127.0.0.1:19861/.opencreator/runtime/healthz，应该返回 {"ok":true}。10 你能做的：先腾端口，或者干脆只起 daemon。Codex 的登录态会过期，它不会替你续。 症状是 Run 长时间没有输出。触发条件是 token 过期或被顶掉。故障排查文档给的判据是终端里出现
401 token_expired 或 refresh_token_reused，并明确「不要通过删除 OpenCreator 数据规避登录问题」，要重新登录 Codex。10 你能做的：先按上面那条只读命令验证 Codex，再回来看 Run Detail 里的诊断。「本机 Codex 生图」这条路刚刚才修。 症状是用 ChatGPT 登录态生图一直失败。触发条件是走登录态模式而不是 API Key 模式。v3.2.4（2026-10-02）的发布说明里，相关的一条写着修好了「local Codex image generation with ChatGPT sign-in」；3 开发文档补了两条边界：原生工具失败时不回退到 API 通道，并且会把子进程继承来的
OPENAI_API_KEY、OPENAI_BASE_URL、CODEX_API_KEY、CODEX_ACCESS_TOKEN 移除，避免误走别的认证通道。12 适用范围要写清楚：这是 2026-10-02 那一版的修复，更早的版本上仍然会踩到。你能做的：先跑一张图验证通道，再批量生成。公开问题单不是新架构的故障地图。 症状是你按 issue 搜索排错，搜出来的都是另一套程序的报错。触发条件是你在开放议题里找线索。25 条开放议题里最新的是 #331（2026-09-23 提交，标题只有「Luxury reality」）和 #323（2026-09-17 提交的合作邀约）；再往下大半是 2025 年 Go 版 KrillinAI 时代留下的——#287 的报错里出现
server/main.go，#286 问能不能只用本地 faster-whisper，#243 想要 NVIDIA Parakeet，#106 是一次 ffmpeg 报错（8 条回复）。13 改名与重写之后，新工作台几乎没有公开的故障记录。你能做的：把项目自带的那份《用户指南与故障排查》当第一手资料。10架构文档指定的那份权威契约，在默认分支上找不到。 症状是你想按最权威的那份文档核对运行契约。触发条件是照着架构文档第 0 节的指引去找。它写的是「以
docs/superpowers/specs/2026-07-03-codex-native-runtime-contract-design.md 为准，若两份文档存在差异，后者优先」，而 2026-10-03 从默认分支取到的文件清单里，docs/superpowers/specs/ 下只有一份 2026-09-20 的短片设计文档，没有这一份。414 你能做的：把 README 的架构表与错误码表当现行口径，别去找那份文件。许可与真实成本
仓库是 Apache-2.0，根目录 LICENSE 是标准的 Apache 2.0 全文，官网也标着「Open source · Apache-2.0」，商用、自部署、改成自己的产品都不设门槛。815 内嵌的那套 KrillinAI CLI 与 Server 同样是 Apache-2.0。16
但有两处不在它自己的许可覆盖里。一处是它内嵌的第三方渲染器：火柴人动画那一支走的是
@opencreator/stickman-remotion，依赖 remotion 4.0.473。17 Remotion 不是自由许可——个人与 3 人以下的公司免费，4 人及以上的公司必须买公司授权：走自动化渲染是每次 0.01 美元、每月最低 100 美元，手动创作是每席位每月 25 美元，企业版自每月 500 美元起。18 这条不是 OpenCreator 的条款，是它下面压着的那一层的条款，团队规模到了就会碰上。另一处是模板与第三方来源：那 108 份模板里混着独立创作者的作品，模板详情页会标出作者与原出处；视频下载那一侧受平台与地区限制，前面说过的小红书、Pinterest 与 cookie 那几条都是官方自己写下的。5
软件本身不收钱，钱从两处花出去。 一处是 Agent 那一层：Codex 的用量走你自己的 ChatGPT 套餐或 API Key。5 另一处是创作服务那一层：模型、转写、语音、图像、视频各自配置、各自计费——官方 FAQ 关于费用只有一句「第三方模型与外部服务按它们自己的定价收费」。8 也就是说，这个项目本身没有公布任何价目表，账单要你自己从各家服务商那里拼。这一点跟第 17 期的 Toonflow 一样。
要一个可核对的单价锚点，只能去服务商那边取。以它列出的 Veo 3.1 为例，Google 的标准档每秒 0.40 美元（720p 与 1080p）、4K 每秒 0.60 美元，Fast 档 720p 每秒 0.10 美元、1080p 每秒 0.12 美元；图像那边 Nano Banana 2 生成一张 1K 图 0.067 美元，Nano Banana 初代一张 0.039 美元。19 按这个价，一分钟成片的视频段，标准档 1080p 约 24 美元，Fast 档 720p 约 6 美元。这是服务商自己的标价，不是 OpenCreator 的报价，也不含它那十项工具可能重跑的倍数。
docs/images/examples/video-generation-seedance-en.png：右侧 Task summary 写得清楚——Provider 是 Seedance，Model version 是 Seedance 2.5，Format 是 Landscape 16:9，Resolution 是 1280×720，Duration 是 5 秒；左下角的成品是 OpenCreator-video-K7-gafBNAhxYiTo0.mp4，7.3 MB。这一格就是钱最多的那一格：视频按秒计费，一次五秒起。5和之前几期放在一起看
| 方案 | 你给它什么 | 它给你什么 | 它在这一层 | 许可与公开体量 |
|---|---|---|---|---|
| OpenCreator | 一台 macOS 或 Windows 的机器、一个可用的 Codex 登录态、各类服务各自的 Key | 一个工作台：十项创作工具加一个 Agent 会话，共用同一份工程状态与版本 | Codex 之上的宿主外壳 | Apache-2.0，12,562 star1 |
| ViMax（第 18 期） | 三类模型接口、一个工程目录、按天排的时间 | 从想法或剧本推到多镜头成片的一条产线 | 自带 Agent runtime 的多 Agent 编排 | MIT，12,532 star20 |
| Toonflow（第 17 期） | 一台机器、四类模型 Key、逐段授权 | 一张可继续编辑的无限画布工程 | 编排与工作台 | MIT，16,340 star21 |
| OpenChatCut（第 16 期） | 素材与一句自然语言 | 可撤销的真时间线工程 | 编辑器加 MCP | AGPL-3.0，2,086 star22 |
| hypit（第 15 期） | 一条参考视频 | 可重跑的 SVML 作品源码 | 工作流描述语言 | 改过的 Apache-2.0，18,878 star23 |
| HyperFrames（第 14 期） | 一份 HTML / CSS 工程 | 逐帧拍出来的 mp4 | 渲染底座 | Apache-2.0，55,865 star24 |
| Diffusion Studio（第 13 期） | 一份 JSX 时间线 | 同一份文件上的协同编辑 | 编辑器 | MPL-2.0，3,198 star25 |
| OpenStoryline（第 6 期） | 素材与一份 config.toml | 一条 18 节点的成片产线 | 自带 Agent 的产线 | Apache-2.0，3,453 star26 |
| video-use（第 2 期） | 一个装满素材的文件夹 | 读着词级转写稿剪出来的 final.mp4 | 编码 Agent 的剪辑技能包 | MIT，27,878 star27 |
| Remotion | 一份 React 工程 | 程序化生成的视频 | 渲染底座 | 自订许可（GitHub 识别为 NOASSERTION），61,579 star28 |
表里每个数字都是 2026-10-03 当天从各仓库重新取的。
今天该不该动手
今天就装。 你已经在用 Codex，想要一个能跑视频翻译与配音、封面、短视频脚本的地方，机器又是 macOS 或 Windows。这一类人今天装最划算：桌面安装包内置 Codex CLI，首次启动直接复用你已有的登录态，那十项工具不用自己拼管线。改名之后的版本节奏也还算密——从 v3.0.0 到 v3.2.4，一个月发了 9 个版本，最新一版落在十小时前。3
References
- 1krillinai/OpenCreator
github.com
- 2Commits · krillinai/OpenCreator
github.com
- 3Releases · krillinai/OpenCreator
github.com
- 4Codex-native 自有 Agent Runtime 技术方案
github.com
- 5README · krillinai/OpenCreator
github.com
- 6template/ · krillinai/OpenCreator
github.com
- 7skills/ · krillinai/OpenCreator
github.com
- 8OpenCreator 官网
open-creator.ai
- 9KrillinAI CLI Contract\
github.com
- 10OpenCreator 用户指南与故障排查
github.com
- 11krillinai-pipeline 技能
github.com
- 12本机 Codex 生图
github.com
- 13Issues · krillinai/OpenCreator
github.com
- 14
- 15LICENSE · krillinai/OpenCreator
github.com
- 16runtime/krillinai/LICENSE
github.com
- 17packages/stickman-remotion/package.json
github.com
- 18License & Pricing · Remotion
remotion.dev
- 19Gemini Developer API pricing
ai.google.dev
- 20HKUDS/ViMax\
github.com
- 21HBAI-Ltd/Toonflow-app\
github.com
- 220xsline/OpenChatCut\
github.com
- 23hypit-ai/hypit\
github.com
- 24heygen-com/hyperframes\
github.com
- 25diffusionstudio/editor\
github.com
- 26FireRedTeam/FireRed-OpenStoryline\
github.com
- 27browser-use/video-use\
github.com
- 28remotion-dev/remotion\
github.com
This story was produced automatically by a channel. One sentence is all it takes for Neodrop to keep producing for you.