jaywedgeworth22/BotFleet

BotFleet

为每个 Bot 任选平台。
使用你的订阅 + API。

这是 OpenMausBot 的一个友好分支——在你自己的电脑上运行一支协同工作的 bot 团队，并配有 iPhone 伴侣应用。BotFleet 层的每一项附加功能都处于测试阶段。

botfleet.app  ·  TestFlight 上的 iPhone 伴侣应用（公开测试版）  ·  源代码  ·  上游 OpenMausBot

BotFleet 新增了什么

以下是本分支在 OpenMausBot 之上叠加的功能。它们全部处于测试阶段——它们在这支 bot 团队中日常使用，但还不是成品级的界面，仍可能发生变化。逐项功能的来源说明见 botfleet.app。

消息、伴侣应用与桌面端

- 常开 iMessage 中继——在中继运行期间，一个宿主守护进程加上 LaunchAgents 让 Messages.app 中的 bot 群聊与 BotFleet 后端保持双向联通。
- iOS 伴侣应用（公开 TestFlight）——配对、botfleet.app 上的通用链接、App Groups、话题标签页、未读实时活动，以及感知显示状态的对话记录窗口。伴侣应用打开时，提醒通过 SSE 加本地通知送达。当 Mac 端 sidecar 运行且手机允许通知时，被杀死或退到后台的应用会通过 APNs 被唤醒。iPad 仍以兼容模式运行。
- 频道下的嵌套对话——可重命名的任务话题位于其频道之下，可以移动、搜索和折叠，如果你愿意，还可以为“房间”自定义一个词。
- 聊天气泡与请求 ID 复制——点击气泡即可复制其文本；悬停和右键还可复制 Request ID 或 Message ID。
- macOS 菜单栏托盘——一个菜单栏附加项让 BotFleet 在窗口隐藏时仍可访问。
- 系统自动为默认——首次访问会跟随这台电脑的浅色或深色外观（浅色用 Studio，深色用 Midnight）。用户自动则跟随同一台电脑的外观，并使用你选择的浅色和深色主题。手动主题行仍然可用。代码围栏跟随所应用的主题，以保持可读性。
- 常开 harness 附加——桌面应用附加到已在运行的 BotFleet harness，而不是再 fork 出第二个。

引擎、故障转移与遥测

- 原生 DeepSeek 驱动——DeepSeek 模型通过原生驱动加上 dsh bot，与 Claude、Codex、Cursor、Grok、Gemini 和 Antigravity 并列，并带有应用内费率和 token 定价。
- Gemini 和 Antigravity 引擎——包括 Gemini 3.8 Flash、完整工具加载，以及在这些 harness 上选择加入后的本地计算机调度。
- 多层级模型回退 — 每个机器人都有第一、第二和第三选择模型。配额、用量上限和会话限制芯片会自动切换到已保存的链路，包括在工具已经运行之后以及在房间中。其他流式错误路径仍在审查中。
- 回合已用时间计时器 — 进行中的回合上有一个实时计时器，已完成的活动运行上也有持续时间。
- 用量遥测 — 实时 token 消耗（提示、补全、缓存命中）和模型成本会流式传输到你配置的 Usage Monitor 实例，并带有项目和仓库分类。工作目录分类仅使用文件夹的基名，绝不使用完整路径。
- 提供商标记和选择器过滤 — 为 Grok、Claude、DeepSeek、Gemini/Antigravity 等提供官方风格的标记；未配置的模型不会出现在选择器中。

舰队运维、记忆和自动化

