milind-soni/OpenMausBot · 上手攻略

• 仓库：milind-soni/OpenMausBot
• 链接：https://github.com/milind-soni/OpenMausBot
• 分类：agent-runtime · desktop-automation · composable-agents
• 作者：Tom
• 更新：2026-08-18

这是什么

OpenMausBot 是 macOS / Windows 桌面应用，将 Claude、Codex、Grok 等本地 CLI 工具封装为一个多机器人消息应用。每个机器人是一个真实运行的 AI Agent，有自己的性格、模型、记忆和可连接的 500+ 第三方应用（通过 Composio）。本质上它是 Grok Bot 的开源实现，核心思路是：把 AI Agent 当通讯录里的联系人来对话。

解决什么问题

市面上的 AI Agent 通常是单一助手或网页界面。OpenMausBot 解决以下痛点：

• 多 Agent 协作：在一个界面里同时运行多个机器人，分别扮演不同角色，各用各的模型，互不干扰
• 本地优先：所有密钥、对话记录存本地（~/.openmausbot），不依赖云端中转
• 自带权限审批：每个危险操作（Shell 命令、文件修改、App 授权）都会弹出审批卡片，不会静默执行
• 自带云端电脑：机器人可以连接 Box 云 Linux 桌面（box.ascii.dev），在浏览器里实时观看机器人操作桌面
• 自带语音：接入 ElevenLabs API，让机器人说话或接听语音（macOS 原生）

快速安装

官方打包版本（推荐）

macOS（Apple Silicon）

# 下载 DMG
https://github.com/milind-soni/openmausbot-releases/releases/latest/download/OpenMausBot.dmg
# 拖入 Applications → 打开即可，已签名并经过公证

Windows（x64）

# 下载安装包
https://github.com/milind-soni/openmausbot-releases/releases/latest/download/OpenMausBot-setup.exe
# 运行即可，无需管理员权限
# 注：尚未代码签名，SmartScreen 会提示"未知发布者"，点"更多信息 → 仍要运行"

从源码构建

前置条件：macOS / Windows / Ubuntu 24.04 x64 + Node ≥ 24 + pnpm + 至少一个 Agent CLI（Claude / Codex / Grok）已登录

git clone https://github.com/milind-soni/OpenMausBot && cd OpenMausBot
pnpm install

开发模式运行（两个终端）：

# 终端 1：启动 harness 服务器（127.0.0.1:8799）
pnpm dev:server

# 终端 2：启动应用（127.0.0.1:5199）
pnpm dev

# 或在 Electron 桌面壳中运行（需同时跑上面两个命令）
pnpm dev:desktop

打包桌面应用：

pnpm package:mac   # macOS: DMG + ZIP（需要 Swift/Xcode）
pnpm package:win   # Windows: installer + ZIP
pnpm package:linux # Ubuntu x64: .deb + AppImage

可选凭证配置

核心用法

1. 添加并配置机器人

1. 安装后打开 App，Claude / Codex / Grok CLI 会自动出现在模型选择器中（前提是本机已安装并登录）
2. 点击侧边栏添加机器人，选择引擎和默认模型
3. 右键机器人可：固定、标记未读、编辑资料、复制对话 ID、隐藏、删除

2. 对话与审批

机器人发起的操作会以内联卡片形式呈现于对话中： - Allow（允许）/ Deny（拒绝）/ 直接在聊天框回复 - 覆盖本地和云端所有电脑的权限

3. 机器人控制云端桌面

# 在 App 中打开 Computer 面板
# 机器人自动在 Box（box.ascii.dev）上分配一个云 Linux 桌面
# 实时预览机器人屏幕 → 点击 "Open desktop" 在浏览器直接接管

4. Composio 工具连接

# 在 App Settings 中粘贴 Composio 项目密钥
# 打开 Marketplace，点击连接（OAuth 一次）
# 连接后所有已配置的机器人都可调用这些 App 作为工具

5. 语音模式

# 在 App Settings 中粘贴 ElevenLabs 密钥
# 点击任意回复旁边的喇叭图标 → 机器人回复语音播报
# 点击通话按钮 → 语音对话（仅 macOS，依赖本地 on-device 语音识别）

6. Webhook 触发机器人任务

OpenMausBot 在 127.0.0.1:8800 启动一个 webhook 接收器：

# 设置环境变量（如需要自定义端口）
export OMB_WEBHOOK_PORT=8800

# 创建 webhook 触发器后，外部系统可 POST 到：
# http://127.0.0.1:8800/hooks/<secret>
# Bearer 认证推荐（密钥放在 Header 而非 URL）

7. 命令行工具检查

pnpm typecheck   # 检查 app + server 类型
pnpm test        # 单元测试、driver 测试、API 测试
pnpm build       # 生产构建

典型适用场景

1. 多角色 Agent 协作：同时运行 Codex（写代码）、Claude（产品分析）、Grok（实时搜索）三个机器人，各自完成不同任务
2. AI 辅助办公流：机器人连接 Gmail / Slack / GitHub / Notion，自动处理邮件、安排会议、提交 PR
3. 无代码云端操作：不懂 Shell 的用户让机器人代操作 Ubuntu 云桌面，全程可视化审批
4. 语音播报 / 监听：设置好后让机器人在后台跑任务，早餐时听汇报
5. 定时任务 + Webhook：外部 CI/CD 触发机器人自动在云桌面执行构建和测试

坑与注意

⚠️ Ubuntu / Linux 支持仍为 Beta：本地屏幕预览和控制暂不支持（Wayland 捕获尚未验证）；Composio 和 Box 云电脑功能在 Linux 上也是 Beta 状态

⚠️ macOS 独占功能：语音通话和本地听写依赖 Apple 语音识别框架，Linux / Windows 不支持

⚠️ Windows 签名问题：installer 尚未代码签名，SmartScreen 会有警告，需要手动确认运行

⚠️ Box 为付费服务：云端桌面试用后会产生费用，不适合完全免费使用

⚠️ Webhook 需要本地运行：OpenMausBot 必须保持运行才能接收 webhook；公网访问需要通过 Tailscale Funnel 或托管中继暴露本地端口

⚠️ Node ≥ 24 硬性要求：老版本 Node 可能导致 pnpm install 或构建失败

⚠️ Grok CLI 支持：Grok 来自 xAI，CLI 安装和登录方式与 Claude / Codex 不同，需参考 x.ai/cli 单独配置

⚠️ v1 阶段粗糙边角：官方文档中明确说明"Early but real — rough edges to expect"，生产环境使用前请评估

与同类对比

核心差异：OpenMausBot 是唯一将多 Agent 协作做成本地消息应用的工具；大多数竞品是纯 CLI 或 Web 界面。

一句话推荐结论

如果你想在本地用一个界面管理多个 AI 机器人（Claude / Codex / Grok），让它们各自连接真实 App 协作，全程审批可控——OpenMausBot 是目前最接近"AI 通讯录"概念的开源方案，macOS 用户体验最完整，Windows 可用，Linux 尚在 Beta。

来源

• GitHub README：https://github.com/milind-soni/OpenMausBot
• Composio 集成文档：https://github.com/milind-soni/OpenMausBot/blob/main/docs/composio.md
• Voice Mode 文档：https://github.com/milind-soni/OpenMausBot/blob/main/docs/voice-mode.md
• Ubuntu Desktop 指南：https://github.com/milind-soni/OpenMausBot/blob/main/docs/linux-desktop.md