botmux 文档
  • 简体中文

      • 多 CLI 适配器

      botmux 通过适配器桥接不同 CLI，bots.json 里用 cliId 选择。一键切换，进程隔离。

      支持的 CLI

      cliIdCLI支持 model 参数
      claude-codeClaude Code（默认）✅
      codexCodex✅
      codex-appCodex App
      cursorCursor（cursor-agent）✅
      geminiGemini✅
      opencodeOpenCode✅
      cocoCoCo / Trae（需 ≥ 0.120.32）✅
      aidenAiden
      antigravityAntigravity（agy）
      hermesHermes
      copilotGitHub Copilot（copilot）✅

      还有社区贡献的 MTR、ttadk、Mira 等接入方式。model 字段只对支持模型参数的适配器生效，其它会忽略。

      Mir CLI 与 MCP Bridge

      botmux setup 里选择 Mira -> Mir CLI（本地 mircli） 后，机器人配置会使用 cliId: "mir"。这个适配器通过本机 mircli -p --lean 执行，因此需要运行 botmux daemon 的同一系统用户已经完成 Mir CLI 登录和初始化。

      BotMux 不需要额外的 DevBox 专属配置；在 DevBox、本地 macOS 或其它 Linux 机器上规则相同：

      • mircli 能被 botmux 找到，或在机器人配置里用 cliPathOverride 指向 mircli 的绝对路径。
      • ~/.mira/config.json 里已有 device_id。首次使用 Mir CLI 时通常通过 mircli mcp --device-id <id> 或 Mir CLI 自身初始化流程写入。
      • miramcp 已安装在 Mir CLI 的标准位置（例如 ~/.local/bin/miramcp、~/.local/bin/mira_cli），或通过 MIRAMCP_BIN 指向可执行文件。

      当 cliId: "mir" 会话启动并收到消息时，BotMux 会在调用 mircli 前 best-effort 拉起 MCP Bridge：

      miramcp run --device-id <device_id>

      它会先检查 ~/.mira/miramcp/miramcp.pid 和本机 9801 端口，已在运行就不会重复启动。要确认状态，可以在运行 botmux daemon 的同一用户下执行：

      mircli mcp status

      如果你想禁用这个自动拉起行为，可以任选一种方式：

      {"auto_start_bridge": false}

      或只对 BotMux 进程禁用：

      MIRCLI_AUTO_START_MIRAMCP=0 botmux start

      套 wrapper / 网关接入

      很多场景下你不是直接跑原生 CLI，而是套一层网关 / 路由（内网代理 + SSO、模型路由等），比如 ccr、ttadk、aiden x claude、aiden x codex。这时不需要新适配器：cliId 仍填底层真实 CLI（claude-code / codex …），只把启动入口换成一个 wrapper 脚本，用 cliPathOverride 指过去（botmux setup 编辑机器人时的「CLI 可执行文件路径覆盖」就是填它）。

      通用四步：

      1. 先登录网关（一次性）：用跑 daemon 的同一系统用户完成 SSO 登录，token 缓存在该用户家目录。token 过期会弹交互登录卡住 PTY，注意保持登录态。
      2. 写 wrapper 脚本 放 ~/.botmux/bin/，把 botmux 传入的参数透传给真实 CLI（注意：有的网关拒收 botmux 注入的 --settings，要在脚本里剥掉）。
      3. chmod +x 加可执行位（最容易漏！）——botmux 用 node-pty 直接 exec 脚本，没有可执行位会 EACCES、CLI 起来即退、bot 崩溃重启。
      4. 直接执行脚本验证（用 ~/.botmux/bin/xxx --version，别用 bash xxx 测——走 bash 不需要可执行位会掩盖第 3 步问题）。然后在 bots.json 配 cliPathOverride（写绝对路径，别用 ~），botmux restart 生效。

      各网关的具体 wrapper 脚本通常随上游更新，请以对应 CLI / 网关团队发布的文档为准；这里不在公开仓库内放内部文档链接或复制原文。

      • aiden × claude / aiden × codex — aiden×codex 需用 script 强套 PTY
      • ttadk — 配置时注意 wrapper 参数透传和登录态
      • MTR — 社区贡献，npm i -g @metamove-code/mtr-cli@latest

      排查 wrapper 问题的通用手法：botmux logs 找 Spawning fresh CLI: 那行，复制完整命令在本地手动跑一遍即可定位（权限 / 参数黑名单 / 登录态）。

      添加新适配器（贡献者）

      1. src/adapters/cli/ 下新建文件，实现 CliAdapter 接口
      2. src/adapters/cli/types.ts 的 CliId 联合类型加新 ID
      3. src/adapters/cli/registry.ts 加 import / switch case / export
      4. src/worker.ts 的 CLI_DISPLAY_NAMES、card-builder.ts 的 cliDisplayNames 加显示名
      5. src/cli.ts setup 交互菜单加选项
      6. 更新 README

      详见 CONTRIBUTING.md。