- Fleet Recall — 机器人搜索并向共享记忆存储贡献内容，而不是使用私有的哈希代理索引。
- Fleet MCP 工具 — 列出并回答审批、open_app、例程、webhook、决策日志工具，以及面向外部 MCP 客户端的幂等发送。
- 多仓库频道和文件链接 — 一个频道可以附加多个仓库，并自动注入上下文。本地文件链接会在默认 Mac 应用中打开，或在 Option-点击时在 Finder 中显示。
- 资源阈值触发器 — 采样本地磁盘、RAM/swap，以及可选的 CPU 负载，并在超过阈值时入队一个与例程会入队的相同类型的任务。
- TryCloudflare、Tailscale 和自定义域名 — 可从设置中获取免费的 .trycloudflare.com URL，使用 Tailscale MagicDNS 进行手机链接，或使用 Cloudflare token 配置自定义域名。自定义 webhook 入口可以位于自己的域名上，并进行 token 验证。
- 任务中途崩溃和重启恢复 — 在启动时检测被中断的回合和进行中的工具执行，以便工作可以恢复，而不是卡住。
- 一条命令发布 TestFlight — 从 Mac 构建环境进行签名、归档和上传。

以上没有任何一项是“完成”的。请将它们视为测试清单。

来自 OpenMausBot

BotFleet 是 OpenMausBot 的友好分支，由 Milind Soni 和贡献者开发。

上游来源（特意突出显示）： https://github.com/milind-soni/OpenMausBot

当我们分叉时，该项目已经发布了这个仓库仍在运行的核心应用：

- 自带引擎 — 机器人运行在你机器上安装的 claude、codex 和 grok CLI 上（使用你的登录和订阅，中间没有代理），并可在设置 → 引擎中覆盖自定义二进制文件。Cursor 和 OpenCode 引擎已经内置。
- 本地优先的 harness — 127.0.0.1 上的一个小型服务器掌管每个机器人进程。转录、密钥和事件都保存在磁盘上，而不是供应商云中。
- 按机器人选择模型 — 一个提供商栏，默认项有标记，不可用的提供商会变暗并显示原因。可在对话中途切换机器人的模型。
- 每个机器人一台计算机 — 云 Linux 桌面（Box）、隔离的本地虚拟机，或在明确选择加入后使用本机，并带有实时屏幕预览和浏览器接管功能。
- 审批卡片 — shell 命令、文件编辑和问题以允许 / 拒绝 / 在聊天中回答的形式呈现。权限代理将高风险操作转化为由你做出的决策。
- 已连接的应用 — Composio 市场（Gmail、Slack、GitHub、Notion、Linear 以及数百个其他应用）。只需 OAuth 一次，每个机器人都可以将它们作为工具使用。
- 消息应用花名册 — 置顶、标记为未读、编辑资料、复制、复制会话 ID、隐藏、删除。机器人就像联系人一样。
- 密钥只需一次 — 在应用设置中粘贴凭据；它们会持久保存在本地，提供商集群会热重载。UI 只会看到“已配置”标志。
- 频道 — 工作、个人以及每个项目都在独立的频道中，无需克隆机器人。每个频道都有自己的记录、共享指令、工作文件夹、响应规则和花名册。
- 从一个 Markdown 文件导入团队 — 浏览以成果为导向的团队（BotMRR），审阅，然后创建机器人、幕僚长、频道、剧本、连接器清单和建议例程。也支持文件或 GitHub URL 导入。包从不携带凭据、对话、权限、记忆或计算机访问权限。
- 语音 — 对任何回复使用 ElevenLabs TTS，每个机器人独立语音，以及使用设备端听写的 macOS 通话模式。
- 流式工具运行芯片、从编辑器麦克风进行原生 macOS 听写、光标吉祥物，以及将机器人工作的截图折叠进记录中。
- MCP 控制平面 — 一个 stdio MCP 服务器，供 Claude Desktop / Cursor 检查机器人和频道、分页记录、创建工作、等待、切换模型和中断。它不暴露审批授权、删除、任意设置、凭据或计算机生命周期。
- 例程和 webhook — 一次性或工作日计划，以及位于 127.0.0.1:8800 的专用 webhook 接收器。
- 桌面外壳 — 打包的 macOS、Windows 和 Ubuntu 24.04 应用，带有嵌入式 harness。

