OpenMuse 部署:两条路线一篇文章走完
OpenMuse 是 CopilotKit 官方开源的个人 Agent 应用(MIT 协议,2026-09-15 发布 0.1.0-alpha,上线两周 GitHub star 约 3500,2026-09-30 查询为 3485),自带浏览器、终端和文件系统的「Agent 电脑」,任务会持续推进。部署它有两条官方路线:本地 pnpm 运行和 Render 一键部署。本地路线照官方 Quick start 走:Node 24 LTS、pnpm 11.19.0、克隆仓库、配一个 CopilotKit Intelligence project key,然后 pnpm dev 起服务;Render 路线用仓库根目录自带的 render.yaml 与 Deploy to Render 按钮。本文按 README 原样给出命令与验证步骤,并把 alpha 版的边界先讲清楚。
部署前必读:三个 alpha 事实
结论先行:OpenMuse 处于非常早期的 alpha 阶段,部署前要知道三件事,它们决定你对这套流程的预期。
第一,版本状态。目前只有 0.1.0-alpha 一个版本(2026-09-15,官方 CHANGELOG 仅此一条)。第二,部分集成未验收。官方 ROADMAP 明确列出:真实 Google OAuth、邮件、附件、日历在真实测试账号上的验收、Rich Threads 持久化与跨设备验收、真实模型的开放委派任务验收、Android 真机冒烟测试均未完成,官方不承诺日期。第三,账号依赖。Quick start 要求一个 CopilotKit Intelligence project key,需要登录 CopilotKit 官方账号生成,这是部署流程里唯一的外部账号依赖。项目背景与功能全景见OpenMuse 是什么。
动手段落之前,先给一份检查清单,全部出自官方文档:版本锁定 0.1.0-alpha,别期待稳定版行为;未验收项以 docs/VERIFICATION.md 与 ROADMAP 为准;Google 相关功能用测试账号,不用日常真实账号;CPK_INTELLIGENCE_API_KEY 只填 server-only key;一个部署只服务一个 owner。
本地运行:Quick start 命令原样照录
本地跑通 OpenMuse 一共六步,以下命令出自官方 README。前置条件:Node 24 LTS、pnpm 11.19.0、CopilotKit Intelligence project key;README 同时写明,本地示例应用不需要模型、Google 账号或 Docker。
git clone https://github.com/CopilotKit/OpenMuse.git openmuse
cd openmuse
pnpm install --frozen-lockfile
cp .env.example .env
npx copilotkit@latest login
npx copilotkit@latest project select
login 和 project select 两步会在 CopilotKit 官方账号体系里创建并选择项目,生成一个 server-only project key。把它填进 .env 的 CPK_INTELLIGENCE_API_KEY:
CPK_INTELLIGENCE_API_KEY=<你的 server-only project key>
然后启动:
pnpm dev
# 另开一个终端
pnpm dev:web
验证两个地址,对照下表:
| 地址 | 用途 |
|---|---|
| localhost:8081 | Web 界面(配合 pnpm dev:web 启动) |
| localhost:8787/api/health | API 健康检查 |
两个都通过,本地部署就完成了。
还有一点需要在部署后核对:部署形态不改变 Agent 电脑的能力边界——终端命令有边界、每条命令有回执、工作区文件持久、支持 PDF 导入导出、停止重启后任务可恢复(README 口径)。跑一条容器内命令看看有没有回执,比只看健康检查更能确认部署真的可用。
无需模型的体验路径
不配模型也能体验大部分功能,这是 OpenMuse 对新用户最友好的设计。README 原话:本地示例应用不需要模型、Google 账号或 Docker。官方另准备了一套 AI Mock 演示(docs/DEMO.md),无需模型就能走通演示流程。建议的顺序是:先把界面、任务队列、审批流跑起来,再决定要不要接真实模型与 Google 凭据。
Render 一键部署
Render 路线的入口就在 GitHub 仓库:根目录有 render.yaml 与官方 Deploy to Render 按钮,支持 Render 平台一键部署。部署参数(服务类型、环境变量、实例规格)以官方 render.yaml 为准——alpha 阶段这类文件随时可能调整,动手前先看一眼仓库里的当前版本。Intelligence key 等环境变量同样要在 Render 的环境配置里填好。
浏览器 worker 与真实模型配置
浏览器能力要配置模型之后才能发挥。架构上,OpenMuse 自带 server、task worker、browser worker 三个组件(官方 README 口径),浏览器过程由独立的 browser worker 承担,所以内联可见、可接管。配置模型后可以直接试官方给的两个任务:「看看 Hacker News 有什么好玩的」或「总结 copilotkit.ai」——浏览器过程内联可见,随时用 Take control 打开 Agent 的浏览器会话接管操作。这是验证 Agent 电脑是否真的在你部署的环境里转起来的最直接方式。
本地 dev 与 Render 部署怎么选
结论:先本地跑通,再上 Render 常驻,两条路线是先后关系,与二选一无关。
| 维度 | 本地 pnpm dev | Render 一键部署 |
|---|---|---|
| 适用场景 | 开发改造、体验 alpha、二次开发 | 常驻运行,手机随时委派任务 |
| 成本 | 本机资源加模型用量 | Render 平台计费,以官方 render.yaml 与 Render 定价为准 |
| 数据归属 | 本机 | Render 托管 |
| 上手方式 | 六步命令,需要 Node 24 与 pnpm | 点 Deploy 按钮,参数按 render.yaml |
表中数据归属一栏是工程建议,非官方口径:Render 托管意味着凭据与任务数据都在云上,敏感场景自己权衡。想在完全自己的服务器上跑 Agent 运行时的读者,可以对照本站 AgentDock 是什么——它面向服务器与容器场景,与 OpenMuse 的应用形态互补。
CopilotKit Intelligence key 是什么
一句话:CopilotKit 官方账号体系生成的 server-only 密钥,OpenMuse 的 Rich Threads 持久化依赖它。获取步骤就是 Quick start 里的 npx copilotkit@latest login 与 project select 两步——登录官方账号、选择或创建项目,把生成的 key 填进 .env 的 CPK_INTELLIGENCE_API_KEY。README 特意标注它是 server-only key:只应出现在服务端环境变量里,别打进客户端代码,也别提交进仓库。
边界与提醒:alpha 版不要交给它太多
三条边界全部出自官方文档。其一,Gmail 与日历功能需要真实 Google 凭据(Google OAuth 适配器),而真实账号上的验收在 ROADMAP 里尚未完成,alpha 阶段建议用测试账号。其二,终端网络禁用是官方的安全设计:容器里能跑命令,命令不能联网,联网能力只留给浏览器 worker。其三,当前 Linux 电脑一个部署只支持一个 owner(ROADMAP 口径),多人共用一个部署不在支持范围内。多用户认证、部署加固、保留/导出控制都在产品扩展计划里,同样不承诺日期。想把它和同类工具放在一起评估,见个人 AI Agent 选型对比。
常见问题
OpenMuse 怎么部署?
两条路线:本地按官方 Quick start 跑(Node 24 LTS、pnpm 11.19.0,git clone 后 pnpm install —frozen-lockfile,配 CPK_INTELLIGENCE_API_KEY,pnpm dev 加 pnpm dev:web);或用仓库自带的 render.yaml 在 Render 一键部署。展开说:本地验证看 localhost:8081 与 localhost:8787/api/health;部署后记住 alpha 边界——一个部署一个 owner。
OpenMuse 本地运行需要 API key 或模型吗?
需要一个 CopilotKit Intelligence project key(server-only),但本地示例不需要模型、Google 账号或 Docker——README 原话。展开说:key 通过 npx copilotkit@latest login 与 project select 生成,填进 .env;不配模型可以先用官方 AI Mock 演示(docs/DEMO.md)体验完整流程。
OpenMuse 可以部署到 Render 吗?
可以。官方仓库根目录自带 render.yaml 与 Deploy to Render 按钮,支持 Render 平台一键部署。展开说:这是 README 写明的官方路线,部署参数以当前 render.yaml 为准;Intelligence key 等环境变量要在 Render 配置好,Gmail 等需要真实 Google 凭据的功能在 alpha 阶段验收未完成,谨慎接入。