ARTICLE · 1328689

OpenMausBot 教程:聊天 App 养 AI Agent 团队实战

发布时间：2026-11-08 01:29:23 最近访问：2026-11-08 01:29:23

早上九点，你的聊天列表里有三个人同时在等你：一个帮你盯着邮箱、一个在跑昨晚没写完的代码、一个刚把今天的会议纪要整理好。你回完这个回那个，切了三个应用，上下文还各管各的。

这就是 OpenMausBot 想改掉的那个别扭。它把 AI Agent 做成了一个聊天 App——Claude、Codex、Grok 全变成你通讯录里的联系人，一个窗口里各干各的活。我的判断先放前面：如果你手里已经有两个以上的编程 Agent 在用，它是目前最值得试的免费开源方案；但装之前先搞清一件事，它不卖你模型，账单还是你原来付给各家的那份。这个定位想明白了，后面才不会装错东西。

项目地址单独放这里：

milind-soni/OpenMausBot

仓库 2026 年 8 月 11 日建仓，到今天 11 月 7 日，星数 15,249，fork 2,136，Apache 2.0 开源。本周新增约 5,580 星，排在 GitHub Trending 周榜第 5。作者之前叫它 OpenGrokBot，也有人叫它 MausBot，跟 xAI、Meta、OpenAI、Manus 都没关系，README 里还专门写了一句：没有任何代币，任何打着 OpenMausBot 旗号的币都跟这个项目无关。

它不是聊天软件，是 AI 团队的通讯录

先把概念掰开。2026 年七周之内连出了五款闭源个人 Agent 产品：xAI 的 Grok Bot、Meta 的 Muse、OpenAI 的 dots、Manus 的 Cue，还有 Spear Street 的 Instinct。形态几乎一样：一个聊天 App，里面住着一个或一队 Agent。但它们的共同点也很一致：模型、电脑、你的数据，全在厂商那边。

OpenMausBot 照着同一个形态，用开源重做了一遍，差别就在“在哪跑、归谁管”：

闭源产品	形态	OpenMausBot 的不同
Grok Bot	一队 Bot 共用一台云电脑、只能用 Grok、要 SuperGrok 或 Cursor 套餐	同样的通讯录形态，每个 Bot 可用不同模型，跑在你自己的机器上，审批卡片由你说了算
Muse	单个个人 Agent，住在 Meta 的云虚拟机，只在美国和加拿大开放	一支队伍而不是一个人，数据存在你本地的 `~/.openmausbot`，在哪都能跑
dots	ChatGPT 里常驻的 Agent，只认 GPT，要 Pro 或 Business Premium 套餐	不绑套餐，用你已有的 Claude、ChatGPT 或 Grok 登录就行
Cue / Instinct	都要邀请码，Cue 给 Agent 配了自己的电话、邮箱和钱包，Instinct 让 Agent 在云电脑上替你保管密码	不用邀请，登录走 OAuth，密码不进云端

一句话总结它的架构：两个进程，一个本地小服务加一个聊天界面。聊天界面本身不直连任何模型，它把命令发给跑在 127.0.0.1:8799 的 harness 服务，服务再去驱动你电脑上已经装好的 claude、codex、grok 这三个 CLI。记录、密钥、事件都留在本机，不经过第三方的服务器。

装之前先算三笔账

这三笔账算清了，安装只要十分钟；算不清，装完第一天就会骂街。

第一笔：你得先有至少一个 Agent 的 CLI，而且已经登录。OpenMausBot 自己没有模型。装之前，先在终端里把你要用的 CLI 跑通，登录状态正常，它才能在模型选择器里把对应的模型亮出来。没装 CLI 的那一家，在选择器里是灰的，还会告诉你灰的原因。

第二笔：账单分两边。模型那边的钱照旧——Claude 的订阅、Codex 的额度、Grok 的套餐，该付多少还是多少，OpenMausBot 本身不收你一分钱。但有两个地方可能另外花钱：云电脑 Boat，试用期过后是付费服务；语音，ElevenLabs、Fish Audio 都要你自己的 key。这两个都是可选的，不填 key 也能正常聊天干活。

第三笔：平台有高下。macOS 最完整，Apple silicon 和 Intel 都有已签名公证的安装包。Windows 也有一键安装包，按用户装、不用管理员权限，但安装程序目前还没代码签名，SmartScreen 会弹“未知发布者”，要点“更多信息 → 仍要运行”。Ubuntu 24.04 是 beta，只正式支持 GNOME 桌面。还有一条硬限制：Ubuntu Wayland 下，Bot 不能操作本机，这是安全门没解决（跟踪 Issue #345），Xorg 下也要你明确 opt-in 才放行。

十分钟开局：从下载到第一个 Bot 回你消息

先下载。去 Releases 页按你的系统拿安装包：macOS 拖进 Applications 就能打开，Windows 双击安装，Ubuntu 用 APT 装 .deb，或者把 AppImage 加上可执行权限直接跑。想从源码跑也行：

git clone https://github.com/milind-soni/OpenMausBot && cd OpenMausBotpnpm installpnpm dev:serverpnpm devpnpm dev:desktop

源码路线要 Node 24+ 和 pnpm，三个命令分别起 harness 服务（127.0.0.1:8799）、聊天界面（127.0.0.1:5199）和 Electron 外壳。普通用户直接用安装包就行，harness 服务已经嵌在里面了，不用单独装。

再建第一个 Bot。点新建 Bot，给它起个名字、写一段性格描述、选一个模型。模型选择器是按提供方分栏的，Claude 和 Codex 的模型并排出现，哪个没登录就灰掉。模型不是一选定终身，对话中途也能换，同一个 Bot 今天用 Claude、明天切 Codex，记录还在。

