Rowboat 全栈深潜：把邮件、会议、知识图谱、后台代理装进电脑的开源 AI 同事

📝

Rowboat 是开源 AI 同事（Electron 桌面端）：把 Gmail、日历、会议、Slack 沉淀为本地 Obsidian 兼容 Markdown 知识图谱，用 Live Note、后台代理、Code Mode（ACP 接入 Claude Code/Codex）让工作上下文越用越厚。核心是「不是更多 Agent，而是记忆、工具与工作界面落到可检查的文件与事件日志」。

原文：微信公众号《Rowboat 全栈深潜：把邮件、会议、知识图谱、后台代理与代码模式装进电脑，打造真正会积累的开源 AI 同事》（作者：小K）
开源地址：https://github.com/rowboatlabs/rowboat

Rowboat 不是给聊天框再套外壳，而是把邮件、会议、笔记和代码沉淀为本地 Markdown 知识图谱，再让代理据此行动。它追求的不是”回答一次”，而是让工作上下文越用越厚。本文基于 2026 年 7 月 24 日的仓库源码与官网现行版本。

一、核心能力全景

Brain（大脑）

把 Gmail、日历、会议记录、Slack、助手对话和语音备忘录整理为 Obsidian 兼容的 Markdown。人、组织、项目、主题成为带 [[双链]] 的节点，可用关系图、列表与文件树浏览，也可直接改正文和 YAML 元数据。每次整理写入本地 Git 历史，单篇笔记最多展示 50 个变更版本并可恢复。

邮箱

不只做收件箱：把邮件分为 Important 与其他邮件，为重要线程自动起草回复，并利用笔记、会议和历史线程补齐上下文；会从用户的修改与发送动作中调整后续草稿。

会议

在本机采集麦克风和扬声器（不让机器人加入会议）；提供实时转录、会后 Markdown 摘要、行动项和知识图谱更新。日历可触发会前简报；语音备忘录也进入同一记忆流水线。

Live Note

把一篇普通笔记变成持续更新的成果物。一篇笔记只有一个 live: 目标，但可同时配置 cron、每日时间窗口、Gmail/Calendar 事件匹配，也可手动运行。代理只负责 H1 以下正文，前端不直接写 live:，避免定时器、用户编辑与代理互相覆盖。

Background agents

适合跨文件、跨工具的持续工作：定时生成晨报、事件到达后起草邮件、发 Slack、维护项目周报，甚至启动代码任务。能维护 index.md/HTML 仪表盘，也能执行动作并写 Journal；失败保留”上一次成功结果”，5 分钟退避，避免重试风暴。

Code Mode

通过 ACP 接入 Claude Code 或 Codex。聊天内的代码任务保持会话上下文；后台代码任务在独立 Git worktree/分支中运行，可并行启动，最终给人审查 diff，而不是直接污染当前检出目录。

内置浏览器 + Apps

内置浏览器：与日常浏览器隔离，可只登录愿意交给代理的账户；助手能读页面、点击、输入和导航
Apps：把工作流做成真正的本地小应用——静态前端、数据文件、可选后台代理、能力清单和受限 Host API。分发包是带清单、前端产物、代理定义和默认数据的 .rowboat-app

此外还有语音、视频、屏幕协作和 Practice 教练模式；WhatsApp 与 Telegram 可把手机消息接到本地会话。工具层覆盖文件、文档解析、Shell、Web、MCP、Composio、通知和子代理。

二、安装与配置

截至 2026 年 7 月 26 日，官网最新版本 v0.8.0（macOS Intel/Apple Silicon DMG、Windows x64 EXE、Linux x64 DEB/RPM）。

模型：可登录 Rowboat/ChatGPT，也可接 OpenAI、Anthropic、Gemini、OpenRouter、Vercel AI Gateway、Ollama 或 OpenAI-Compatible 端点。后台代理、子代理、知识图谱、会议摘要、Live Note、权限判断和标题均可单独指定模型。本地模型应支持工具调用和约 16K 上下文
接 Google：启用 Gmail、Calendar、Drive API，OAuth 客户端类型选 Web application，回调地址必须精确填写 http://localhost:8080/oauth/callback，测试状态把自己的邮箱加入 Test Users
可选能力：~/.rowboat/config/ 下的 JSON（deepgram.json 语音输入、elevenlabs.json 语音输出、brave-search.json、exa-search.json、composio.json）；MCP Server 可在应用内新增并校验

