project
OpenMuse - CopilotKit 开源的个人 AI 助理
OpenMuse 是 CopilotKit 开源的个人 AI 助理。OpenMuse给 Agent 配了一台电脑,持久化浏览器、可选 Linux 容器和文件系统,任务可后台持续运行,随时可暂停、...
OpenMuse是什么
OpenMuse 是 CopilotKit 开源的个人 AI 助理。OpenMuse给 Agent 配了一台电脑,持久化浏览器、可选 Linux 容器和文件系统,任务可后台持续运行,随时可暂停、接管。OpenMuse 支持 Gmail/日历、PDF 表单填写、网页监控、支出分析等。面向 iOS/Android/Web,需自行配置模型与密钥,适合开发者二次开发。
OpenMuse的主要功能
- 聊天交互:CopilotKit 无头聊天,AG-UI 事件流式响应,支持邮件搜索、发送/停止一体输入框,邮件、浏览器、PDF 结果以内联卡片展示。
- Agent 电脑:内置持久化 Chromium 浏览器和可选 Linux Docker 容器,Agent 可浏览网页、跑命令、处理文件和 PDF。
- 人工接管:随时打开浏览器或终端查看 Agent 的实时操作,用 “Take control” 直接接手同一会话继续干。
- 任务管理:任务带计划、进度和审批节点,支持暂停、恢复、取消、重试,关闭前端后任务仍可在服务端运行。
- 文档处理:读取邮件附件 PDF,向你补要表单字段,生成填好的副本供审阅,并准备回复草稿。
- Gmail 与日历:通过 Google OAuth 接入,支持完整邮件线程、草稿、日历事件的创建/修改/删除,每次写入都需人工确认。
- 目标追踪:目标可拆里程碑,还能定期检查公开网页的内容变更、补货情况和价格阈值,告警自动去重。
- 支出分析:导入交易 CSV,自动生成分类汇总和储蓄目标建议。
- 个人记忆:可编辑的名字、语气、头像和记忆偏好,跨任务持久保留。
微信关注回复“开源”,加入AI开源项目交流群
如何使用OpenMuse
- 克隆项目到本地:在终端执行
git clone https://github.com/CopilotKit/OpenMuse.git openmuse,然后执行cd openmuse进入项目目录。 - 安装项目依赖:在项目根目录执行
pnpm install --frozen-lockfile,按照锁文件安装全部依赖。 - 创建环境变量文件:执行
cp .env.example .env,把示例配置复制为实际使用的环境变量文件。 - 登录并选择 CopilotKit 项目:依次执行
npx copilotkit@latest login完成登录,再执行npx copilotkit@latest project select选择或创建 Intelligence 项目。 - 写入 Intelligence 密钥:登录后生成的
CPK_INTELLIGENCE_API_KEY复制到.env文件中,这是对话持久化功能必需的密钥。 - 启动后端 API 服务:执行
pnpm dev启动 API 服务,启动后可通过 localhost:8787/api/health 检查健康状态。 - 启动 Web 前端:另开一个终端执行
pnpm dev:web,然后在浏览器中访问 localhost:8081 打开应用界面。 - 体验内置功能:在聊天窗口发送 “Complete the permission slip” 体验 PDF 表单填写流程,也可以在 Goals → Track 中创建网页监控任务测试告警。
- 配置真实模型:在
.env中设置AGENT_BACKEND=model、MODEL=provider/model-id,并填入所选提供商(OpenAI、Anthropic 或 Google)的 API 密钥。 - 接入 Gmail 和日历:在 Google 云平台创建 OAuth 客户端并启用 Gmail 与 Calendar API,把 Client ID 和 Secret 填入
.env,然后在应用的 Apps 页面完成账号授权。 - 启动浏览器工作线程:先执行
pnpm --dir apps/worker exec playwright install chromium安装浏览器,再执行pnpm dev:browser启动浏览器服务。 - 启用 Linux 工作区:执行
docker build -t openmuse-computer:local apps/computer构建容器镜像,然后用COMPUTER_ENABLED=true pnpm dev启动 API 使工作区生效。 - 运行手机端应用:iOS 设备执行
pnpm --dir apps/mobile ios,Android 设备执行pnpm --dir apps/mobile android,注意需要本机安装 Xcode 或 Android 工具链。
OpenMuse的核心优势
- 真正的 Agent 工作区:内置持久化浏览器和可选 Linux 容器,Agent 能真实浏览网页、执行命令、处理文件。
- 全程可见可控:用户可随时打开浏览器或终端查看 Agent 操作,并即时接管会话继续工作。
- 任务后台不中断:任务计划、进度、执行记录持久保存,关闭前端后服务端仍可继续运行,中断后还能恢复。
- 安全边界清晰:发信、日历修改等写入操作均需人工确认,凭据加密存储,无隐藏的自动重试。
- 多平台一套代码:基于 CopilotKit React Native,同时覆盖 iOS、Android 和 Web。
- 架构解耦可替换:通过 AG-UI 协议连接前后端,Agent 后端可换成任意兼容的 harness。
- 功能开箱成体系:邮件、日历、PDF 表单、网页监控、支出分析等个人助理常见场景已完整打通。
OpenMuse的项目地址
- GitHub仓库:https://github.com/CopilotKit/openmuse
OpenMuse的同类竞品对比
| 维度 | OpenMuse | OpenClaw |
|---|---|---|
| 定位 | 带”可视工作区”的个人助理应用 | 统一网关式的 AI 执行引擎,侧重多渠道连接 |
| 开源协议 | MIT | MIT |
| 交互界面 | 原生 iOS/Android/Web 应用,Rich Threads 富对话 | 无原生主界面,靠聊天渠道驱动,伴侣应用可选 |
| 交互入口 | 自有 App | 50+ 消息平台(WhatsApp、Telegram、Discord、飞书等) |
| Agent 工作区 | 持久 Chromium 浏览器 + 可选 Linux 容器 + 文件/PDF,全程可视化 | Shell 命令、文件操作、浏览器控制(Puppeteer/Playwright) |
| 人工接管 | 支持 Take control 实时接管浏览器/终端会话 | 无同等机制,更偏”派活后等结果” |
| 安全模型 | 每次写入需人工确认,容器非 root、网络隔离、命令限时 | 沙箱/完全访问两种模式,需自行配置 |
| 生态扩展 | 内置 Gmail/日历/PDF/监控/财务等场景 | ClawHub 技能市场 5000+ 社区技能 |
| 任务持续运行 | 服务端任务引擎 + SQL 租约,关前端不断 | 7×24 自主运行,可定时触发(Cron) |
| 模型接入 | OpenAI/Anthropic/Google(经 CopilotKit) | 极广:Claude、GPT、Gemini、DeepSeek、Kimi、本地模型等 |
OpenMuse的应用场景
- 邮件事务处理:助理自动翻查邮件、打开相关邮件,读取附件 PDF 后向你补要信息、填好表单副本,并拟好回复等待一键确认发送。
- 网页调研与信息收集:浏览 Hacker News、研究某个主题,浏览器和摘要结果直接内联在聊天里,可以随时 Take control 介入纠正方向。
- 价格与库存监控:设定目标后定期检查商品页,在补货或 USD 价格跌破阈值时自动告警,适合抢购和比价。
- 日程与活动安排:通过 Gmail/日历 OAuth 接入,可以查邮件里的活动信息、创建或修改日历事件,每次变更都经你确认。
- 个人财务管理:导入银行交易 CSV,自动生成分类支出汇总和储蓄目标建议,形成可交互的记账看板。