CopilotKit/OpenDuet
AI 工程一个自托管的主动型 Agent 模板:整理邮件、日历和 Slack,执行动作前先向你确认。
把 OpenDuet 当成一个可运行的「主动型助手」模板更合适,而不是装好就能日用的成品。真正值得研究的是审批网关和分诊逻辑;外围应用仍处在早期。
解决什么问题
常见助手是被动的:你提问,它回答。主动型助手反过来:早上先给你一份简短简报,把邮件、日历和 Slack 中需要你决定的事挑出来,其余先压着;你离开后它继续在自己的浏览器和 /workspace 里干活。按文档描述,OpenDuet 会连接你的 Gmail 和 Google Calendar 生成这份简报,并支持按日程运行的 routine。凡是会改变外部状态的动作,都会停下来让你选拒绝、仅允许一次或始终允许;对外发消息则每次都要确认,并显示收件人和内容。
有什么不同
OpenDuet 是搭在 OpenBot(CopilotKit 的自托管 Agent 平台)上的租户包。OpenDuet 独有的东西都在 openbot/examples/openduet 里的 YAML 中:品牌名、Bot、指令、渠道、模型和技能。真正关键的机制是网关:每次工具调用都先经过策略检查并留下审计记录,然后才执行,Agent 的计算机因此是被监管的,而不是被直接信任。分诊和晨间简报则建立在 OpenBot 的 routine 之上,让 Agent 以你的身份在固定时间运行。
这个设计有代价。整套应用带着 Hono 服务端、CopilotKit runtime、带 pgvector 的 PostgreSQL、worker 以及每个 Bot 的 Docker 计算机。采用这个模板就意味着采用或改造这套栈。凭据方面,文档说是通过遮罩式密钥框处理,已保存的凭据加密且只写;这是作者的设计说明,没有独立验证。README 也明确说项目尚早、仍在积极开发,所以变动的更可能是租户包本身,而不是平台底座。
谁值得试
适合:已经在考虑 CopilotKit 或 OpenBot 的开发者或小团队,想要一个能跑起来的参考,看看受控的 Agent 动作、分诊和定时任务怎么串起来,并且能读 TypeScript 和 YAML。不适合:希望明天就能用上个人助手、不想折腾 Docker、PostgreSQL、Bun 服务和 Google OAuth 的人。如果只是想看机制,示例租户包是更省事的入口;要接 Gmail 和日历,还需要管理员先注册 Google OAuth 客户端,做不到这一步的人只能使用流程中与 Google 无关的部分。
使用条件与边界
硬依赖是 CopilotKit Intelligence:它保存会话线程和记忆,README 说没有它的 key 服务端无法启动,免费的 Developer 计划即可。此外还需要 Docker、Bun 1.3+、用于 CopilotKit CLI 的 Node,以及一个模型 key。快速开始里有一个 setup 脚本,必须在仓库根目录运行,因为它从当前工作目录读取 .env 和 .copilotkit/,并把 CPK_INTELLIGENCE_API_KEY 复制成服务端实际读取的变量名。
长期维护的重点不在安装,而在接触面:Google Cloud 的 API 与 OAuth 配置、通过 Composio 接入的 Drive 和 Notion 等 MCP 连接器,以及不断累积的策略记录。功能表里列出的能力才是文档声称今天可用的,README 也提醒会有变化。项目采用 MIT 许可,允许复制和修改。
HotRepo 点评
HotRepo 的追踪从 2026-05-10 开始,比仓库自称的 6 天年龄还短;唯一记录是 2026-10-28 的一次快照:481 个总 star,在 TypeScript 新项目榜上排第 14。这不是总榜名次,也不是单日增量,而且没有可比的历史,因此无法判断热度能否持续。动手前建议先核对 Intelligence 的 setup 脚本与你 .env 的实际行为,不要假设快速开始完全不需要手动处理 key。
本文由 AI 根据项目 README 生成,更新于 2026年10月28日,以项目官方文档为准。