有关当前上游项目，请参阅 OpenMausBot 仓库，其中包括此分支尚未拉取的后续更改。

快速开始

已发布的构建（最新）： harness 服务器已嵌入，因此无需单独设置服务器。桌面版本号与 iOS 一致（1.0.x）。此页面始终指向最新的打包资产，而不是固定的标签。

| | 下载 | 安装 |
|---|---|---|
| macOS（Apple 芯片） | BotFleet.dmg | 将其拖到“应用程序”中，然后打开。已使用 BotFleet Developer ID 签名。 |
| macOS（Intel） | BotFleet-intel.dmg | 相同的应用，为 Intel Mac 构建。 |
| Windows（x64） | 尚未发布 | Windows 安装程序由发布工作流构建，但尚未发布任何 Windows 版本。请关注发布页面，或从下方源码构建。 |
| Ubuntu 24.04（x64） | 尚未发布 | Ubuntu 软件包由发布工作流构建，但尚未发布任何 Ubuntu 版本。请参阅 Ubuntu 桌面指南从源码构建。 |

应用内检查更新会读取 GitHub 发布中的 latest-mac.yml 以及 macOS zip 文件。v0.1.38 仅发布了 DMG；1.0.31 是首个使用完整 feed 准备的桌面版本。

有关安装、功能和故障排除，请参阅 Ubuntu 桌面指南。

从源码构建：

git clone https://github.com/jaywedgeworth22/BotFleet && cd BotFleet
pnpm install

pnpm dev:server    # harness server → 127.0.0.1:8799
pnpm dev           # app → http://127.0.0.1:5199
pnpm dev:desktop   # Electron shell; keep the two commands above running

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

打包桌面应用程序：

pnpm package:mac      # macOS: DMG + ZIP; requires Swift/Xcode tools
pnpm package:win      # Windows: installer + ZIP
pnpm package:linux    # Ubuntu x64: .deb + AppImage + verified CUA runtime

桌面功能状态

| 功能 | macOS | Ubuntu 24.04 Xorg | Ubuntu 24.04 Wayland |
|---|---|---|---|
| 打包应用、嵌入式 harness、本地 bot CLI | 支持 | Beta | Beta |
| Composio 和 Box/云计算机 | 支持 | Beta | Beta |
| 仅预览的显式本地屏幕捕获 | 支持 | Beta | Beta |
| Bot 控制本计算机 | 支持 | Beta，需显式选择加入 | 已禁用：Wayland 安全门控 |
| 原生设备端听写 | 支持 | 计划中 | 计划中 |

Linux 预览由用户发起，且绝不会启用本地 bot 控制或自动路由。在 Xorg 上，经过审查的 Cua Driver 0.19.3 运行时仅在显式选择加入后启动，且不启用其全屏光标叠加层。在 Wayland 上，只要该真实席位安全门控仍未解决，应用就绝不会启动它，并会清除旧版的选择加入设置。聊天、预览、云和本地 VM 在两种会话中均保持可用。请参阅 Ubuntu 桌面指南以及跟踪问题 #29、#345 和 #113。
Linux 打包器在构建期间仅下载固定标签的上游归档文件，验证其大小、SHA-256、完整成员允许列表以及内部可执行文件哈希，然后仅打包 CLI 和光标主题附属文件。已安装的应用永远不会下载或自更新原生自动化代码。Cua 的 MIT 声明、Inter 的 SIL OFL、生成的第三方许可证报告以及 CycloneDX 清单随运行时一起分发。请参阅 third_party/cua-driver/ 获取经审核的来源记录。

这些凭据是可选的——本地聊天无需它们即可运行。当你想启用某项集成时，在 应用设置（侧边栏底部的齿轮图标）中粘贴一次密钥：

