OpenMausBot：Grok Bot 替代，把 Claude/Codex/Grok 变成你本机的一队 AI 同事最新版

一、项目概览

milind-soni/OpenMausBot（也叫 MausBot，前身 OpenGrokBot）是一个开源的”Grok Bot 替代品”：它把 AI 做成一个”即时通讯 App”——左侧是一排机器人（bot），每个 bot 背后是跑在你本机上的 Claude / Codex / Grok CLI，有自己的性格、模型、记忆、专属”电脑”和已连接的应用。你像加联系人一样加 bot、像聊天一样派活、看它干活、在关键动作上点”允许/拒绝”。定位上，它是 Meta Muse、OpenAI dots、Manus Cue、Instinct 这些闭源个人 Agent 产品的开源替代，Apache-2.0，本地优先。

截至 2026 年 11 月 1 日的真实数据：

• Stars：9,833 / Forks：1,367 / Open Issues：616
• 创建时间：2026-08-11，最后推送 2026-11-01（约 3 个月冲到近万 Star，仍在日更）
• 许可证：Apache-2.0（明确声明与 xAI / Meta / OpenAI / Manus 无关、未获背书）
• 语言：TypeScript（约 44 MB）为主，含 JS / MDX / CSS / Dockerfile / Swift / Python 等
• 版本：v0.1.136（高频发布，已签名/公证的 macOS · Windows · Ubuntu 桌面安装包）
• 主页：openmausbot.com；可 npm install -g openmausbot 或 npx openmausbot 跑
• 话题标签：ai-agents、claude-code、codex、computer-use、docker、electron、expo、grok、self-hosted、typescript

一个值得先说的细节：项目在 README 顶部用醒目警告声明“与任何加密货币无关、没有发币”，市面上任何挂 OpenMausBot / Maus / SupaMaus 名的币都和它无关。这种主动切割在当下 AI 项目里不多见，算加分项。

二、它在解决什么：一个助手不够用

作者的核心判断是”一个盒子里一个助手不是 Agent 该有的形状”。2026 年 7 周之内扎堆出了四个闭源个人 Agent 产品（Grok Bot、Meta Muse、OpenAI dots、Manus Cue），共同点都是”模型、电脑、你的数据都留在厂商那一侧”。OpenMausBot 把这种”聊天 App 里养一队 Agent”的形态用开源重建了一遍：每个 bot 用自己的模型、自己的电脑、自己连的应用，跑在你自己的机器上。

三、能做什么：把”AI 同事”当成联系人来管

• 自带 Agent（BYO）：bot 跑在你本机装好的 claude / codex / grok CLI 上——用你已有的登录和订阅，不新开账号、中间没有代理。在 设置 → Engines 里还能把任意引擎指向一个自定义 CLI 二进制（带版本号的构建或包装脚本）。
• 本地优先：一个跑在 127.0.0.1 的小 harness 服务拥有所有 Agent 进程；对话记录、密钥、事件都存在 ~/.openmausbot，不上云。
• 每个 bot 都有”手”：可以给每个 bot 配一台云端 Linux 桌面（Boat / boat.dev）、一个隔离的本地 VM，或在平台安全边界认证通过的条件下控制你自己的电脑（用 Cua Driver）；外加通过 Composio 接 500+ 应用。宿主控制目前仅 macOS 和 Ubuntu Xorg 在显式 opt-in 后开放，Ubuntu Wayland 在修 #345 前保持关闭。
• 每个 bot 单独挑大脑：模型选择器带服务商栏，Claude 和 Codex 模型并排、标注默认、不可用的置灰并说明原因；对话中途也能换模型。
• 每个 bot 都有一台电脑：打开 Computer 面板，bot 的云端桌面就起好——干活时有实时屏幕预览，”Open desktop”可在浏览器接管，或把 bot 指向”这台 Mac”。
• 动手前先问你：shell 命令、文件编辑、提问都以内联卡片浮现——允许/拒绝/在聊天里回答。一个权限代理（permission broker）把每个危险动作变成由你拍板的决定，云端和本地电脑都适用。
• 已连接应用市场：基于 Composio Sessions 的一键市场：Gmail、Slack、GitHub、Notion、Linear 等数百个，OAuth 一次，所有 bot 都能当工具用。
• 像管聊天一样管 bot：右键任意 bot：置顶、标记未读、编辑资料、复制、隐藏、删除——它就是个通讯录里的人。
• 密钥一次填好：在 App 设置里贴凭据，本地持久化、提供商热重载；密钥是 write-only，UI 只看到”已配置”标记。
• 按场景分频道（Channels）：Work / Personal / 各项目分开放，互不克隆 bot；每个频道有独立对话、共享指令、工作目录、响应规则和可编辑的 bot 名单。
• 用 Jev 做快决策：在 设置 → Decision model 加 TypeSafe Jev key（或 OpenRouter key+模型），房间设为 Auto 时，几百毫秒内挑出最合适的人来接没点名的话，决策模型关掉或拿不准时回退到房间主理人。
• 一个 Markdown 装下一整队：在 BotMRR 逛”成果导向团队”，点”加进 OpenMausBot”，先弹审查页再创建 bot / 参谋长 / 频道 / 剧本 / 连接器清单 / 建议例行；也能从磁盘导入或在 Teams → Import 贴 GitHub 链接。格式可移植：YAML frontmatter 供一键安装，普通 Markdown 剧本人和 Grok/Claude/ChatGPT 都能读。连接默认关，例行默认暂停，包里不带任何凭据/对话/权限/记忆/电脑权限。
• 分享整个部门：支持组织/团队共享（org-library、team-sharing 等文档）。

