
OpenDuet 是一款开源的主动式智能体(Active Agent)平台,通过本地自托管的方式协助用户处理日常工作。该项目目前作为 CopilotKit 开源智能体平台 OpenBot 的租户配置运行,用户可通过修改特定的配置文件,将其定制为具备独立名称、专属智能体(Bots)和技能的工作助手。

核心工作机制:主动执行与行动前审批
与传统被动等待指令的聊天机器人不同,OpenDuet 采用主动式工作流。它在用户离开时,会在其专属的虚拟“电脑”环境中继续处理任务,并在需要决策时主动汇报。
- 独立执行环境:每个智能体拥有独立的浏览器、文件系统(
/workspace)和 Shell 环境。它可以在后台运行真实浏览器操作、处理文件,且仅能访问用户明确授予的工具权限。 - 行动前审批机制:在执行发送消息、支付、签署文件或删除数据等修改性操作前,智能体会暂停并展示确切的操作细节。用户可选择“允许一次”、“始终允许”或“拒绝”。
- 严格的隐私边界:当网站需要登录时,用户通过掩码秘密框输入密码。密码直接发送至目标网站,绝不会进入智能体可读取的对话记录中。此外,所有外发消息均会经过敏感信息检查,防止卡号或健康数据意外泄露。

关键功能模块
OpenDuet 将复杂的工作流拆解为可管理的模块,帮助用户聚焦核心决策。
- 早晨简报与任务分类:每天首次打开应用时,系统会生成一份简报,汇总当日日程、环境变化及需要决策的事项。它会扫描 Gmail、日历和 Slack,将任务严格分类为“需要你处理”和“可以等待”,并为每项分类提供简要原因。
- 技能与计划任务:支持通过
/符号调用可重用的自定义指令(Skills)。同时,用户可设置例程(Routines),让智能体按照预定时间表自动执行特定任务。 - 公共网络研究:在管理员授权后,智能体可使用 Parallel、Exa 或 Firecrawl 等工具搜索公共网络来源、阅读指定页面,并生成带有来源链接的结构化简报,而无需占用其本地浏览器资源。
- 多渠道交互:支持在网页端、移动端、Slack 或 Microsoft Teams 中使用。界面提供频道管理、一键点击回复、语音输入(需配置转录提供商)以及跟随系统的浅色/深色模式。
部署环境与架构配置
OpenDuet 强调数据主权,所有组件均可自行托管。部署过程需要 Docker、Bun 1.3 或更高版本、Node.js,以及一个免费的 CopilotKit Intelligence 项目(用于保存线程和记忆,无此密钥服务器无法启动)。
基础部署步骤:
- 克隆仓库并安装依赖:
git clone后执行bun install。 - 配置 Intelligence 项目:使用
npx copilotkit@latest login和project select,脚本会自动将密钥写入.env并配置学习容器。 - 配置模型密钥:默认使用 OpenAI,也可通过设置
BOT_PROVIDER=anthropic及对应的 API 密钥切换至 Anthropic 等其他兼容提供商。 - 启动服务:运行
bash scripts/start.sh。该脚本会在 Docker 中启动 PostgreSQL、智能体电脑容器、API 服务器及例程工作器。
多实例与资源隔离:
若需在单机运行多个实例,需为每个实例分配独立的 COMPOSE_PROJECT_NAME、COMPUTER_NAMESPACE、镜像标签及端口,并修改对应的数据库和 API 连接地址。若选择共享智能体电脑模式,需将 OPENBOT_ONE_COMPUTER_EACH 设为 false 并统一配置 COMPUTER_TOKEN。
生态集成与深度定制
OpenDuet 的设计初衷是易于复制和修改。所有定义 OpenDuet 特性的配置均集中在 openbot/examples/openduet 目录下。
- 租户包定制:用户可通过修改
brand.yaml(产品名称)、agents.yaml(智能体指令与技能)、channels.yaml(对话频道)、model.yaml(模型提供商)和skills.yaml(自定义指令),快速构建专属助手,而无需改动底层 OpenBot 代码。 - Gmail 与日历集成:需配置 Google OAuth 客户端。为便于本地测试,项目内置了“假 Google”服务(Fake Google),可通过运行
bun openbot/scripts/fake-google/server.ts启动,模拟虚构的收件箱和日历,无需真实的 Google 账户即可完成连接器测试。 - 受治理的 MCP 连接:支持与 Google Drive 和 Notion 等应用通过模型上下文协议(MCP)进行安全连接,确保数据访问受控。
相关导航


AgentKit

Isotopes AI

Agentic Data Scientist

Oh My OpenAgent

Star Office UI

DeepSeek Cowork






