OpenMausBot：把 Claude、Codex 和 Grok CLI 组成可操作的本地智能团队
给已有 Claude、Codex 或 Grok CLI 的开发者，把多个本地 Agent 变成能操作电脑和应用的聊天团队。
GitHub milind-soni/OpenMausBot 更新 2026-10-30 分支 main 星标 7.5K 分叉 1.1K
TypeScript 本地优先 AI Agent Claude / Codex / Grok CLI macOS、Windows、Ubuntu 24.04

🧭 决策指南

为什么现在热： README 将 OpenMausBot 描述为开源 Grok Bot、Meta Muse、OpenAI dots 和 Cue by Manus 的替代方案，同时强调 claude、codex、grok CLI、自有订阅和 127.0.0.1 本地优先；结合 2026-10-30 单日新增 1,199 星、总星 7,479 以及最新版本 0.1.134，这些明确卖点可能解释了当前关注度，但材料无法证明具体是哪一项直接触发 Trending。

适合，如果你

  • 你已有 claude、codex 或 grok CLI，并希望复用现有登录和订阅
    README 的 Why 章节写明 Bots run on the `claude`, `codex`, and `grok` CLIs，以及 no new accounts
  • 你希望把 Markdown 团队文件接入 OpenMausBot，并让连接和 routines 默认保持受控
    README 的 Features / Install a complete team from one Markdown file 章节说明 Teams → Import、连接需批准、routines 初始暂停
  • 你要在脚本或 CI 中执行团队任务并读取机器可处理结果
    README 的 Run it from scripts and CI 章节提供 `openmausbot run`、`--json` 和退出码说明
  • 你的桌面环境是 macOS、Windows 或 Ubuntu 24.04 x64，并需要本地 harness server
    README 的 Quick start 要求列出这三类系统，并说明 released builds 内嵌 harness server

不适合，如果你

  • 你需要 Ubuntu Wayland 的主机电脑控制能力
    README 的 Why 章节明确写明 Ubuntu Wayland host control remains disabled while issue #345 is resolved
  • 你的部署目标不是 GNOME 的 Ubuntu 24.04 桌面环境
    README 的 Quick start 标注 Ubuntu 24.04 构建为 Beta，GNOME 是 supported desktop
  • 你的安全要求禁止 API key 以明文写入本地配置文件
    README 的 Run from a terminal or on a server 章节写明 API keys are saved as plaintext in `config.json`
  • 你不能接受 Windows 安装器触发 SmartScreen 的 unknown publisher 提示
    README 的 Quick start 写明 Windows installer isn't code-signed yet

前置条件

  • 操作系统为 macOS、Windows 或 Ubuntu 24.04 x64
  • Node 24+、pnpm，以及至少一个已安装并登录的 `claude`、`codex` 或 `grok` CLI
  • 从源码运行需执行 `pnpm install`；桌面开发需保持 `pnpm dev:server` 和 `pnpm dev` 运行
  • Ubuntu 桌面构建要求 GNOME；Ubuntu 发行包提供 `.deb` 或 AppImage beta

第一步命令（README 原文）

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

要注意

  • 首次运行必须先完成 AI access、登录或 API key、模型选择
    README 的 Run from a terminal or on a server 章节说明首次启动会引导这些选项
  • API 模式可能发送可计费的测试消息，setup 会在发送前询问
    README 的 Run from a terminal or on a server 章节明确说明 potentially billable test message
  • 手机不能直接使用 localhost 链接，远程访问需 pairing 或 Tailscale
    README 的 Run from a terminal or on a server 章节写明 phone cannot use a localhost link
  • 使用 `npx openmausbot serve` 时，`--tunnel` 需要先执行 `npx openmausbot login`
    README 的 Run from a terminal or on a server 章节给出 `--tunnel` 前置登录要求

替代方案

  • Grok Bot：如果你需要 README 所称的原始 Grok Bot 体验，而不是本地优先和自带 CLI 的开源替代方案
    README 的 Why 章节
  • Meta Muse：如果你的比较范围是 README 明确列出的 Meta Muse 产品，而不是 OpenMausBot 的本地部署模型
    README 的项目介绍段落