⚠️ 源码构建注意：从源码运行当前桌面版应进入 apps/x（pnpm install → npm run deps → npm run dev）。仓库根目录的 ./start.sh、Docker Compose、apps/rowboat、Python SDK 属于早期”可视化多智能体 Studio”路线——不要照旧教程启动 MongoDB/Qdrant 版。

三、最高效的使用顺序

先把模型分工做好：交互聊天用强模型；分类、标题等轻任务用便宜模型；本地模型资源紧张时延后后台任务
再接入 Gmail/Calendar/会议来源：默认首次 Gmail 回填上限 500 封。先让同步与建图完成，再检查 People/Organizations/Projects/Topics 是否准确；不要一上来就堆自动化
校正记忆，而非反复改提示词：身份、关系、项目状态直接写回 Markdown。系统用 mtime 快速筛选，再以 SHA-256 确认内容变化；每次只让建图代理处理一个源文件，减少不同邮件之间的实体串线
按任务形态选入口：一次性问答用 Chat；同一篇笔记持续更新用 Live Note；跨工具/定时/事件动作用 Background agent；需要固定交互界面用 App；实现代码用 Code Mode
目标写成可验收结果：”每天 7 点汇总过去 24 小时与 AI Agent 有关的 3—5 条高价值信息，附来源，覆盖 index.md” 远好于”每天看新闻”
先手动 Run 一次：确认数据源、格式、工具授权和副作用，再打开 cron 或事件触发。修改既有任务时扩展原任务，避免制造重复代理

四、技术架构：”长期工作”

四层 Electron 结构

层	职责
Electron Main	文件、OAuth、系统权限、会议采集、浏览器、定时器、应用服务
Preload	只暴露经过 Zod 校验的类型化 IPC
React 19 Renderer	界面
@x/core + @x/shared	业务逻辑 / 消息、工具、会话和配置 Schema（Awilix 依赖注入）

默认工作目录 ~/.rowboat（可用 ROWBOAT_WORKDIR 改）：记忆在 knowledge/、配置在 config/、自动化在 bg-tasks/、会话与代理回合在 storage/。

知识图谱流水线

同步 → 分类 → 增量检测 → 实体抽取/合并 → 建双链 → Git 提交。邮件先被打上 knowledge: extract|skip，纯入站、群发和自动邮件受到严格门控（避免每个推销者都变成人物节点）。每日”园艺”任务压缩 60 天前活动为月度摘要，把重复模式提升为事实，完成或休眠陈旧行动项，修复正文与 frontmatter 漂移。

代理运行时：每个 turn 一个只追加 JSONL 日志

代理运行时不是一坨内存状态，而是每个 turn 一个只追加 JSONL 日志。模型请求、权限请求、工具调用、进度、结果、失败和取消都成为事件；Reducer 从头重放得到唯一状态。系统先把”准备执行副作用”的意图落盘，再调用外部工具；崩溃后不会盲目重放结果未知的同步副作用，而是给模型一个”结果不确定、未重试”的工具结果。会话只保存 turn 引用，历史上下文逐 turn 链接，旧工具大结果和视频帧在发送模型前可做确定性裁剪。

分层权限

文件越界、Shell 非白名单命令、MCP/Composio 执行会进入确定性检查或人工确认；低风险调用可交给专门模型判断，策略默认失败关闭。App 的能力必须写进 manifest，外部 Fetch 代理会拦截 localhost、私网、链路本地地址，并逐跳检查重定向，减少 SSRF 风险。

五、必须知道的边界

“本地优先” ≠ “绝不联网”：Markdown 记忆确实在本机，但选择云模型、Composio、Google、搜索、语音服务或 Rowboat 订阅时，相关请求会进入对应服务
桌面端包含 PostHog 使用量事件；源码构建未配置 PostHog Key 会静默关闭
通话按帧采样而非连续视频，不能看见帧间动作；没有语音抢话；屏幕共享固定主显示器
定时任务依赖桌面端运行：cron 错过超过 2 分钟不会补跑，时间窗口会在窗口内启动后补上

Rowboat 的核心不是”更多 Agent”，而是让记忆、工具和工作界面落到可检查的文件与事件日志里。 先把知识图谱养准，再逐步增加 Live Note、后台代理、App 与 Code Mode，收益会比一次开十个自动化更稳定。

💻 补充：GitHub 数据验证

项目	rowboatlabs / rowboat
Stars	16,954
语言	TypeScript
License	Apache-2.0
创建	2025-01-13
定位	Open-source AI coworker, with memory
状态	未归档，活跃开发

项目：https://github.com/rowboatlabs/rowboat