OpenMausBot 是一个面向 macOS 的开源 AI Agent 聊天桌面应用，用类似 Telegram/微信联系人的方式管理多个 AI Bot。每个 Bot 都可以绑定不同的本地 Agent CLI（Claude、Codex、Grok），拥有独立人格、会话记忆、模型、工具权限和可选的云端 Linux 桌面或本机操作能力。项目采用 TypeScript、React 19、Electron 和本地 Harness Server 架构，强调 local-first：会话、密钥、事件日志主要保存在本机 ~/.openmausbot，不通过项目方云端代理模型请求。
适用领域
AI Agent / 桌面应用 / 开发者工具 / 多模型编排 / 本地优先应用 / 自动化办公 / AI 编程助手 / 工具调用与权限控制 / Electron 应用 / MCP/Agent Runtime
配置难度
中高。普通 macOS 用户使用 .dmg 安装较简单，但要发挥完整能力，需要理解 Claude/Codex/Grok CLI、API Key、Composio、云电脑、本地服务端、权限审批等概念；开发者二次开发需要熟悉 TypeScript、React、Electron、Node Server、SSE、Agent 协议和工具调用。
商业价值
对个人开发者和小团队的价值较高：它把多种 AI 编程/办公 Agent 聚合到一个本地聊天工作台中，可提升代码开发、自动化办公、工具集成和任务委派效率。对企业而言，它展示了一种 local-first Agent 桌面平台架构，适合作为内部 AI 助手工作台、Agent 审批系统、工具调用网关的原型参考。但由于项目仍早期、主要支持 macOS、依赖外部 CLI 和第三方工具生态，直接用于生产级企业场景前需要进行权限治理、安全审计、日志合规、跨平台适配和稳定性验证。
01
技术亮点
- 交互形态清晰：把 AI Agent 做成聊天联系人，降低多 Agent 使用门槛。
- Bring Your Own Agent：复用用户本机已有的 claude、codex、grok CLI 登录和订阅，不额外代理模型请求。
- Local-first：会话、密钥和事件日志保存在本地，隐私和可控性优于完全云端化方案。
- 权限审批机制：shell 命令、文件编辑、问题确认等风险操作会以卡片形式请求用户 Allow/Deny。
- 支持云端电脑和本机操作：Bot 可以使用云 Linux 桌面，也可以指向用户自己的 Mac。
- 工具生态强：通过 Composio Connect 可接入 Gmail、Slack、GitHub、Notion、Linear 等大量应用。
- 架构较干净：前端通过 HTTP 命令和 SSE 事件流与本地 Harness 通信，Agent Driver SPI 相对小，方便扩展新 Provider。
- MIT 许可证，适合学习、二次开发和商业项目参考。
- 已有 485 stars 和 85 forks，说明社区关注度较高。
02
目标用户
- 已经使用 Claude Code、OpenAI Codex CLI 或 Grok CLI 的开发者
- 希望用聊天软件形态管理多个 AI Agent 的个人用户
- 需要让 AI Agent 操作 GitHub、Gmail、Slack、Notion、Linear 等工具的效率工作者
- 关注本地数据保存、避免中心化代理服务的技术用户
- 希望研究多 Agent 桌面交互、权限审批、工具调用流的开发者
- macOS 用户，尤其是 Apple Silicon 用户
03
配置要求
- 操作系统要求：当前主要支持 macOS，README 明确说明 Windows/Linux shell 尚未适配；Harness 本身基于 Node，理论上更易移植。
- 运行环境：Node 24+、pnpm。
- 至少安装并登录一个 Agent CLI：claude、codex 或 grok。应用会自动检测可用 CLI 并在模型选择器中显示。
- 可选配置：Composio Connect key，以启用连接应用市场。
- 可选配置：Composio API key，以启用完整 500+ 应用目录和官方 logo。
- 可选配置：Box token，用于给 Bot 分配云端 Linux 电脑。
- 本地数据目录：转录、密钥、事件等位于 ~/.openmausbot。
- 网络要求：使用 Claude/Codex/Grok CLI、Composio、Box 云电脑时仍需对应服务的网络访问与账号权限。
04
适用场景
- 把多个 AI 编程助手当作不同联系人管理，例如一个负责前端、一个负责后端、一个负责代码审查
- 在同一聊天界面中切换 Claude、Codex、Grok 等不同 Agent CLI 的模型能力
- 让 Agent 执行 shell 命令、修改文件或操作云端桌面，并在关键步骤前请求用户批准
- 通过 Composio Connect 连接 GitHub、Gmail、Slack、Notion、Linear 等 SaaS 应用，让 Bot 执行业务流程自动化
- 用云端 Linux 桌面让 AI 完成浏览器操作、环境搭建、远程任务执行等工作
- 本地记录 AI Agent 的事件流、转录和工具调用过程，便于审计和调试
- 作为参考项目学习如何把多个 Agent CLI 统一成一个事件流和桌面 UI
05
部署与配置
- 方式一：下载官方 macOS .dmg 安装包，拖入 Applications 后直接打开。该方式内置 Harness Server，最适合普通用户。
- 方式二：从源码运行。执行 git clone https://github.com/milind-soni/OpenMausBot && cd OpenMausBot。
- 安装依赖：pnpm install。
- 启动本地 Harness Server：pnpm dev:server，默认监听 127.0.0.1:8799。
- 启动 Web App 开发界面：pnpm dev，默认访问 http://127.0.0.1:5199。
- 如需桌面壳运行：pnpm dev:desktop。
- 构建或检查：pnpm typecheck 用于类型检查，pnpm build 用于生产构建。
06
风险与注意事项
- 项目状态仍为 Early but real，README 明确提到 routines、sidebar sections 等功能尚未完善。
- 当前强依赖 macOS，Windows/Linux 用户基本不能直接使用完整桌面体验。
- 需要用户自行安装并登录 Claude/Codex/Grok CLI，初始门槛高于普通 SaaS AI 工具。
- Agent 能执行命令、改文件、连接第三方应用，即使有审批机制，仍存在误操作、数据泄露和权限滥用风险。
- Composio、Box、模型 CLI 等外部服务的稳定性、费用、权限策略变化会直接影响体验。
- 云端电脑能力涉及远程执行和浏览器操作，需要谨慎处理账号、Cookie、敏感数据和企业合规要求。
- 项目与 Grok Bot/xAI 无从属关系，并且 README 特别声明无任何加密货币关联；需警惕冒名代币或钓鱼项目。
- Node 24+ 要求较新，部分开发环境可能需要升级。
- 作为桌面应用和本地 Agent 编排系统，调试复杂度高于普通 Web 项目。
2026-08-15
第14名
新收录 · github_search
2026-08-14
第12名
新收录 · github_search
2026-08-13
第16名
新收录 · github_search
