OpenDuet全景解析:什么是主动式AI Agent?开源免费、会主动找你的AI助手完整指南

原创2026-10-30 09:34:05353 阅读

OpenDuet全景解析:什么是主动式AI Agent?开源免费、会主动找你的AI助手完整指南

OpenDuet 是一个开源免费的主动式 AI Agent(proactive AI agent)模板,由 CopilotKit 团队基于 OpenBot 平台打造。与"你问它才答"的传统聊天机器人不同,OpenDuet 会主动找你:每天早晨推送简报、自动分拣邮件和日程里"需要你"与"可以等"的事项,在你离开时继续在自己的电脑上干活,并在执行敏感操作前停下来等你批准。

OpenDuet 开源主动式AI Agent 横幅:晨间简报卡片与"允许一次/始终允许/拒绝"审批按钮

一、什么是主动式 AI Agent?先搞懂这个核心概念

传统 AI 助手是被动式的:你提问,它回答。而主动式 AI Agent 的工作方式更像一位真正的同事——

  • 📬 主动打招呼:它先读你的邮件和日历,然后主动告诉你"你是谁、我能怎么帮你",并邀请你纠正它;
  • ⏰ 自己安排时间:基于定时任务(Routines)按计划运行,而不是等你下达指令;
  • 🔍 主动汇报:发现需要你处理的事,主动发消息给你;不需要你的,先压后处理。

OpenDuet 正是这一路线的开源实现,也是 CopilotKit 对 Claude Duet 这类"主动式助理"品类的免费开放方案,采用 MIT 协议(见 LICENSE)。

二、OpenDuet 能帮你做什么?核心功能一览

OpenDuet 开源AI助手手机端截图:晨间简报聊天、任务面板、Make 生成页与侧边频道列表

以下是当前版本即可用的能力(源自 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
  1. 选择 Intelligence 项目:npx --yes copilotkit@latest login 后执行 project select,再运行 setup-learning.ts 完成密钥配置;
  2. 填模型密钥:默认使用 OpenAI 的 gpt-5.6-terra(见 model.yaml),在 .env 中填入 OPENAI_API_KEY,也可换成 Anthropic 等其他供应商;
  3. 一键启动:bash scripts/start.sh,脚本会拉起 Postgres 与各个 Bot 容器、执行数据库迁移,再启动 API、定时 worker 和应用(见 start.sh);
  4. 打开浏览器:访问 http://localhost:3010,按 Setup 清单连接 Gmail 与 Calendar 即可;
  5. 停止服务: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 用三层机制兜底:

  1. 审批优先:改变世界的动作(发消息、付款、删除)会暂停并展示确切内容与触发规则,你只需三选一:Allow once / Always allow / Refuse;
  2. 凭证隔离:密码通过专用遮罩通道直连网站,聊天记录只记录"请求过密码";存储的凭证加密且只写不读,API 永远不返回明文;
  3. 保守假设:无法被明确判定为"只读"的工具调用,一律按"写操作"对待;出站消息自动脱敏。

这些边界的设计细节可阅读官方架构文档 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 目前是这条路线上最完整的免费起点。

登录后查看全文
OpenDuet