四、技术架构：两个进程，App 不持传输层

OpenMausBot 的结构很克制：App 自己不持有任何传输层，只通过 HTTP 发类型化命令，并把一条 SSE 事件流折叠成状态；harness 服务拥有所有 Agent 进程，把各家原生协议归一化成一条统一的运行时事件流（按线程以 NDJSON 记录）。

• App（React + Tailwind，端口 5199）：聊天 UI、模型选择器、电脑面板。
• Harness 服务（127.0.0.1:8799）：Driver registry（驱动注册表）→ Event bus → SSE，外加 Permission broker（权限代理）。
• 你电脑上的 Agent：claude CLI / codex CLI / grok CLI，各自把权限请求发给 broker。
• 向外：harness 经 Boat API 连云端电脑（boat.dev），经 Composio Session 连 Gmail/Slack/GitHub 等。

技术栈一览：Claude·Codex·Grok（本机 CLI 背后的 Agent）、Electron（macOS/Windows/Ubuntu 桌面壳）、React + Vite + Tailwind（UI）、Boat（每个 bot 的云端电脑，也是赞助商）、Composio（已连接应用）、Cua Driver（本机原生 computer use）、ElevenLabs·Fish Audio（语音）、GitHub Sponsors（支持）。文档极其完整——agents-tool-bridge、approval-levels、custom-engines、custom-mcp-servers、decision-model、computer-use-integration、self-hosting、headless-cli、ios-companion、voice-mode 等几十篇。

五、怎么装（桌面或终端）

• 桌面安装包：GitHub Releases 直接下 macOS（Apple silicon / Intel，已签名公证 .dmg）、Windows（x64 安装包）、Ubuntu 24.04（.deb 或 AppImage beta）。
• 终端/服务器：Node 24+，npm install -g openmausbot 然后 openmausbot；或 npx openmausbot 不全局安装。首次启动用方向键引导：选 AI 接入、登录或贴隐藏 Key、选模型、可选连手机。Ctrl-C 只停服务不停已存工作；--no-open 跳过开浏览器。
• 手机访问（可选，默认跳过）：选一个明确批准的托管公网 HTTPS 端点（带配对保护）、已有的 Tailscale，或自建 HTTPS 反代；原生 App 从此流程配对（安卓是 app link、iOS 两者皆可）；也可把 Web UI 从 Safari/Chrome 装成手机独立 App。

六、诚实的边界与权衡

• “本地优先”但有外部依赖：真正的多 Agent 编排和数据确实在本地（~/.openmausbot）；但”每个 bot 一台电脑”的云端桌面走的是赞助商 Boat，”连接 500+ 应用”走的是 Composio——这两块是第三方服务，不是纯本地。想要完全离线，得只用本机电脑控制、不接 Composio。
• 本机控制仍受限：让 bot 直接操作你自己的电脑是 opt-in，且仅 macOS 和 Ubuntu Xorg 开放；Ubuntu Wayland 在 #345 修好前关闭——跨平台”控制本机”还早。
• 616 个未结 Issue：对一个 3 个月、近万 Star 的高速项目来说是常态，但也意味着踩坑概率不低，装完建议先逛逛 issues 和 openmausbot-teams 的 FORMAT 说明。
• v0.1.x 仍是早期版本号：高频发布、API/行为可能变动，不适合当关键生产依赖。
• 安全模型靠”审批卡片”：权限代理把危险动作变成你拍板，这点很强；但任何”让 AI 操作电脑/连应用”的工具，本质上都把不小的能力交出去了，OAuth 授权范围请按需收敛。

七、结论：想把”AI 同事”养在本地，目前开源里最像样的那个

OpenMausBot 是近期”个人 Agent”赛道里完成度最高、文档最全的开源选手之一：它没重新发明 Agent 内核，而是把你已经有的 Claude/Codex/Grok CLI 包成一个”带审批、带电脑、带应用市场、带团队剧本”的通讯录式工作台，并把编排和数据留在本地。对比闭源的 Grok Bot / Muse / dots / Cue，它的差异化很实在——任意模型、本机优先、审批卡片、无套餐绑架、还能一键导入”成果导向团队”。

它的代价也很清楚：想用满”云端电脑 + 500 应用”就要接 Boat 和 Composio 两个第三方；本机控制跨平台还早；v0.1.x 早期、issue 多。但就”想在自己机器上养一队可管、可控、可分享的 AI 同事”这个目标而言，它目前是开源里最值得装来试试的一个。建议新手从桌面安装包起步，先只用本机 CLI 和审批卡片跑顺，再按需开 Boat 云端电脑和 Composio 应用。