OpenMausBot开发者指南如何用一个新文件接入你自己的AI引擎与MCP工具服务器【免费下载链接】OpenMausBotOpen Source Alternative to Grok Bot with a virtual machine that bots can use项目地址: https://gitcode.com/gh_mirrors/op/OpenMausBotOpenMausBot 是一款开源的 AI 机器人聊天应用Grok Bot 的开源替代方案每个聊天对象都是一个真实运行的 AI Agent。它最强大的设计之一是扩展性接入你自己的 AI 引擎最多只需一个新文件接入 MCP 工具服务器则完全不需要写代码。本指南带你从零理解 OpenMausBot 的驱动架构并给出具体的接入路径。为什么 OpenMausBot 支持自定义 AI 引擎OpenMausBot 的架构是「本地优先」的应用本身不内置任何模型传输层而是由一个本地 harness 服务器127.0.0.1:8799统一管理所有 Agent 进程把各家供应商的原生协议归一化为一条标准运行时事件流。这意味着接入新引擎的核心只有一件事实现一个驱动Driver把私有协议翻译成标准事件。驱动之间互不影响——一个未知或损坏的驱动只会显示为「不可用」永远不会拖垮整个机器人团队见 server/harness/registry.ts 中「shadow snapshot」降级机制。两条接入路径先无代码再写文件OpenMausBot 官方文档明确了两个层次建议按顺序尝试路径一零代码接入已有引擎推荐新手如果你的 AI 引擎属于以下两种形态之一改一个配置文件就够了详见 docs/custom-engines.md任何 ACP 协议的 Agent CLI在~/.openmausbot/config.json的instances下添加一条customAcp实例把config.cli指向你的命令行即可模型选择交给 Agent 自己。任何 OpenAI 兼容端点vLLM、LM Studio、Ollama 或任意托管 API只需一条openai-compat实例记录填入url和模型名。配置完成后重启应用新引擎就会出现在Settings → Engines页面。路径二写一个新文件注册一个全新引擎当你的引擎协议不在上述两种之内比如私有 API 协议就需要写驱动了。OpenMausBot 的驱动 SPI服务接入点刻意设计得非常小核心契约定义在 server/contracts.ts 中新建一个文件例如server/drivers/myengine.ts。可以直接参考最简洁的现成实现 server/drivers/minimax.ts——它仅包含driverKind与显示元数据名称、是否支持多实例models模型目录默认模型 选项列表decodeConfig解析你的配置段create()创建实例复用现成的createOpenAIChatRuntime()等运行时工厂一行注册在 server/drivers/builtIn.ts 的BUILT_IN_DRIVERS数组中追加你的驱动。这就是全部。README 原话是「Adding a provider is one file inserver/drivers/plus a one-line registration添加一个供应商 drivers 目录里的一个文件 一行注册」。驱动实例化由 server/harness/registry.ts 中的注册表完成它读取配置、调用decodeConfig与create任何失败都自动降级为带原因说明的「不可用」状态。接入你自己的 MCP 工具服务器零代码如果你只是想给机器人加工具搜索、数据库、内部系统OpenMausBot 提供了完全无代码的 MCP 接入完整说明见 docs/custom-mcp-servers.md服务器类型配置方式说明本地 stdio 服务器填命令 参数 环境变量应用自动启动进程并完成 MCP 握手远程 HTTP 服务器填 URL Authorization 头默认 Streamable HTTP旧服务器可选 SSE操作路径Plugins → MCP servers → Add server点Test验证握手并预览它提供的工具然后开启即可。支持直接粘贴 Claude Code / Cursor / Claude Desktop 格式的mcpServersJSON 批量导入。安全设计值得新手了解️ 自定义 MCP 服务器永不预授权其工具调用会走审批卡片流程保留名称computer、browser等被拒绝防止自定义服务器覆盖内置工具凭据只进环境变量或请求头不出现在进程参数中一条坏配置只会被跳过不影响其他服务器不同引擎能访问哪些 MCP 服务器也有明确规则stdio 全支持URL 服务器视引擎协议而定详见 docs/custom-mcp-servers.md 中的兼容性矩阵。关键文件清单动手前先看这里文件作用server/contracts.ts驱动 SPI 契约ProviderDriver、ProviderInstance、ModelCatalogserver/drivers/builtIn.ts内置驱动注册表追加一行的位置server/drivers/minimax.ts最简的完整驱动示例API 类引擎server/harness/registry.ts实例注册表与降级机制server/config.tsconfig.json中instances与mcpServers的解析逻辑docs/custom-engines.md零代码引擎接入文档docs/custom-mcp-servers.md零代码 MCP 接入文档常见问题Q写错驱动或配置会导致应用崩溃吗不会。配置错误只会让该实例显示为「不可用」并附带原因其余机器人团队照常加载。Q新接入的引擎能使用审批卡片和审批模式吗可以。审批走标准的sendTurn/respondToRequest契约与内置引擎行为一致。QAPI 类引擎能挂载工具和图片输入吗支持结构化工具和图片输入的引擎如 OpenAI 兼容端点可以挂载浏览器、本地 VM 等工具并把截图返回给模型。Q接入后需要重启应用吗修改config.json引擎实例需要重启MCP 服务器通过界面添加后无需重启下一个任务即可使用。小结OpenMausBot 的扩展模型非常清晰——MCP 工具服务器零代码配置、标准协议引擎一条配置、私有协议引擎一个新文件 一行注册。从 server/contracts.ts 读起你会发现「给自己写一个 AI 引擎驱动」远比想象中简单。【免费下载链接】OpenMausBotOpen Source Alternative to Grok Bot with a virtual machine that bots can use项目地址: https://gitcode.com/gh_mirrors/op/OpenMausBot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考