Rowboat 开源桌面 AI 同事实战指南知识图谱记忆、内置工作界面与本地优先架构【免费下载链接】rowboatOpen-source AI coworker, with memory项目地址: https://gitcode.com/GitHub_Trending/rowb/rowboatRowboat 是一款面向桌面的开源 AI 同事AI coworker——它把你的邮件、会议、Slack 与 AI 对话索引进一个「活的」知识图谱并利用这份长期记忆在你的机器上执行真实任务。本指南以官方文档 docs/readme/README.pt.md 为主线结合仓库源码系统讲解 Rowboat 的核心能力、安装配置、可选服务接入Google、语音、搜索、MCP 工具以及本地优先 自带模型的设计哲学读完即可上手部署并把它接入你的日常工作流。一、Rowboat 是什么把工作记忆变成可行动的桌面助手Rowboat 的核心定位是一句话一个拥有你工作记忆的桌面 AI 同事并内置了可对它采取行动的工作界面对应英文 README 中的描述 A desktop AI coworker with a memory of your work and built-in surfaces to act on it。它的工作方式与聊天机器人有本质区别索引而非检索Rowboat 将你的电子邮件、会议记录、Slack 消息和与助手的历史对话持续索引进一个活的知识图谱带反链的知识图谱图谱采用类似 Obsidian 的 backlink 风格关系是显式且可检查的而不是藏在模型内部的黑盒内置工作界面它不是一个孤立的对话框而是提供了邮件客户端、笔记、浏览器、代码模式、会议记录助手以及面向不同项目的工作区workspaces等一系列协作表面。二、功能总览八个内置工作界面官方文档用一张功能表逐项介绍了 Rowboat 的核心模块下面逐一展开1. 大脑Brain活的知识图谱Rowboat 把邮件、会议、Slack 和与助手的对话全部索引进一个活的、带 Obsidian 风格反链的知识图谱中。这意味着你在任意一条笔记里都能看到谁引用了它上下文是累积的而不是每次从头开始。2. 邮件Email重要邮件优先 自动起草内置邮件客户端会把邮件区分为重要与其他两类并针对重要邮件利用你全部的工作上下文自动起草回复而不是让你先解释背景。3. 后台代理Background agents事件驱动与定时执行你可以配置后台代理让它们由事件触发运行例如新邮件到达时按计划运行例如每天早上 8 点运行时可连接工具、搜索网络、使用浏览器甚至通过 Claude Code 或 Codex 编写代码。4. 内置浏览器Built-in Browser与 AI 协作上网Rowboat 内置了一个与主浏览器隔离的浏览器让你和助手可以在网页任务上协作。由于它是隔离的你只登录想让助手访问的那些账号从源头控制权限边界。5. 会议记录Meeting Notes本地实时转写与摘要一个完全本地运行的会议记录助手捕获麦克风与扬声器音频产出实时转写live transcript把会议总结写入 Markdown 文件并同步更新知识图谱。6. 代码模式Code Mode并行编程代理代码模式允许你用 Claude Code 或 Codex 并行启动多个编程代理并在需要的地方让 Rowboat 用全部工作上下文驱动它们。7. 应用Apps自建工作界面你可以在 Rowboat 内部构建自己的工作界面work surfaces它们拥有全部工具与集成的访问权限并且可以分享给其他人使用。仓库中对应的应用包管理、发布与注册逻辑位于 apps/x/packages/core/src/apps 目录。8. 集成Integrations一键接入热门产品Rowboat 为最流行的产品提供一键集成。三、安装与配置指南3.1 安装Rowboat 提供 Mac / Windows / Linux 的桌面版本直接下载最新版安装包即可。仓库根目录的 package.json 与 pnpm-workspace.yaml 表明它是一个 pnpm workspace 管理的 TypeScript 多包仓库桌面端代码位于 apps/xElectron 主进程、渲染层与各服务包服务端参考实现位于 apps/harbor。3.2 Google 服务配置Gmail / 日历 / Drive要连接 Google 服务Gmail、Calendar、Drive需要先在 Google Cloud Console 生成 OAuth 凭据Client ID 与 Client Secret。完整的分步图文教程见仓库根目录的 google-setup.md要点如下在 Google Cloud Console 新建项目例如命名为Rowboat Integration依次启用Gmail API、Google Calendar API、Google Drive API配置 OAuth 同意屏幕应用类型选External无需发布应用保持Testing模式即可在Test Users中添加你要用来连接 Rowboat 的邮箱创建OAuth Client ID应用类型必须选择Web application并添加授权回调地址http://localhost:8080/oauth/callback注意必须精确使用该地址——不带尾部斜杠、端口为 8080这与应用实际使用的 OAuth 回调完全一致复制生成的Client ID与Client Secret按 Rowboat 的提示粘贴进去。若出现Authorization Successful之后应用报错如 redirect URI 不匹配、ississuer 参数缺失优先检查三点应用日志中的完整报错、Google Cloud Console 中的回调地址是否精确匹配、以及应用类型是否为 Web application。3.3 统一格式所有 API 密钥文件Rowboat 的所有可选服务密钥都存放在用户目录~/.rowboat/config/下且全部使用同一种 JSON 格式{ apiKey: key }这一设计在源码中得到印证——例如 apps/x/packages/core/src/voice/voice.ts 中的readJsonConfig()统一从WorkDir/config/读取并解析 JSON读不到或解析失败时静默返回null对应功能自动降级为不可用。3.4 语音输入可选Deepgram在~/.rowboat/config/deepgram.json中填入 Deepgram API 密钥即可启用语音输入与语音笔记{ apiKey: 你的-Deepgram-密钥 }从源码实现看apps/x/packages/core/src/voice/voice.ts本地未登录 Rowboat 账号时音频会走 Deepgram 的预录音 REST 接口https://api.deepgram.com/v1/listen使用nova-3模型并开启smart_format、punctuate参数若已登录 Rowboat 账号则优先通过账号的 WebSocket 代理转发此时无需配置本地密钥。3.5 语音输出可选ElevenLabs在~/.rowboat/config/elevenlabs.json中填入 ElevenLabs API 密钥即可启用语音输出{ apiKey: 你的-ElevenLabs-密钥 }源码层面apps/x/packages/core/src/voice/voice.ts还支持可选的voiceId字段用于指定音色未指定时使用默认音色s3TPKV1kjDlVtZbl4KshTTS 请求默认使用eleven_flash_v2_5模型并带stability: 0.5、similarity_boost: 0.75的语音参数。语音合成同时支持一次性合成与流式合成synthesizeSpeechStream后者按块返回 MP3 字节实现边说边播的低延迟体验。3.6 网络搜索可选Exa在~/.rowboat/config/exa-search.json中填入 Exa API 密钥即可启用 Exa 深度搜索{ apiKey: 你的-Exa-密钥 }对应的内置工具实现位于 apps/x/packages/core/src/runtime/tools/domains/web.ts工具名web-search在未登录时读取exa-search.json中的apiKey直连https://api.exa.ai/search已登录时则改走 Rowboat 账号的代理接口。它的输入参数包含query搜索查询串numResults结果数量默认 5最大 20源码中用Math.min(Math.max(numResults || 5, 1), 20)强制钳制category搜索分类可选general / company / research paper / news / tweet / personal site / financial report / people日常查询应使用默认的general。搜索结果会返回标题、URL、发布日期、作者、高亮片段与正文摘要足以支撑深度研究类任务。3.7 外部工具可选MCP 服务器与 Composio要启用外部工具有两种方式添加任意 MCP 服务器使用 Composio 工具——在~/.rowboat/config/composio.json中填入 API 密钥{ apiKey: 你的-Composio-密钥 }Composio 客户端的配置加载逻辑见 apps/x/packages/core/src/composio/client.ts未登录时直连https://backend.composio.dev/api/v3并使用x-api-key请求头已登录时则通过 Rowboat 账号的/v1/composio代理使用 Bearer Token 认证。四、与同类工具的本质区别长期记忆 vs 按需检索这是官方文档反复强调的核心设计主张大多数 AI 工具在需要时按需重建上下文——每次去检索转写或文档。 而 Rowboat 维护的是长期存在的知识long-lived knowledge。两者的差异体现在四个方面上下文随时间累积不是每次会话都从零开始关系显式可检查知识图谱中的关联肉眼可见、可追溯笔记可被编辑记忆以 Markdown 笔记的形式存在你可以直接修改而不是藏在模型权重里一切都在本地全部内容以纯 Markdown 存放在你自己的机器上。结论就是官方文档的那句话结果是复利式的记忆积累而不是每次冷启动的检索。五、自带模型Bring Your Own ModelRowboat 不绑定任何特定模型厂商支持你偏好的任何模型配置本地模型通过 Ollama 或 LM Studio 运行托管模型自带 API 密钥/供应商随时换模型数据始终留在本地 Markdown 库vault中切换模型不影响你的记忆资产。六、通过 MCP 扩展工具生态Rowboat 通过Model Context ProtocolMCP连接外部工具与服务。这意味着你可以接入搜索、数据库、CRM、客服工具、自动化系统——甚至是你自己公司内部的工具。官方文档给出的示例包括Exa网络搜索、Twitter/X、ElevenLabs语音、Slack、Linear/Jira、GitHub 等。6.1 MCP 服务器配置的源码实现从源码看MCP 服务器清单保存在~/.rowboat/config/mcp.json中apps/x/packages/core/src/mcp/repo.ts其顶层结构为{ mcpServers: { 服务器名: { url: ... } } }McpServerDefinition支持两种形态见 apps/x/packages/shared/src/mcp.tsHTTP 型{ url: ... }通过 SDK 的StreamableHTTPClientTransport或 SSE transport连接Stdio 型{ command: ..., args: [...] }通过StdioClientTransport拉起本地进程。getClient()会对配置做缓存键比对一旦mcp.json发生变化如 token 轮换、条目增删旧客户端会被关闭并重建连接apps/x/packages/core/src/mcp/mcp.ts。6.2 实战示例并行网络搜索官方文档提供了一个可以直接落地的 MCP 配置示例接入 Parallel Search MCP 提供的web_search与web_fetch工具用于公开网页搜索与页面抓取。操作路径是Settings → MCP Servers在你的既有mcpServers对象中新增parallel条目保留其他条目然后点击Save{ mcpServers: { parallel: { url: https://search.parallel.ai/mcp } } }如果此前没有配置过任何服务器则直接使用上面的完整结构。配置完成后让 Rowboat 列出parallel服务器上的工具尝试指令Use Parallel to find the official MCP documentation.Rowboat 即可在工作过程中按你的 MCP 工具权限调用这些工具。要移除它只需在Settings → MCP Servers中删除parallel条目并保存。该配置不会影响 Exa 等其他已配置的供应商。七、本地优先Local-first设计原则最后官方文档总结了 Rowboat 的本地优先设计信条这也是它与其他云端 AI 产品最根本的分野所有数据以纯 Markdown 存储在本地——无专有格式、无托管锁定no proprietary formats or hosted lock-in你随时可以检查、编辑、备份或删除一切——数据主权完全在你手中知识图谱中的笔记可直接编辑形成人对机器记忆的直接控制。结合 README.md 可看到多语言文档简体中文、日本語、한국어、Español、Français、Português均完整保留了上述所有章节说明这些能力是项目的稳定主线而非宣传话术。八、快速上手清单下载安装 RowboatMac / Windows / Linux按 google-setup.md 接入 Gmail / Calendar / Drive注意回调地址必须为http://localhost:8080/oauth/callback按需在~/.rowboat/config/下添加deepgram.json语音输入、elevenlabs.json语音输出、exa-search.json网络搜索、composio.json外部工具统一格式为{ apiKey: key }在 Settings → MCP Servers 中按{ mcpServers: { ... } }结构接入任意 MCP 服务器HTTP 或 Stdio 均可配置模型Ollama / LM Studio 本地模型或自带密钥的托管模型从内置邮件客户端或知识图谱开始让 Rowboat 用你的上下文替你起草、搜索、编码与总结。【免费下载链接】rowboatOpen-source AI coworker, with memory项目地址: https://gitcode.com/GitHub_Trending/rowb/rowboat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考