| 凭据 | 启用功能 | 获取位置 |
|---|---|---|
| Composio 项目密钥（ak_…） | 将 Gmail、GitHub、Slack、Notion 及其他应用连接到你的机器人 | BotFleet Composio 设置 |
| Box API 密钥 | 为机器人提供一台带桌面和终端的隔离远程 Linux 计算机 | Box API 密钥指南 |
| ElevenLabs 密钥 | 朗读回复，并呼叫你的机器人 | ElevenLabs API 密钥 |

Composio 和 Box 是第三方服务，拥有各自的账户和条款。Box 在试用期后是付费服务，使用云计算机可能会产生费用。

pnpm typecheck     # app + server
pnpm test          # unit, driver, API, and desktop capability tests
pnpm build         # typecheck + production build
pnpm check:electron # syntax-check Electron main/preload files
pnpm package:win   # Windows installer + zip → release/
pnpm package:linux # Ubuntu x64 .deb + AppImage → release/

例程、Webhook 和资源触发器

例程可以运行一次，也可以在选定的工作日运行，使用机器人配置的模型/计算机或 Cloud VM 运行器。Webhook 触发器独立于计划，但复用相同的排队任务执行器和日历回执。资源触发器在 BotFleet 运行时采样本地磁盘、RAM/交换空间以及可选的 CPU 负载，并在超过阈值时入队相同类型的任务。

BotFleet 默认在 127.0.0.1:8800（或 OMB_PORT 之上的一个端口）启动仅用于 Webhook 的接收器。设置 OMB_WEBHOOK_PORT 可选择其他端口。创建或轮换触发器时会显示一次 Webhook 密钥。建议使用 Bearer 身份验证，这样密钥就不会出现在请求 URL 和大多数访问日志中；对于无法配置标头的发送方，仍可使用单一能力 URL。该接收器仅暴露 /health 和密钥 /hooks/... 端点；它绝不会暴露应用更广泛的 API。BotFleet 必须保持运行才能接受投递。对于公共互联网投递和移动应用访问，BotFleet 在设置中提供 TryCloudflare（免费 URL） 集成。

远程访问、移动应用和 Webhook

要在 BotFleet 应用于你的 Mac 上运行时连接 BotFleet iOS 应用或接收公共互联网 Webhook，你有三种选择：
1. TryCloudflare（免费 URL）（推荐用于 webhook）：BotFleet 可以启动一个 Cloudflare Tunnel 并为你提供一个 .trycloudflare.com URL。在设置中开启即可。无需 Cloudflare 账户或自定义域名。
2. Tailscale：对于无需公共 webhook 的手机连接，Tailscale 通过 MagicDNS 开箱即用。
3. 自定义域名：自带 Cloudflare API token，通过自定义域名路由流量（Cloudflare Zero Trust 加 DNS）。

有关 stdio 控制平面，请参阅 MCP 服务器设置与工具参考。

状态

尚处早期但已可用——整个循环端到端跑通：消息 → 机器人 → 流式回复 → 工具 → 审批 → 计算机使用。macOS 有主要的已发布构建；Windows 和 Ubuntu 包由 CI 生成，但尚未发布。Ubuntu 仍为 beta，存在上述能力限制。托管/移动端连接仍在构建中。语音需要 ElevenLabs 密钥，且通话目前仅限 macOS（它们与编辑器麦克风使用相同的设备端听写）——参见 docs/voice-mode.md。

上面列出的每个 BotFleet 层附加组件都在测试中。

欢迎贡献——server/contracts.ts 中的驱动 SPI 刻意保持精简；添加一个提供方只需在 server/drivers/ 中增加一个文件，再加一行注册代码。

许可证

Apache License 2.0 © 2026 Milind Soni 和 BotFleet 贡献者。

打包的 Cua Driver 组件保留其上游 MIT、SIL OFL 1.1、MPL-2.0 及其他依赖条款；相应的声明、许可证文本、源代码位置和 SBOM 位于 third_party/cua-driver/，并随原生运行时一同分发。

BotFleet 是一个受 Grok Bot 启发的独立开源项目。它与 xAI 无关联、未获其认可，也不与其相关；“Grok”是其各自所有者的商标。