源码系统概览
文章正文
OpenMausBot 是一款本地优先的开源 AI 智能体聊天应用。
它把每一个聊天对象都变成一个真实可运行的 AI 智能体，支持在桌面端、命令行以及自建服务器上运行。
该项目由 Milind Soni 维护，采用 Apache-2.0 协议开放源代码，在 GitHub 上已收获约 3600 个 Star。
源码简介
OpenMausBot 的定位是 Grok Bot 的开源替代方案，但项目方明确声明与 xAI 没有任何关联。
它采用本地优先的架构，所有数据默认保存在用户本机，用户也可以把它部署到自己的服务器上长期运行。
应用内置一个 harness 服务端，负责协调各类 Agent CLI 与前端界面之间的通信。
前端使用 React 19 配合 Vite 与 Tailwind CSS 构建，桌面壳则由 Electron 封装，覆盖 macOS、Windows 与 Ubuntu。
用户可以在同一个会话里创建多个机器人，让它们彼此协作、定时执行任务，并通过审批卡片来控制敏感操作。
整个项目以 TypeScript 编写，工程结构清晰，适合有一定前端基础的开发者二次开发与学习。
适用场景
个人用户可以用它在本地搭建一个私有的 AI 助理工作台，把日常对话、资料整理和自动化任务都交给智能体。
团队用户可以在 VPS 上自建服务器，让成员通过浏览器、桌面端或手机协同使用同一批机器人。
开发者可以把它作为 AI Agent 编排与多端同步的参考实现，研究本地优先架构与安全模型。
需要把 AI 能力接入 Gmail、GitHub、Slack 等第三方应用的用户，也可以借助内置的 Composio 连接器快速打通。
对隐私敏感、希望数据不出本机的用户，本地优先与端到端自托管特性尤其合适。
功能亮点
每个聊天都是一个真实运行的 AI 智能体，支持 Claude、Codex、Grok 以及任意 OpenAI 兼容端点。
内置模型选择面板，左侧是供应商导航，右侧可直接切换不同模型，无需改动代码。
提供电脑操控能力，机器人可以在云端或容器里的独立桌面上执行任务并实时预览屏幕。
对话中内置审批卡片与提问卡片，敏感工具调用必须经过用户确认，降低误操作风险。
支持 Composio 市场，可一键连接 500 多个第三方应用，扩展机器人的能力边界。
机器人上下文菜单让用户方便地查看资料、导出内容或切换身份。
应用设置页集中管理 API 密钥、远程访问与引擎接入，配置过程清晰直观。
相较于 xAI 的 Grok Bot，OpenMausBot 以开源协议与本地优先作为核心差异。
下表从几个维度对两者做中性对比，帮助读者判断哪一类产品更契合自己的需求。
| 对比维度 | OpenMausBot | Grok Bot（xAI） |
|---|---|---|
| 开源协议 | Apache-2.0 开源 | 商业闭源 |
| 部署方式 | 本地优先，可自托管 | 云端服务 |
| 客户端 | Electron 桌面、CLI 与网页 | xAI 官方客户端 |
| 支持引擎 | Claude、Codex、Grok 与兼容端点 | Grok 模型 |
技术架构与部署指南
技术栈与运行环境
前端：React 19 + Vite + Tailwind CSS
后端：Node.js 24 + TypeScript，harness server 监听 127.0.0.1:8799
数据库：SQLite，应用数据存放于 ~/.openmausbot
运行环境：Node 24+、pnpm 10.33.0、Electron 桌面壳，支持 macOS、Windows、Ubuntu 24.04 x64
其他依赖：Claude Code、Codex、Grok 任一 Agent CLI，可选 Composio、Box、ElevenLabs 等
安装与部署提示
下面分四种方式详细说明 OpenMausBot 的安装与部署，你可以按自己的使用场景选择最合适的一种。
方式一：下载官方发布版（最简单，仅桌面端）
如果你只想在电脑上用桌面应用，直接到项目的 Releases 页面下载对应系统的安装包即可。
macOS Apple 芯片用户下载 OpenMausBot.dmg，拖入应用程序文件夹后打开，安装包已签名并公证。
Intel 芯片 Mac 用户选择 OpenMausBot-intel.dmg，安装方式完全相同。
Windows x64 用户下载 OpenMausBot-setup.exe，双击运行即可完成安装，无需管理员权限。
Windows 安装包暂未代码签名，SmartScreen 可能提示未知发布者，点击更多信息再选择仍要运行即可。
Ubuntu 24.04 用户下载 OpenMausBot-amd64.deb 用 APT 安装，或下载 AppImage 赋予可执行权限后直接运行。
首次启动会引导你选择 AI 接入方式、登录或粘贴 API 密钥，并挑选默认模型，整个过程用方向键即可完成。
方式二：从源码运行（适合开发或二次开发）
从源码运行需要先准备 Node 24 与 pnpm 环境，并至少安装并登录一个 Agent CLI。
打开终端执行 git clone https://github.com/milind-soni/OpenMausBot 然后进入目录。
执行 pnpm install 安装全部依赖，这一步会拉取前端与后端所需的全部包。
启动 harness 服务端：执行 pnpm dev:server，此时服务监听在 127.0.0.1:8799。
启动前端开发服务：另开一个终端执行 pnpm dev，浏览器访问 http://127.0.0.1:5199。
再执行 pnpm dev:desktop 拉起 Electron 桌面壳，前两个命令需要保持运行。
如需打包桌面应用，macOS 用 pnpm package:mac，Windows 用 pnpm package:win，Ubuntu 用 pnpm package:linux。
打包前请确保本机已安装对应平台的构建工具，例如 macOS 需要 Xcode 命令行工具。
方式三：命令行一键运行（轻量，无桌面）
在已安装 Node 24 的机器上，可以免全局安装直接用 npx 启动：执行 npx openmausbot 即可。
如需全局安装，执行 npm install -g openmausbot 后再运行 openmausbot 命令。
首次启动会引导你选择 AI 接入、登录或粘贴密钥、选择模型，并可选择是否连接手机。
之后再次执行同一命令会复用已保存的配置，并在本机打开 OpenMausBot 界面。
想在不重新初始化机器人或对话的前提下修改配置，可执行 openmausbot setup。
保持终端打开，Ctrl-C 只会停止服务，不会删除你已保存的数据。
方式四：VPS 自建服务器（长期在线，可远程访问）
在 VPS 上自建服务器有三条可达路径，任选其一即可，其余配置完全相同。
路径 A 最简单：无需域名和开放端口，执行 npx openmausbot setup 连接 AI，再 npx openmausbot login 用邮件验证码认领地址，最后 npx openmausbot serve –tunnel 启动并通过 Cloudflare 隧道暴露 HTTPS 地址。
路径 B 用自己的域名：服务器安装 Docker 后，克隆仓库进入 deploy 目录，复制 .env.example 为 .env 并填写 DOMAIN 与 ENGINES，再执行 docker compose pull omb 与 docker compose up -d 即可。
路径 C 仅用 Tailscale：在服务器与设备上都装好 Tailscale 后，执行 npx openmausbot serve –tailscale，只有你的 tailnet 内设备可以访问。
无论哪种路径，服务器都只监听回环地址 127.0.0.1:8799，外部访问必须经过隧道、Caddy 或 Tailscale，切勿直接把该端口暴露到公网。
引擎接入（Claude、Codex、Grok）
OpenMausBot 本身不内置模型引擎，需要你自行安装并登录对应的 Agent CLI。
Claude 用户执行 npm install –global –prefix “$HOME/.local” @anthropic-ai/claude-code 后把 ~/.local/bin 加入 PATH，再运行 claude 完成登录。
Codex 用户使用 @openai/codex 包，并执行 codex login –device-auth 在无界面服务器上完成设备码登录。
Grok 用户安装 grok CLI 后按提示登录即可，也可以在设置里添加任意 OpenAI 兼容端点。
也可以在应用设置页的 Engines 中直接安装与登录引擎，无需手动敲命令。
升级、备份与多设备
通过 systemd 长期运行时，升级只需停止服务、用 npm 安装指定版本再启动即可。
Docker 路径升级执行 docker compose pull omb 与 docker compose up -d 一条命令完成。
备份前请先停止服务，再把 ~/.openmausbot 目录打包，其中保存了机器人、对话、定时任务与配对会话。
每台设备只需用配对码或配对链接配对一次，之后长期保持登录，无需重复配置。
截图与演示说明
下面的官方截图展示了 OpenMausBot 几个关键界面的实际样子，帮助你在安装前建立直观印象。
主界面采用类 Telegram 的会话布局，每一个聊天对象都是一个真实运行的 AI 智能体。
模型选择面板左侧是供应商导航栏，右侧列出当前账号可以切换的模型。
电脑操控面板带有实时屏幕预览，机器人可以在独立桌面上执行任务。
对话中的审批卡片与提问卡片，让敏感的工具调用必须先经过用户确认。
已连接应用市场集中展示了 Composio 等可一键接入的第三方服务。
机器人上下文菜单方便查看资料、导出内容或切换身份。
应用设置页集中管理 API 密钥、远程访问与引擎接入，配置入口清晰。
常见问题
问：OpenMausBot 是什么？
它是一款本地优先的开源 AI 智能体聊天应用，每个聊天对象都是一个真实运行的智能体，可在桌面端、命令行和自建服务器上使用。
问：它是免费的吗？
是的，项目以 Apache-2.0 协议开源免费，你可以免费下载源码、自行部署和使用；只有调用第三方模型时才会产生模型供应商的费用。
问：和普通聊天工具有什么区别？
普通工具通常只对接单一模型，而 OpenMausBot 让每个聊天都是一个可独立配置、彼此协作并支持审批控制的智能体。
问：安装需要什么基础环境？
桌面版直接下载安装包即可；从源码或命令行运行需要 Node 24 及以上、pnpm，以及至少一个已登录的 Agent CLI。
问：数据保存在哪里？
本地模式下数据默认保存在本机 ~/.openmausbot 目录，采用 SQLite 存储，不会强制上传到云端。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
需要提醒的是，OpenMausBot 的服务端默认信任本机回环地址，任何能访问 127.0.0.1:8799 的进程都拥有较高控制权。
因此在自建服务器时，切勿将 8799 端口直接绑定到公网，应统一通过隧道、Caddy 或 Tailscale 等经过认证的通道访问。
多人共用一台服务器时，建议配置邮件登录白名单或开启 service 信任模式，避免成员越权操作。
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
本项目为 Apache-2.0 开源协议，你可以免费获取源码并自托管部署，但调用第三方模型会产生对应供应商的费用。
使用过程中请注意保管好本地保存的 API 密钥与引擎登录凭证，避免泄露造成损失。
GitHub项目开源地址：https://github.com/milind-soni/OpenMausBot
最后更新：2026-09-27