milind-soni/OpenMausBot

效率与系统工具

在自有机器上以聊天应用形式,自托管一组本地 Claude、Codex、Grok 智能体。

在 GitHub Trending 日榜上的最好名次:第 5 名。点击获取 README 徽章
7,139
1,084
TypeScript
Apache-2.0
创建于 2 个月前

OpenMausBot 是一个桌面聊天客户端:侧边栏里的每个联系人都是一个独立 AI 智能体,各自拥有模型、人设、存储空间和可连接的应用。它面向希望拥有 Grok Bot 式多智能体工作区、又不想把对话、密钥和智能体进程交给厂商云端的用户。

核心流程与架构

绑定在 127.0.0.1 上的小型 harness 服务掌管所有智能体进程;React 应用通过 HTTP 发送类型化命令,并消费一条归一化事件的 SSE 流。记录、密钥和事件保存在 ~/.openmausbot。详见项目概览。

一个具体流程:创建 bot、选择提供方和模型、在频道中给它任务,然后观察工具执行活动实时流入对话。命令、文件编辑和提问在执行前会通过权限代理以行内 Allow/Deny 卡片出现。可选的已连接应用(Composio)和云 Linux 桌面(Boat)扩展 bot 能触及的范围,两者都需要各自的凭据。

Bot 也能通过命令行使用:openmausbot 可驱动运行中的工作区,从文件应用团队、执行单个任务、等待它请求的队友完成并导出结果,支持 JSON 输出和可按脚本分支的退出码(无头 CLI 文档)。stdio MCP 服务器向外部客户端暴露一个有边界的控制面,不包含审批、删除、凭据和计算机生命周期(MCP 文档)。

要求与平台限制

  • 桌面构建: macOS(Apple 芯片与 Intel,已签名并公证)、Windows x64(安装包未签名,会触发 SmartScreen 提示)以及处于 beta 的 Ubuntu 24.04 x64,支持 GNOME(发布页)。
  • 从源码运行: 需要 Node 24+、pnpm,以及至少一个已安装并登录的 claude、codex 或 grok CLI,也可无代码配置任意支持 ACP 的 CLI 或 OpenAI 兼容端点。
  • 本地计算机控制: macOS 支持;Ubuntu Xorg 需显式选择启用;Ubuntu Wayland 因安全门槛暂时禁用。在 Wayland 上聊天、屏幕预览、云计算机和本地 VM 仍可用。
  • 可选付费服务: Composio 用于已连接应用,Boat 用于云桌面,均为第三方账户;Boat 试用后收费。托管语音需要 ElevenLabs、Fish Audio 或 xAI 密钥;Mac 内置语音和本地 Chatterbox 不需要。通话目前仅限 macOS。

还需注意:终端安装路径中的 API 密钥以明文(未加密)保存在私有 config.json 中。Webhook 触发器使用本地接收器,应用必须保持运行;公网投递需要中继或 funnel。应用事件触发器依赖内置的已连接应用方案,使用自有 Composio 密钥的服务器目前无法监听应用事件。

状态与许可

作者称项目尚处早期但流程已端到端可用,托管/移动端连接和常驻 webhook 中继仍在开发中。代码采用 Apache-2.0,但 enterprise/ 目录依据单独许可 source-available;删除该目录后即为开源版。HotRepo 于 2026-10-29 记录到 6,999 颗星和当天一次日榜记录,单一样本不足以说明趋势。

本文由 AI 根据项目 README 生成,更新于 2026年10月29日,以项目官方文档为准。

Hacker News 讨论