材料未说明

  • README 未给出 Claude、Codex、Grok CLI 的最低兼容版本
  • README 未给出多 Agent 并发时的 CPU、内存或磁盘需求
  • README 未给出 500+ Composio 应用的逐项兼容范围和权限模型
  • README 未给出本地 VM、云端 Linux 桌面与主机控制的性能差异
  • README 未提供安全审计、漏洞响应 SLA 或 API key 加密计划
  • README 未说明 10 位贡献者与 5 个版本对应的长期维护节奏

💡 深度解析

6
不适合 我运行 Ubuntu 24.04 x64 的 GNOME Wayland，并希望 Bot 直接控制宿主机，而不是使用云桌面或 Local VM；OpenMausBot 能满足这个约束吗？
适合读者： 运行 Ubuntu 24.04 x64、使用 GNOME Wayland、希望让代理操作本机桌面的 Linux 工程师

不适合当前这个精确约束，因为 README 明确表示 Ubuntu Wayland 宿主机控制暂时禁用；你只能改用隔离环境或云桌面。

  • Ubuntu 24.04 x64 有 .deb 和 AppImage，但 Linux 桌面发行版仍标为 Beta，GNOME 是支持的桌面环境。
  • 代理计算机能力仍可使用云端 Linux 桌面或隔离 Local VM，这些选项不等于直接控制 Wayland 宿主机。
  • 宿主机控制目前只列出 macOS 和 Ubuntu Xorg，并且需要显式 opt-in；Wayland 的禁用状态与 issue #345 相关。

因此，如果“必须操作本机 Wayland 桌面”不可妥协，应等待该能力恢复或选择支持 Xorg 的环境。README 没有承诺 issue #345 的解决时间。

  • Why："Ubuntu Wayland host control remains disabled while issue #345 is resolved"
  • Why："Host control is available on macOS and Ubuntu Xorg after explicit opt-in"
  • Quick start："Ubuntu 24.04 (x64)"；"Beta; GNOME is the supported desktop"
  • Why：支持 cloud Linux desktop 与 isolated Local VM
材料未说明：README 未说明 issue #345 的预计修复版本或时间。；README 未说明在 Wayland 下是否存在可用的宿主机控制替代实现。
不适合 我需要在 VPS 上自托管 OpenMausBot，但组织政策禁止 API 密钥以明文保存；即使文件权限是 0600，我是否可以直接采用它的 API 模式？
适合读者： 希望把代理部署到 VPS 或自托管服务器、并要求 API 密钥不以明文落盘的企业内部自动化管理员

不适合直接采用 API 模式，因为 README 明确写明 API keys 会以明文保存到 config.json；0600 只限制 Unix 文件访问，不能满足“不落盘明文”的政策。

  • 终端模式支持 Node 24+，也可以部署到服务器，但服务器部署并不会改变凭证存储规则。
  • openmausbot setup 可重新配置模型和访问方式，但 README 仍说明 API keys are saved as plaintext, not encrypted。
  • 项目数据、转录、事件和配置默认保存在 ~/.openmausbot，因此 VPS 还需要额外处理磁盘、备份和管理员访问风险。

如果组织允许使用已有 CLI 登录态，可能可以避开该 API 密钥路径，但 README 没有说明 CLI 凭证的具体存储方式，也没有提供外部 secret manager 集成。

  • Run from a terminal or on a server："API keys are saved as plaintext, not encrypted, in private `config.json` (`0600` on Unix)."
  • Run from a terminal or on a server：支持 `npm install -g openmausbot` 与服务器运行
  • Why："Transcripts, keys, and events live in `~/.openmausbot`, not a cloud."
  • 项目洞察：企业自托管仍需自行完成加密、访问控制、备份、审计和密钥轮换
openmausbot setup
材料未说明：README 未说明 CLI 登录凭证是否加密、如何轮换，以及是否支持外部 secret manager。；README 未说明 VPS 部署是否提供内置磁盘加密、审计日志或多用户权限模型。
适合 我已经在 macOS 上登录了 Claude Code，并希望让多个 Bot 分别使用不同模型、独立记忆和各自的计算机环境；OpenMausBot 是否适合我？
适合读者： 已经使用 Claude Code、Codex 或 Grok CLI、希望在本机用聊天界面管理多个代理的个人开发者

