OpenDuet全景解析:什么是主动式AI Agent?开源免费、会主动找你的AI助手完整指南
OpenDuet全景解析:什么是主动式AI Agent?开源免费、会主动找你的AI助手完整指南
OpenDuet 是一个开源免费的主动式 AI Agent(proactive AI agent)模板,由 CopilotKit 团队基于 OpenBot 平台打造。与"你问它才答"的传统聊天机器人不同,OpenDuet 会主动找你:每天早晨推送简报、自动分拣邮件和日程里"需要你"与"可以等"的事项,在你离开时继续在自己的电脑上干活,并在执行敏感操作前停下来等你批准。
一、什么是主动式 AI Agent?先搞懂这个核心概念
传统 AI 助手是被动式的:你提问,它回答。而主动式 AI Agent 的工作方式更像一位真正的同事——
- 📬 主动打招呼:它先读你的邮件和日历,然后主动告诉你"你是谁、我能怎么帮你",并邀请你纠正它;
- ⏰ 自己安排时间:基于定时任务(Routines)按计划运行,而不是等你下达指令;
- 🔍 主动汇报:发现需要你处理的事,主动发消息给你;不需要你的,先压后处理。
OpenDuet 正是这一路线的开源实现,也是 CopilotKit 对 Claude Duet 这类"主动式助理"品类的免费开放方案,采用 MIT 协议(见 LICENSE)。
二、OpenDuet 能帮你做什么?核心功能一览
以下是当前版本即可用的能力(源自 README.md 的功能清单):
| 能力 | 对你意味着什么 |
|---|---|
| 🌅 晨间简报(Morning Brief) | 每天打开 Chat,简报已就位:今天有什么安排、哪些事需要你决策、哪些可以等 |
| 📥 邮件分拣 | 读取 Gmail 和 Google 日历,把"需要你"的顶到最前,每条附一句理由 |
| 💻 拥有自己的电脑 | 每个 Agent 独占一个容器:真实 Chromium 浏览器、/workspace 文件区和 shell,你离开时它继续干活 |
| ✅ 先问再动 | 发消息、付款、签字、删除前,展示确切动作并等待你选择:允许一次 / 始终允许 / 拒绝 |
| 🔐 看不到密码 | 登录时用遮罩输入框,密码直达网站,Agent 永远读不到 |
| 🛡️ 出站检查 | 每条外发消息都会扫描敏感信息,防止卡号、健康信息误发 |
| 🧩 技能(Skills) | 写一次、用 / 调用的可复用指令 |
| ✨ Make | 一句话生成设计系统、仪表盘、幻灯片、网页,成品以缩略图集中管理 |
| 📢 频道(Channels) | 为每块工作建频道,Agent 会打招呼并给出三个可立即开工的建议 |
| 🗣️ 语音输入 | 点按语音按钮口述任务,自动转文字发送 |
三、快速上手:如何 5 步本地跑起 OpenDuet
运行前需要 Docker、Bun(1.3+)、一个模型 API Key,以及一个免费的 CopilotKit Intelligence 项目(用于线程与记忆)。
git clone https://gitcode.com/gh_mirrors/op/OpenDuet
cd OpenDuet
cp .env.example .env
bun install
- 选择 Intelligence 项目:
npx --yes copilotkit@latest login后执行project select,再运行 setup-learning.ts 完成密钥配置; - 填模型密钥:默认使用 OpenAI 的
gpt-5.6-terra(见 model.yaml),在.env中填入OPENAI_API_KEY,也可换成 Anthropic 等其他供应商; - 一键启动:
bash scripts/start.sh,脚本会拉起 Postgres 与各个 Bot 容器、执行数据库迁移,再启动 API、定时 worker 和应用(见 start.sh); - 打开浏览器:访问
http://localhost:3010,按 Setup 清单连接 Gmail 与 Calendar 即可; - 停止服务:
bash scripts/stop.sh。
💡 没有 Google 账号?仓库自带一个 fake Google 演示服务,按 README.md 中 "Connect Gmail and Google Calendar" 一节的 5 个步骤即可体验全流程。
四、它是怎么工作的?一张图看懂架构
OpenDuet 构建在 OpenBot 平台之上,核心数据流是:
你(Web / Slack / Teams)→ OpenDuet 服务器(分拣 + 审批网关)→ AG-UI Agent(任意框架:LangGraph、Mastra、CrewAI、Pydantic AI、Google ADK 甚至手写)→ Agent 自己的电脑容器(Chromium +
/workspace+ shell)
三个关键设计值得新手记住:
- 审批网关(Gateway):Agent 的每一次工具调用都必须回到服务器,先过策略、写审计日志,然后才真正执行。OpenDuet 的默认策略是"发送、付款、签字、删除"一律先问人;
- 独立电脑容器:Bot 的浏览器操作被限制在自己的容器和出网策略内,数据库与容器网络隔离(详见 architecture.md 的 "Computers" 一节);
- 审计一切:每条操作都记录"谁授权的、谁触发的",无人值守(定时任务、Bot 互转)的运行会被单独标记,事后可在 Audit 页面筛选导出。
五、为什么敢让它主动干活?安全机制解析
"主动"最大的顾虑是失控,OpenDuet 用三层机制兜底:
- 审批优先:改变世界的动作(发消息、付款、删除)会暂停并展示确切内容与触发规则,你只需三选一:Allow once / Always allow / Refuse;
- 凭证隔离:密码通过专用遮罩通道直连网站,聊天记录只记录"请求过密码";存储的凭证加密且只写不读,API 永远不返回明文;
- 保守假设:无法被明确判定为"只读"的工具调用,一律按"写操作"对待;出站消息自动脱敏。
这些边界的设计细节可阅读官方架构文档 openbot/docs/architecture.md。
六、如何把它改成"你自己的"助手?
OpenDuet 从设计上就鼓励你复制改造——让它成为 OpenDuet 而非 OpenBot 的所有内容,都集中在一个目录 openbot/examples/openduet/ 里:
| 文件 | 决定什么 |
|---|---|
brand.yaml |
产品在所有界面上的名字 |
agents.yaml |
Bot 列表、角色指令、各 Bot 持有的技能 |
channels.yaml |
用户看到的频道及每个频道的应答 Bot |
model.yaml |
模型供应商与默认模型 |
skills.yaml |
可用 / 调用的技能及其所需工具 |
复制该目录、按需修改,再把 .env 中的 TENANT_PACKAGE_DIR 指向你的副本即可。底层 OpenBot 代码保持不变,因此上游更新可以随时合并。
七、官方文档与目录导览
| 资料 | 路径 |
|---|---|
| 项目总览与功能清单 | README.md |
| 架构与端口总表 | openbot/docs/architecture.md |
| 官方文档索引 | openbot/docs/README.md |
| Google Workspace 接入 | openbot/docs/plugins/google-workspace.md |
| 定时任务机制 | openbot/docs/routines.md |
| 遥测说明与关闭方法 | docs/telemetry.md |
| OpenDuet 租户包 | openbot/examples/openduet/ |
🔕 隐私提示:CopilotKit runtime 默认发送使用遥测,设置
COPILOTKIT_TELEMETRY_DISABLED=true或DO_NOT_TRACK=1即可关闭,发送内容详见 telemetry.md。
八、新手常见问题 FAQ
Q1:OpenDuet 免费吗?需要什么付费服务? 项目本身 MIT 开源免费;运行需要模型 API Key(按量计费)和一个免费开发者版的 CopilotKit Intelligence 项目(承载线程与记忆,没有它的密钥服务器不会启动)。
Q2:它绑定某个模型框架吗?
不绑定。任何符合 AG-UI 协议的 Agent 都可以接入,LangGraph、Mastra、CrewAI、Pydantic AI、Google ADK 等官方示例均包含在 openbot/ 目录中。
Q3:数据存在哪里? 完全自托管:PostgreSQL(含 pgvector)存储策略、审批、审计与加密凭证,线程和记忆在 CopilotKit Intelligence,Bot 的文件在各自容器的卷里。
Q4:适合生产环境吗? 官方标注"early development",功能活跃演进中;建议先在自己的环境体验并提 Issue 反馈。
总结:为什么值得尝试 OpenDuet
🎯 一句话总结:OpenDuet 把"AI 主动干活、人来把关"这件事做成了开源模板——它主动简报、主动分拣、主动继续工作,但在发送、付款、删除前永远先问一句。
- ✅ 开源免费(MIT),自托管、选自己的模型,数据留在自己的数据库;
- ✅ 审批 + 审计 + 凭证隔离三重护栏,适合新手理解"负责任的 Agent"该如何设计;
- ✅ 一个 YAML 目录即可换名换 Bot 换技能,改造成你自己的 AI 同事只需复制一个文件夹。
如果你正在寻找一款会主动找你的开源 AI 助手,OpenDuet 目前是这条路线上最完整的免费起点。