然后建频道。工作、个人、每个项目各一个频道，不用把 Bot 复制来复制去。每个频道有自己的聊天记录、共享指令、工作目录、响应规则和 Bot 名单。频道就是上下文的边界：工作频道的 Bot 只知道工作的事，不会把你的私人安排也翻出来。

发第一条消息试试。你会看到回复是流式出来的，工具运行过程会折叠成小卡片，Bot 截的图也会直接贴进对话里。最关键的一幕马上会出现：Bot 要跑命令或者改文件时，聊天里会弹出审批卡片，Allow 或 Deny 由你点。这张卡片就是整个产品的权力结构——Bot 能动手，但动手之前得你点头。

三个真正拉开差距的用法

装完能聊天只是起点。下面这三个功能，才是它跟“套了个聊天壳的 Agent 启动器”的区别。

审批卡片，不是一层提示，而是一套权限经纪人。 Shell 命令、文件修改、Bot 反过来问你的问题，全部变成聊天里的内联卡片。云电脑和本机走同一套审批，不会因为换了台电脑就换一套规矩。习惯了之后你会发现，它解决的是多 Agent 时代最烦人的事：你不敢让 Agent 自己跑，又不想每一步都盯着。卡片就是中间态——Bot 先干能干的，卡住的地方等你一句话。

触发器：让 Bot 在你不在的时候也干活。直接在聊天里跟 Bot 说一句“每个工作日早上 9 点，给我发一份邮箱摘要”，它会在当场用 trigger 工具把这个定时任务建好，聊天里出现一张带编辑、暂停、撤销的实时卡片。定时可以是一次性的、按周几重复的，或者每 5 到 1,440 分钟跑一次。更进一步的是应用事件触发：“收到 Acme 的邮件就起草一封回复”。Gmail 每 15 分钟检查一次，Slack、GitHub 这类带推送的应用则是实时到。桌面版每天最多处理 500 个事件，付费 Cloud 是 2,000 个。Webhook 也接，接收器默认跑在 127.0.0.1:8800，但要记住一点：它得一直开着才能收到推送，目前还没有始终在线的托管中继，这是 README 里白纸黑字写着的短板。

一整支团队，一个 Markdown 文件装进来。这是它最被低估的功能。去 BotMRR 上挑一支现成的团队，点 Add to OpenMausBot，应用会先打开一个预览屏，让你看清楚要建哪些 Bot、首席幕僚、频道、playbook、连接清单和建议的例行程序，确认后才创建。你也可以直接导入一个 .md 文件，或者粘贴它的 GitHub 地址，格式是通用的：结构化的 YAML frontmatter 保证一键安装，普通 Markdown 部分人和其他模型也能照着读。反过来，分享一整个部门也只要一个文件：右键点部门选分享，Bot 的指令、头像、技能、群聊、例行程序、共享指令都会打进文件里，但聊天记录、密钥、密码、模型选择和电脑配置永远不进文件，疑似密钥的文本会被先清掉。对方导入之后，新 Bot 默认是 Ask 模式、技能关闭、例行程序暂停，连接要对方自己一个个批准。团队文件里不带任何凭证，这一点设计得很干净。

顺带提两个进阶入口。Jev 决策模型：在设置里填一个 TypeSafe Jev key 或者 OpenRouter key，设成 Auto 的房间会在几百毫秒内自动挑一个最合适的 Bot 来回你没点名的消息，决策模型关掉或者拿不准时，就回落到房间的负责人。语音：按喇叭能把回复读出来，或者直接打电话给 Bot，它一边干活一边用语音告诉你进度，顺带在语音里问你审批。语音提供方有 ElevenLabs、Fish Audio、Grok（xAI）、Mac 内置语音和本地 Chatterbox。还有给极客留的门：stdio MCP 服务器可以接 Claude Desktop 和 Cursor，命令行 openmausbot 能在脚本和 CI 里驱动整个团队，但 MCP 刻意不暴露审批授权、删除、凭证和电脑生命周期——这扇门开得很有分寸。

四个真实踩坑，都是 Issue 里正在发生的

好话说完，说点真实的坑。下面这几条不是我猜的，是 GitHub Issues 里用户正在撞的墙。

第一，Codex 订阅额度 100% 也会被拦。Issue #4507：有用户明明还有可用额度，Codex 却卡在 100% 订阅用量上不让继续跑，5 条讨论还没定论。双持 Claude 和 Codex 的人尤其要注意——Bot 报错的时候，先去看各家 CLI 自己的额度状态，别只盯着 OpenMausBot 的界面。

第二，Bot 之间传话没有确认步骤，误点会把本地 Bot 移到云端。Issue #4192：Bot 间通讯的提示框没有确认环节，手一滑点错，本地 Bot 就被挪到云端去了。团队里 Bot 越多，越容易误触。解决办法只有一个：点之前看清提示框里写的是哪台电脑。

第三，Windows 安装包没签名，SmartScreen 一定会拦你一次。这不是 bug，是现状。第一次安装看到“未知发布者”别慌，点“更多信息 → 仍要运行”就行，但心里要有数：一个还没签名的安装包，意味着你每次更新都可能再被拦一次。

第四，Wayland 用户别指望 Bot 帮你操作本机。Ubuntu Wayland 下本机控制是禁用的，安全门（Issue #345）还没解决；Xorg 下也要明确 opt-in。README 的原话是“Early but real”——早期，但是真的能跑。托管和移动端连接还在建设中，Webhook 目前还是本地接收器，电脑关了就收不到推送。