适合，因为它把已有 CLI 代理包装成可分别管理的聊天联系人，而不是要求你迁移到新的模型账号。

  • 每个侧边栏 Bot 都是真实代理，拥有独立人格、模型、线程记忆、计算机和应用连接；底层支持本机已安装的 claude、codex 和 grok CLI。
  • macOS 同时支持 Apple silicon 和 Intel，发布版内置 harness server，不需要另外启动服务。
  • 代理可以使用云端 Linux 桌面、隔离 Local VM，或在明确授权后控制 macOS 宿主机；高风险动作可要求审批。

但它不是模型本身，Claude CLI 的登录状态、订阅权限和网络仍由你负责；README 也没有说明不同模型之间的上下文迁移是否一致。

  • Why："Bots run on the `claude`, `codex`, and `grok` CLIs installed on your own machine"
  • README 开头："Every bot in the sidebar is a real agent ... with its own personality, its own model, its own cloud computer, and its own connected apps."
  • Quick start：macOS Apple silicon 与 Intel；"the harness server is embedded"
  • Why："Host control is available on macOS ... after explicit opt-in"
npm install -g openmausbot
材料未说明：README 未说明 Claude、Codex 与 Grok 之间切换时，历史上下文、工具调用格式和记忆是否完全兼容。；README 未给出单台 macOS 主机可稳定运行的 Bot 数量或并发限制。
适合 我希望在手机上查看并操作运行在另一台 Windows、macOS 或 Ubuntu 主机上的 OpenMausBot；我可以使用 Tailscale，但不能把 localhost 暴露给手机，这种部署是否可行？
适合读者： 想从手机访问本地或远程 OpenMausBot、同时需要受保护 HTTPS 或 Tailscale 连接的开发者

适合，前提是你通过 Tailscale、受保护的 HTTPS 端点或自己的 HTTPS 反向代理完成配对；手机不能直接访问 localhost。

  • README 支持桌面端配对到另一台 Windows、macOS 或 Ubuntu 主机，也支持手机浏览器、原生 Android/iOS 客户端和可安装的手机 Web App。
  • 首次终端启动可选择手机连接；Android 使用二维码应用链接，iOS 可使用应用链接或 Web 链接。
  • 远程访问必须选择明确批准的受保护 HTTPS 端点、已有 Tailscale 连接或自有 HTTPS 反向代理；--local 可让单次启动忽略已保存的远程配置。

这适合远程控制界面，但不是自动获得安全公网入口。README 没有说明反向代理的认证实现、并发设备数或移动端对全部桌面功能的支持范围。

  • Run from a terminal or on a server："A phone cannot use a localhost link."
  • Run from a terminal or on a server：支持 managed public HTTPS、Tailscale 或 HTTPS reverse proxy
  • Quick start："Any desktop build can also pair as a client to another Windows, macOS, or Ubuntu host over Tailscale"
  • Run from a terminal or on a server：Android QR app link、iOS app link 或 web link
openmausbot
材料未说明：README 未说明自有反向代理所需的具体身份认证、TLS 配置和访问控制实现。；README 未说明手机端是否支持全部代理审批、计算机控制和外部应用功能。
适合 我维护一个 Node 24+ 的自动化环境，需要从脚本或 CI 启动 Bot、等待协作者结束并导出 JSON 结果；OpenMausBot 是否适合做无界面执行层？
适合读者： 需要把 AI 代理接入脚本、CI 和定时任务、使用 Node 24+ 的自动化工程师

适合，因为 README 明确提供终端启动方式、CLI 编排能力以及面向脚本的 JSON 输出和退出码。

  • 可以通过全局 npm 安装或 npx 运行，首次启动会引导选择 AI 访问方式、模型和可选手机连接。
  • 项目支持 team apply、运行代理、等待代理及协作者完成、导出结果，并以 JSON 输出和退出码服务自动化流程。
  • harness server 负责代理进程、事件和会话，桌面 UI 与无界面 CLI 可共享同一工作区概念。
  • 运行要求包括 Node 24 或更高版本，以及至少一个已安装并登录的 claude、codex 或 grok CLI。

