企业官网建设流程全解析

5分钟上手OpenMausBot：Mac、Windows、Ubuntu三平台安装完全指南

【免费下载链接】OpenMausBotOpen Source Alternative to Grok Bot with a virtual machine that bots can use项目地址: https://gitcode.com/gh_mirrors/op/OpenMausBot

OpenMausBot 是一款开源的 Grok Bot 替代品，让你把 Claude、Codex、Grok 等 AI 智能体变成聊天软件里"能对话的联系人"。本文是一份完整的OpenMausBot 安装指南，覆盖 Mac、Windows、Ubuntu 三大平台的安装步骤，零基础也能 5 分钟装好并创建第一个机器人。

一、OpenMausBot 是什么？

一句话概括：一个把 AI 机器人当联系人管理的聊天应用。侧边栏里的每个 Bot 背后都是一个真实运行在本地的 Agent 进程——有自己的性格、自己的模型、自己的云电脑和连接应用。你可以像发消息一样给它们派活，看它们工作，并对敏感操作逐项审批。

它采用本地优先（local-first）设计：所有对话记录、密钥和事件都保存在本机~/.openmausbot，不经过任何第三方云。

二、安装前准备清单

三个平台通用的前置条件：

💡 官方发布版已内嵌 harness 服务器，下载即装，不需要单独配服务器。源码与需求细节见 README.md。

三、Mac 一键安装步骤

1. 前往最新 Release，按芯片下载：Apple 芯片选OpenMausBot.dmg，Intel 选OpenMausBot-intel.dmg。
2. 打开 dmg，把应用拖入 Applications 文件夹。
3. 双击启动即可。两个版本均已签名并完成公证，Gatekeeper 不会拦截。

四、Windows 安装与 SmartScreen 处理

1. 下载OpenMausBot-setup.exe（x64 安装包）。
2. 直接运行——一键安装、按用户安装、无需管理员权限。
3. 安装程序暂未做代码签名，Windows SmartScreen 会提示"未知发布者"，点更多信息 → 仍要运行即可。

五、Ubuntu 用 APT 安装 .deb 包

Ubuntu 目前为 Beta 状态，GNOME 桌面为支持环境，推荐.deb包：

sudo apt install ./OpenMausBot-amd64.deb

之后在 GNOME 应用启动器中打开OpenMausBot即可；卸载用sudo apt remove openmausbot。

如果你更喜欢免安装，可用 AppImage：

chmod +x OpenMausBot.AppImage ./OpenMausBot.AppImage

⚠️ 注意两点：

• .deb会自动配置机器人自带浏览器的 AppArmor 沙箱；AppImage 在受限系统上可能报No usable sandbox，此时请改用.deb。
• 本地电脑控制仅在 Xorg 会话下可显式开启；Wayland 下该功能保持关闭（安全门未解除），聊天、预览、云电脑、本地 VM 均不受影响。

完整能力矩阵与排错见 Ubuntu 桌面指南。

六、进阶：从源码或命令行运行

源码开发（需要 Node 24+ 与 pnpm）：

git clone https://gitcode.com/gh_mirrors/op/OpenMausBot && cd OpenMausBot pnpm install pnpm dev:server # harness 服务器 → 127.0.0.1:8799 pnpm dev # 网页应用 → http://127.0.0.1:5199 pnpm dev:desktop # Electron 外壳（上面两条需保持运行）

无桌面环境 / 服务器场景：装 Node 24+ 后一条命令即可，首次启动会用方向键引导你选 AI 接入方式、粘贴密钥、选模型：

npm install -g openmausbot openmausbot

终端版完整引导流程见 终端配置指南，VPS 长期部署参考 自托管文档。

七、首次启动：三步创建第一个机器人

1. 欢迎页：填上你的名字（可跳过）。
2. 引擎检测：OpenMausBot 自动扫描本机已安装的 AI 引擎（Claude、Codex、Grok 等），"Ready" 状态的立即可用。
3. 创建 Bot：它会问你"主要想让它帮你做什么"，选一个方向或自定义回答，机器人随即开始自我介绍。

如何给机器人换模型

点右上角的模型选择器，按提供商（Claude / Codex 等）分组列出可用模型，对话中途随时可切换：

八、装完必看的 4 个核心功能

这些密钥都是可选的——本地聊天在没有任何云密钥的情况下完全可用。

九、常见问题速答

• 需要花钱 / 有密钥才能用吗？不需要。装好claude、codex或grokCLI 并登录，本地聊天即刻可用。
• 数据存哪里？全部在本机~/.openmausbot，不上传云端。
• Ubuntu Wayland 能用什么？聊天、云电脑、本地 VM、只读屏幕预览均可；"机器人控制本机"暂不可用。
• 手机能连吗？支持通过 Tailscale / 托管 HTTPS 端点配对，见 桌面伴侣文档。

十、延伸资料

• 安装与快速开始：README.md
• Ubuntu 桌面详解：docs/linux-desktop.md
• 终端/首次配置向导：docs/cli-onboarding.md
• 自托管与 VPS 部署：docs/self-hosting.md
• 自定义引擎接入：docs/custom-engines.md
• Agent 驱动源码：server/drivers/
• 桌面外壳代码：electron/

装好之后，侧边栏里那个会干活的 AI 联系人，就是你自己的团队了 🚀

【免费下载链接】OpenMausBotOpen Source Alternative to Grok Bot with a virtual machine that bots can use项目地址: https://gitcode.com/gh_mirrors/op/OpenMausBot