OpenMausBot

在聊天应用中，运行你自己的 AI 机器人团队。

_{Grok Bot 的开源版本——自带代理、本地优先，运行在你已有的模型之上。}

侧边栏中的每个机器人都是一个真正的智能体——底层是本地运行的 Claude 或 Codex——拥有自己的个性、自己的模型、自己的云端电脑，以及自己连接的应用程序。像联系人一样与它们聊天，观看它们工作，审批重要事项。

_{Apple 芯片 · 已签名并公证 · 一键 .dmg，始终最新 · 所有版本}

OpenMausBot —— 一个类 Telegram 的聊天应用，每个聊天都是一个真正的 AI 智能体

为什么

“一个盒子装一个助手”对智能体来说并不是正确的形态。OpenMausBot 是对 Grok Bot 的开源改造——保留了其核心理念（AI 作为一个 消息应用：一个你可以与之聊天的机器人列表，每个机器人拥有自己的个性、线程记忆、模型、电脑和应用），并以开放、本地优先的方式重建，运行在你已有的智能体之上：

自带代理。 机器人运行在 Mac 上安装的 claude、codex 和 grok CLI 之上——使用你现有的登录和订阅，无需新账户，中间无代理。
本地优先。 一个在 127.0.0.1 上的小型 harness 服务器持有所有智能体进程。记录、密钥和事件都存储在 ~/.openmausbot，而不是云端。
有手有脚的智能体。 每个机器人都可以获得一台真正的电脑——一个你可以在观看实时画面时操控的云 Linux 桌面，或者你自己的 Mac——以及通过 Composio Connect 接入的 500+ 应用。

功能

🧠 为每个机器人挑选大脑

一个带提供商侧栏的模型选择器——Claude 和 Codex 模型并排显示，默认项有标记，不可用的提供商灰显并标明原因。可在对话中途切换机器人的模型。

🖥️ 每个机器人都有一台电脑

打开 Computer 面板，机器人的云桌面就会独立启动——工作时实时预览屏幕，点击“Open desktop”可在浏览器中接管，或让机器人改用它 这台 Mac。

🙋 机器人行动前先询问

Shell 命令、文件编辑和问题会以内联卡片形式呈现——允许 / 拒绝 / 在聊天中回答。一个权限代理将每个风险操作变成你的决定，云端和本地电脑均适用。

🔌 已连接应用

基于 Composio Connect 的一键市场：Gmail、Slack、GitHub、Notion、Linear 以及数百个其他应用。OAuth 一次，每个机器人即可将其作为工具使用。

🗂 像管理聊天一样管理机器人

右键点击任意机器人：置顶、标为未读、编辑资料、复制、复制对话 ID、隐藏、删除。这是一个消息应用——你的智能体行为就像联系人一样。

🔑 密钥一次配置，全部点亮

在应用设置中粘贴凭证——它们保存在本地，提供商集群会立即热重载。密钥是只写的：UI 永远只显示“已配置”标志。

此外还包含： 带工具运行活动芯片的流式回复 · 原生 macOS 听写（来自输入框麦克风，使用设备端 Apple 语音识别——桌面应用）· SupaMaus 光标吉祥物，具有角色感知表情 · 机器人的工作截图会折叠到对话记录中。

工作原理

两个进程。应用不持有自己的传输层——它通过 HTTP 发送类型化命令，并将一条 SSE 事件流合并为状态。Harness 服务器持有每个智能体进程，并将每个提供商的原生协议规范化为一个统一的运行时事件流（按线程记录为 NDJSON）。

flowchart LR
    subgraph app ["App — React + Tailwind (5199)"]
        UI[Chat UI · model picker · computer panel]
    end
    subgraph server ["Harness server (127.0.0.1:8799)"]
        REG[Driver registry] --> BUS[Event bus → SSE]
        BROKER[Permission broker]
    end
    subgraph agents ["Agents on your Mac"]
        CL[claude CLI]
        CX[codex CLI]
    end
    UI -- "HTTP commands" --> server
    BUS -- "one SSE stream" --> UI
    REG --> CL & CX
    CL & CX -- "MCP" --> BROKER
    server -- "Box API" --> BOX[("Cloud computer<br/>box.ascii.dev")]
    server -- "Composio Connect" --> APPS[("Gmail · Slack · GitHub · …")]

层	位置	作用
驱动	`server/drivers/`	每个提供商一个：Claude、Codex 和 Grok Build，通过各自的本地 CLI（stream-JSON / JSON-RPC / ACP），外加一个云电脑智能体。未知驱动降级为“不可用”，绝不会导致集群崩溃。
Harness	`server/harness/`	注册表（配置 → 实时实例）以及所有客户端合并的扇入事件总线。
API	`server/index.ts`	机器人、轮次、审批、模型目录、电脑生命周期、连接器、配置——HTTP + SSE。
应用	`src/`	聊天外壳。服务端支持的存储、单一 reducer、零客户端传输。
桌面	`electron/`	macOS 外壳：听写助手（SFSpeechRecognizer）、本地屏幕捕获、CUA 桥。

快速开始

最简单的方式： 下载最新的 .dmg，拖到 Applications，打开即可。Harness 服务器已内置——无需配置。

从源码构建：

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

pnpm dev:server    # harness 服务器 → 127.0.0.1:8799
pnpm dev           # 应用 → http://127.0.0.1:5199
pnpm dev:desktop   # 或 Electron 外壳

要求：macOS、Node 24+、pnpm，以及至少一个已安装并登录的智能体 CLI——claude、codex 或 grok。它们会自动出现在模型选择器中。

可选配置，在 应用设置（侧边栏底部的齿轮图标）中粘贴一次：

密钥	解锁
Composio Connect 密钥（`ck_…`）	已连接应用市场
Composio API 密钥（`ak_…`）	含官方标志的完整 500+ 应用目录
Box token（box.ascii.dev）	机器人的云电脑

pnpm typecheck     # 应用 + 服务端
pnpm build         # typecheck + 生产构建

状态

早期但真实可用——端到端流程已经跑通：消息 → 智能体 → 流式回复 → 工具 → 审批 → 电脑使用。可能存在一些粗糙之处：例行任务（计划任务）还是占位符，侧边栏分区尚未构建，Windows/Linux 外壳尚未尝试（harness 本身是便携 Node）。

欢迎贡献——server/contracts.ts 中的驱动 SPI 刻意保持小巧；添加一个提供商只需在 server/drivers/ 中增加一个文件，外加一行注册。

许可证

OpenMausBot 是一个受 Grok Bot 启发的独立开源项目。它与 xAI 无关联、未经其认可，也不存在任何附属关系；“Grok” 是其各自所有者的商标。