不过 README 没有定义 CI 中的重试、超时、幂等或部分完成语义；这些行为不能仅凭项目说明推断。

  • Run from a terminal or on a server："With Node 24 or newer, install once and run"
  • 项目洞察：支持 team apply、run、等待协作完成、结果导出、JSON 输出和退出码
  • Quick start：至少一个已安装并登录的 `claude`、`codex` 或 `grok` CLI
  • 项目洞察：本地 harness server 统一维护代理进程、转录和事件
npm install -g openmausbot
材料未说明：README 省略的 CLI 章节未提供完整命令参数、JSON schema、超时选项和退出码定义。；README 未说明 CI 中并发运行多个团队或任务时的资源隔离方式。
视情况 我想把 Bot、Chief of Staff、频道、playbook 和例行任务写成可审查的 Markdown 包，分发给使用 Claude 或 Codex CLI 的小型团队；OpenMausBot 是否适合这种可移植配置？
适合读者： 希望把一组 Bot、Chief of Staff、频道和 playbook 作为 Markdown 团队包分发给小型团队的技术负责人

视情况：它适合分发角色和工作流定义，但不适合把 Markdown 包当作完整的权限、凭证和运行环境交付物。

  • 项目支持带 YAML frontmatter 的 Markdown 团队包，可描述 Bot、Chief of Staff、频道、playbook、连接清单和例行任务。
  • 导入前提供审核；连接默认关闭，例行任务默认暂停，团队包不携带凭证、会话、权限或计算机访问权，这有利于审查和迁移。
  • Bot 仍依赖接收方已经安装并登录的 claude、codex 或 grok CLI，以及其可用模型和计算机环境。

因此它适合作为“配置与流程蓝图”，不等于一键复制完整团队运行态。README 未说明不同成员的模型权限差异如何在导入时自动检测或报告。

  • 项目洞察：团队包通过带 YAML frontmatter 的 Markdown 文件安装 Bot、Chief of Staff、频道、playbook、连接清单和例行任务
  • 项目洞察：导入前提供审核，连接默认关闭，例行任务默认暂停
  • 项目洞察：团队包不携带凭证、会话、权限或计算机访问权
  • Why：依赖本机已安装并登录的 `claude`、`codex` 和 `grok` CLI
材料未说明：README 未提供团队包的完整 schema、版本兼容规则或冲突处理方式。；README 未说明导入时是否会检查接收方的 CLI 版本、模型订阅和外部应用权限。

✨ 核心亮点

  • 支持 claude、codex、grok CLI，自带已有登录与订阅
  • 127.0.0.1 harness server 将代理进程和数据留在本机
  • 每个 Bot 可连接云端 Linux、Local VM 或主机电脑
  • 团队可由 Markdown 文件导入，并用 openmausbot 执行 CI 任务
  • Ubuntu Wayland 主机控制因 issue #345 仍处于禁用状态

🔧 工程化

  • 在聊天侧栏管理 Claude 或 Codex 本地 Agent，各自拥有模型和记忆
  • 通过 Teams → Import 导入 YAML frontmatter 驱动的 Markdown 团队
  • openmausbot run 支持团队协作、--json 输出和 --export 导出
  • Composio 提供 500+ 应用连接，连接需用户批准后才启用

⚠️ 风险

  • API key 以明文保存于 config.json，Unix 权限为 0600
  • Windows x64 安装器尚未代码签名，SmartScreen 会显示未知发布者
  • Ubuntu 24.04 构建仍为 Beta，且只支持 GNOME 桌面
  • macOS 和 Ubuntu Xorg 主机控制也必须显式 opt-in

👥 适合谁？

  • 已有 claude、codex 或 grok 登录环境的个人开发者
  • 需要把多 Agent 团队接入脚本和 CI 的 TypeScript 团队
  • 使用 macOS、Windows 或 Ubuntu 24.04 x64 的桌面用户