OpenMausBot自带Agent指南：如何用已有的Claude、Codex、Grok订阅驱动你的AI Bot
【免费下载链接】OpenMausBotOpen-source Grok Bot alternative with a virtual machine that bots can use项目地址: https://gitcode.com/GitHub_Trending/op/OpenMausBot
OpenMausBot 是一款开源的 AI 聊天机器人应用，它的核心卖点是自带 Agent（bring-your-own-agent）：不需要重新注册账号或走 API 计费，直接调用你电脑上已登录的 Claude、Codex、Grok CLI，用你现有的订阅来驱动每一个 AI Bot。消息全部由本地 harness 服务器在127.0.0.1上调度，没有中间代理，隐私和账单都留在你自己手里。
它凭什么能用你的订阅驱动 AI Bot？
原理很简单，三步链路：
- 你在终端里登录好官方 CLI（Claude Code、Codex、Grok），登录态保存在你本机的凭据目录中；
- OpenMausBot 启动时自动扫描常见安装目录和登录 shell，检测 CLI 是否安装、是否已登录（见 apps/docs/content/docs/providers/index.mdx）；
- 每当你给 Bot 发消息，本地服务器就拉起对应 CLI 子进程，把输出统一归一化到聊天界面。
关键点：你的订阅归属不变。OpenMausBot 不会把 A 家的订阅变成 B 家的访问权，也不做代理转发——官方文档在 apps/docs/content/docs/providers/index.mdx 中明确说明，访问与计费完全由你原来的 CLI 登录决定。
三大引擎接入：最快配置方法
1️⃣ 接入 Claude（用现有 Claude 订阅）
npm install -g @anthropic-ai/claude-code在终端里按提示完成浏览器登录后，重启 OpenMausBot 即可。Claude 的驱动代码在 server/drivers/claude.ts，工具调用、审批卡片、会话和本地电脑操作的支持最完整。
💡小技巧：多 Claude 账号——打开Settings → Engines → Add Claude account，给账号命名为 Work 或 Personal，复制登录命令在宿主机执行后点Check account。之后在模型选择器里为每个 Bot 指定不同账号，聊天头部会显示当前账号名，互不串号（详见 apps/docs/content/docs/providers/index.mdx）。
2️⃣ 接入 Codex（用现有 ChatGPT/Codex 订阅）
npm install -g @openai/codexCodex 的模型列表来自已登录 CLI 的实时模型清单，读不到时才显示离线兜底模型。如果检测到有更新的稳定版 Codex CLI，界面会主动提示更新命令——注意更新 CLI 不等于解锁新模型，模型可用性仍取决于你的账号（见 server/drivers/codex.ts）。
3️⃣ 接入 Grok
内置 Grok 引擎走 xAI 的 OpenAI 兼容协议，模型包括 Grok 4.7、Grok 4 Fast 等，实现见 server/drivers/grok.ts。如果你用的是 Grok CLI（Agent 形态，基于 ACP 协议），驱动在 server/drivers/acp/grok.ts，未登录时会直接提示grok login，按提示在终端登录一次即可。
所有引擎统一注册在 server/drivers/builtIn.ts，这就是"自带 Agent"架构的落点：写一个驱动文件、追加一行，就能接入新引擎。
模型选择器：每个 Bot 都能换大脑
模型选择器按供应商分组（provider rail），默认模型有标记，不可用的供应商会被置灰并显示原因（比如"未登录"或"CLI 未安装"）。支持的引擎还能从已装 CLI 刷新模型目录。切模型只影响后续对话，不会改写历史；每个 Bot 各自保留自己的引擎与模型选择，一个 Bot 用 Claude、另一个用 Codex 完全没问题。
检测不到 CLI？在 Engines 设置里手动指定路径
如果你用了版本管理器、wrapper 或自定义编译，自动检测可能失败。打开Settings → Engines，直接为对应引擎设置可执行文件路径即可，这对 Windows 非标准路径安装也是同样方案；自定义 CLI 二进制还可以为实例指定 Provider 图标（xAI、OpenAI、Anthropic 等内置可选，也可上传自定义图片）。
API 密钥类连接则粘贴在App Settings，密钥只写一次、本地持久化，UI 永远只看到"已配置"标记，不会回显密钥明文。
进阶：自定义引擎与 OpenAI 兼容端点
想在 OpenMausBot 里跑官方没自带的引擎？docs/custom-engines.md 给出两条零代码路径：
- 任意 ACP Agent：
customAcp实例指向任意能讲 ACP 协议的 CLI（config.cli写完整命令），先手动登录，模型选择留在 Agent 内部； - 任意 OpenAI 兼容端点：本地 vLLM、Ollama、LM Studio 或任何托管 API，一个
openai-compat实例搞定，支持结构化工具和图像输入。
配置写在~/.openmausbot/config.json的instances字段下，改完重启应用生效；写错也不会弄崩应用，该实例只会显示"不可用 + 原因"，其余引擎照常工作。
上手清单
| 步骤 | 操作 | 位置 |
|---|---|---|
| 1 | 安装并登录至少一个 CLI（claude / codex / grok） | 终端 |
| 2 | 重启应用，等待引擎检测完成 | 自动 |
| 3 | 检测失败时手动指定可执行路径 | Settings → Engines |
| 4 | 为 Bot 挑选引擎与模型 | Bot 模型选择器 |
| 5 | 可选：多 Claude 账号、自定义引擎 | Engines / config.json |
命令行方式运行 OpenMausBot 的完整流程（首次启动向导、模型选择、可选手机配对）参见 docs/cli-onboarding.md。
一句话总结：订阅是你的，Bot 是开源的——OpenMausBot 只负责把已登录的 Claude、Codex、Grok 变成一群有独立人格、独立模型、还能动手干活的 AI 同事。
【免费下载链接】OpenMausBotOpen-source Grok Bot alternative with a virtual machine that bots can use项目地址: https://gitcode.com/GitHub_Trending/op/OpenMausBot
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
