如何10分钟安装部署OpenChatCutmacOS/Windows/Linux快速入门完整指南【免费下载链接】OpenChatCutOpen-source, local-first conversational AI video editor with a professional multi-track timeline, Agent Skills, MCP integration, and Remotion rendering.项目地址: https://gitcode.com/gh_mirrors/op/OpenChatCutOpenChatCut 是一款开源、本地优先local-first的对话式 AI 视频编辑器内置 Agent 可以直接读取工程、改写多轨时间线并导出成片。本文带你用约 10 分钟完成OpenChatCut 安装部署——无论是下载桌面安装包还是从源码本地部署macOS / Windows / Linux 三种系统都有对应步骤零基础也能照做完成。整个流程可以拆成 4 段阶段耗时内容① 准备约 2 分钟确认系统、选择安装方式② 安装约 3 分钟下载安装包 或npm install③ 启动约 2 分钟首次运行、打开本地地址④ 配置约 3 分钟创建项目、可选配置 AI Agent方式一下载桌面安装包最简单适合不想碰命令行的用户。官方提供三种平台的预构建安装包官方说明见 README.md 的 Quick Start 章节macOSApple Silicon 与 Intel 两个版本的 DMG 安装包Windowsx64 安装包Linuxx64 AppImagemacOS 首次启动如何放行早期构建的 macOS 安装包尚未签名和公证首次启动时系统可能会拦截。处理方式双击 DMG 将应用拖入 Applications首次打开若提示无法验证开发者前往系统设置 → 隐私与安全性点击仍要打开之后即可正常启动项目数据默认保存在本机。Windows / Linux 安装步骤下载对应安装包Windows x64 / Linux AppImageWindows 直接运行安装程序Linux 将 AppImage 赋予执行权限后直接运行首次启动后应用会在~/.openchatcutLinux 为~/.config/OpenChatCut等下建立本地项目存储。 桌面安装包开箱即用本地时间线编辑、内置素材、手动剪辑不需要任何 API Key即可使用。方式二从源码安装Node.js 24 一键配置适合开发者或想体验最新功能的用户。官方要求Node.js 24.x npm版本约束写在 package.json 的engines字段.nvmrc也标记了主版本 24。源码安装 5 条命令打开终端依次执行git clone https://gitcode.com/gh_mirrors/op/OpenChatCut cd OpenChatCut npm install cp .env.example .env.local npm run dev各步骤说明npm install安装全部依赖npm run dev前会自动同步 MediaPipe、Whisper CLI 等本地推理组件cp .env.example .env.local生成环境变量文件模板完整注释见 .env.example只需填写你实际用到的 AI 服务未配置的能力会明确提示缺 Key但不影响本地编辑npm run dev启动本地服务默认端口5199。Linux 安装依赖提速技巧在 Linux x64 上npm install默认还会从 NuGet 下载 ONNX Runtime 的 CUDA 组件数百 MB。如果你的机器没有 NVIDIA 显卡、只需要 CPU 推理可以跳过这部分ONNXRUNTIME_NODE_INSTALLskip npm install打开编辑器如何访问本地部署的 OpenChatCut服务启动后在运行 OpenChatCut 的这台电脑的浏览器中打开http://localhost:5199⚠️一个常见打不开的原因编辑器依赖浏览器的安全上下文Web Crypto、WebCodecs。必须通过http://localhost或http://127.0.0.1本机访问或走 HTTPS。从局域网其他设备用普通 HTTP 访问时工程列表能加载但编辑器会提示安全上下文要求而不会进入。启动成功后你会看到本地项目仪表盘——创建、导入、复制、导出多个真实工程都在这里完成第一次使用创建项目并导入素材点击New Project创建工程把本地视频、图片、音频拖进My Media素材池或点导入按钮在时间线上手动剪辑或直接在左侧聊天框用自然语言描述你想要的结果。开发模式下每个 Git 工作区的数据默认隔离存放在~/.openchatcut/dev-profiles/互不干扰。如果想用脚本一键启动自带 MCP token 管理仓库提供了 dev-with-mcp.sh./dev-with-mcp.sh对 AI 剪辑能力感兴趣的可以让 Agent 直接生成转场、字幕与背景音乐并写入真实的多轨时间线可选配置为内置 Agent 接入大模型本地编辑完全免费可用想启用对话式 AI 剪辑只需在设置 → Agent Model选择厂商并填入 API Key密钥只存在服务端不会暴露给浏览器。界面示意支持 Anthropic、OpenAI、Gemini、Kimi、Qwen、DeepSeek、MiniMax 等多家厂商也支持 OpenRouter 等兼容接口。使用 ChatGPT 订阅用户可先安装官方 Codex CLI再在设置 → Agent 模型 → OpenAI · Codex中通过浏览器或设备码登录。进阶连接 MCP让 Codex / Claude Code 直接编辑工程OpenChatCut 内置 Streamable HTTP MCP 端点外部 Agent 可以和编辑器共用同一套剪辑工具http://localhost:5199/api/external-mcp/mcp编辑器内打开MCP 指南弹窗可看到 Claude Code、Codex、Cursor 等客户端的一键连接入口仓库根目录的.mcp.json已预置本地连接配置。若需要把端点暴露到公网请在.env.local中设置OPENCHATCUT_MCP_TOKEN启用 Bearer Token 鉴权。安装失败常见排查清单现象原因与解决提示 Node 版本不符需要 Node 24.x24 25用nvm use切到.nvmrc指定版本局域网访问只显示需要安全上下文改用本机http://localhost:5199或 HTTPS 访问Linux 上npm install卡在 NuGet 下载无 N 卡时用ONNXRUNTIME_NODE_INSTALLskip npm installmacOS 首次启动被拦截系统设置 → 隐私与安全性 → 仍要打开未公证的早期构建AI 功能提示缺少 Key属正常现象只填你实际使用的服务本地编辑不受影响macOS 用户在导出时如遇渲染问题可参考 MACOS-RENDER-TUNING.md 了解 Apple Silicon 上的渲染并发调优中文完整文档见 README_ZH.md。总结10 分钟安装部署路线新手路线下载安装包 → 启动 → 创建项目 → 拖入素材5 分钟开始剪辑开发者路线git clonenpm installnpm run dev→ 打开localhost:5199→ 按需填写.env.local进阶路线接入大模型 API再通过 MCP 让 Codex / Claude Code 直接参与剪辑。OpenChatCut 坚持本地优先工程、素材与聊天记录都保存在你自己的机器上AI 联网能力完全由你决定何时开启。祝剪辑愉快【免费下载链接】OpenChatCutOpen-source, local-first conversational AI video editor with a professional multi-track timeline, Agent Skills, MCP integration, and Remotion rendering.项目地址: https://gitcode.com/gh_mirrors/op/OpenChatCut创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
