OpenMausBot 完整指南：一行命令把免费的 AI Bot 团队装进聊天应用
【免费下载链接】OpenMausBotOpen-source Grok Bot alternative with a virtual machine that bots can use项目地址: https://gitcode.com/GitHub_Trending/op/OpenMausBot
想让一个 AI 助手帮你查邮件、改文档、夜里盯任务，它却只会框里回话，干不了活。OpenMausBot 是一个开源、本地优先的 Grok Bot 替代品：一个形似 Telegram 的聊天应用，侧边栏里每个"联系人"都是一支真正的 AI Bot 团队，跑在你自己的机器上，用你已有的 Claude、Codex 或 Grok 订阅，数据留在本地~/.openmausbot。
为什么单个 AI 助手装不下一个团队
单一助手只有一个大脑、一条会话：分工做不了，并行干不了，每一步都要人盯着看。当任务横跨邮件、代码和服务器时，单个聊天窗口就成了瓶颈。所以 OpenMausBot 走了相反的路——它不是往聊天窗口里加功能，而是把智能体装进消息应用；它不是要求你新注册账号的 AI 服务，而是驱动你现有 AI 订阅的本地调度层。
OpenMausBot 的三部分组成方式
整体分三层。前端是 React + Tailwind 写的聊天界面，自身不带任何网络传输层，只发命令、收一条事件流。中间是 harness 服务器，一个监听127.0.0.1:8799的本地小服务，拥有全部 agent 进程，把 Claude、Codex、Grok 各家协议归一化成标准事件流（SSE）。后端是引擎：你机器上已装好登录的 CLI，每个 Bot 还能再挂一台云端 Linux 桌面、一台隔离的本地虚拟机，或在明确授权后操作你自己的电脑。打个比方：聊天界面是前台，harness 是调度中心，CLI 才是真正干活的工人。
三种方式跑起来：安装包、一行命令或源码
- 安装包（新手推荐）：macOS 有 Apple 芯片 / Intel 双 .dmg，已签名公证；Windows x64 安装器；Ubuntu 24.04 提供 .deb 与 AppImage（Beta）。harness 已内嵌，装完即用。
- 一行命令：Node.js 24+ 环境下执行
npx openmausbot。首启向导用方向键引导你"选引擎 → 登录或粘贴 Key → 选模型 → 连接手机"，之后同一命令复用已存设置，详见终端上手指南。 - 源码运行：git clone https://gitcode.com/GitHub_Trending/op/OpenMausBot 后执行
pnpm install，再并行跑pnpm dev:server（服务器）与pnpm dev（Web 界面），pnpm dev:desktop启动 Electron 壳。
把 Bot 真派上活：云电脑、审批卡与模型热切换
打开 Computer 面板，Bot 的云桌面自动启动：它干活时你有实时屏幕预览，可以点"Open desktop"在浏览器里亲自接管这台机器，也可以把 Bot 直接指向"这台 Mac/Windows"。
Bot 想跑一条 Shell 命令时会发生什么？所有 Shell 命令、文件编辑、提问都会以内联审批卡片出现在聊天里——Allow / Deny / 直接回答。权限代理（permission broker）把每个高风险动作变成你的一次明确决策，目标机器无论在云上还是本地。
"大脑"也能随时换。模型选择器把 Claude 与 Codex 的模型并排展示，支持对话中途切换模型，不可用的厂商会灰显并注明原因。基于 Composio 的应用市场一次 OAuth 即可接入 Gmail、GitHub、Slack、Notion 等 500+ 应用，所有 Bot 都能当工具调用，支持多账号管理，见应用接入文档；各厂商驱动的源码入口在 server/drivers/。
管理方式也像管联系人：右键即可置顶、标记未读、编辑资料、复制、隐藏、删除；还能把 Bot 编进不同频道（Channel）——工作、个人、每个项目各占一个，各自拥有独立会话、共享指令和工作目录，Bot 本体不用克隆。
进阶：团队打包成文件，定时任务让它夜里干活
- 团队文件：浏览 outcome 驱动的 Bot 团队，点"Add to OpenMausBot"，应用先打开审核页再创建 Bot、Chief of Staff、频道、Playbook 与连接器清单，
.md文件也能导入本地。右键团队选 Share team… 可导出单个.openmaus.json，含指令、技能、群聊和定时任务，但绝不包含聊天记录、密钥和模型选择，形似秘密的内容会被自动清除。见团队分享文档。 - 定时任务 Routines：支持单次、按星期、每 5–1440 分钟间隔执行，另有独立 Webhook 接收器（本地
127.0.0.1:8800），Bot 可以真正"夜里替你干活"。 - 会开口的 Bot：接入 ElevenLabs、Fish Audio、Grok（xAI）、Mac 内置声音或本地 Chatterbox 服务器，点喇叭听 Bot 朗读回复，Mac 上还能直接"打电话"和它对话。见语音模式文档。
- 记忆是纯 Markdown：每个 Bot 的记忆就是
MEMORY.md加日志文件，任何编辑器都能打开修改，写入的 API Key 会被自动打码。见Bot 记忆文档。
把 OpenMausBot 延伸到手机、VPS 与外部客户端
- 📱手机：iOS / Android 原生应用扫桌面端二维码配对，手机成为只读信任客户端——宿主机器仍是持久化 agent 进程、凭证和数据的唯一机器；iOS 版支持审批、SSE 断点续传、Markdown 渲染与 Keychain 存储，架构见iOS 伴侣文档。另一台 Windows/macOS/Ubuntu 也能以桌面伴侣模式作为客户端接入宿主。
- 自托管 / VPS：
npx openmausbot serve配合 Cloudflare 隧道、Tailscale 或 Docker 自建域名，把 Bot 团队搬到 7×24 在线的服务器，参考VPS 部署指南。 - MCP 编排：内置 stdio MCP 服务器，Claude Desktop、Cursor 等外部客户端可借此查看 Bot 与频道、发送任务、切换模型、中断回合，但刻意不暴露审批授权、删除和凭证接口。见MCP 服务器文档。
代码怎么组织的：六个模块速览
| 模块 | 路径 | 职责 |
|---|---|---|
| 聊天界面 | src/ | React + Tailwind 聊天壳，零客户端传输层 |
| 引擎驱动 | server/drivers/ | 每个 AI 厂商一个驱动，扩厂商只需一个文件加一行注册 |
| Harness | server/harness/ | 驱动注册表 + SSE 事件总线 |
| HTTP API | server/index.ts | Bot、回合、审批、模型目录、电脑生命周期 |
| 语音合成 | server/tts/ | ElevenLabs、Fish Audio、Mac 内置声音等 |
| 桌面壳 | electron/ | macOS / Windows / Ubuntu 三端 Electron |
OpenMausBot 采用Apache License 2.0（enterprise/目录除外，它按自身许可证以 source-available 提供，删掉即得纯开源版）。驱动 SPI 刻意设计得很小：添加一个 AI 厂商只需在server/drivers/加一个文件加一行注册；不写代码也能通过配置接入 OpenAI 兼容端点或 ACP CLI。
谁值得试试
- 想在自己的电脑和订阅上跑多智能体团队的开发者——本地优先，数据不出门；
- 想让 AI "动手干活"的用户——云虚拟机 + 审批卡片，是有安全网的那种动手；
- 想要开源版 Grok Bot、又不想被单一厂商锁定的团队——模型可换、团队可分享、服务可自托管。
项目自述"早期但真实可用"：消息 → agent → 流式回复 → 工具 → 审批 → 用电脑的链路端到端跑通；macOS 与 Windows 已稳定发布，Ubuntu 为 Beta，移动端连接和 Webhook 托管中继仍在建设中。如果你手上正好有一份空闲的订阅和十分钟，敲一次npx openmausbot，看看这支 Bot 团队能帮你干出什么。
【免费下载链接】OpenMausBotOpen-source Grok Bot alternative with a virtual machine that bots can use项目地址: https://gitcode.com/GitHub_Trending/op/OpenMausBot
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
