#bots.json 配置

通过 ~/.botmux/bots.json 配置机器人。运行 botmux setup 交互式创建，或手动编辑。文件是一个数组，每个元素是一个 bot（生产环境一个 bot 对应一个独立 daemon 进程）。

[
  {
    "larkAppId": "cli_xxx_bot1",
    "larkAppSecret": "secret_1",
    "name": "claude-main",
    "cliId": "claude-code",
    "model": "sonnet",
    "lang": "zh",
    "workingDir": "~/projects",
    "allowedUsers": ["alice@company.com"],
    "allowedChatGroups": ["oc_xxx_team"],
    "oncallChats": [{ "chatId": "oc_xxx_oncall", "workingDir": "~/projects/foo" }]
  },
  {
    "larkAppId": "cli_xxx_bot2",
    "larkAppSecret": "secret_2",
    "cliId": "codex",
    "model": "gpt-5-codex",
    "workingDir": "~/work",
    "autoStartOnNewTopic": true
  }
]

字段较多，按用途分组列出，绝大多数都是可选的——只填 larkAppId / larkAppSecret 就能跑起来，其余按需增配。

#必填

#CLI 与模型

#接入 GLM / 第三方服务商（per-bot env）

让某个 bot 跑 GLM Coding Plan（或其它 Anthropic 兼容服务商），另一个 bot 仍跑官方 Claude——给前者配 env：

{
  "cliId": "claude-code",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的 GLM Coding Plan key"
  }
}

• GLM 国内站把 ANTHROPIC_BASE_URL 换成 https://open.bigmodel.cn/api/anthropic。
• 给 Codex 这类 OpenAI 协议 CLI 接入时，填 OPENAI_BASE_URL / OPENAI_API_KEY（服务商的 OpenAI 兼容端点）而非 ANTHROPIC_*。
• 隔离：env 按会话注入到 CLI 进程，全后端一致（tmux / zellij 经每个 pane 注入，绝不写共享 server 全局），所以一个 bot 的服务商配置不会串到别的 bot。
• 安全：值以明文存在 bots.json 与进程环境，不是密钥保险箱；/config get 等聊天面会脱敏显示（dashboard 编辑器 owner 鉴权后显示原值）。
• 改完下个新会话生效。

#工作目录

#权限与授权

#文件沙盒

#卡片与终端

#主动开工

#总结命令

示例：

{
  "summaryRange": {
    "limit": 50,
    "sinceHours": 24
  }
}

• 只有显式 @机器人 /summary 会触发总结；不 @ 机器人时仍按普通群/话题的既有路由规则处理，不会因为关键词自动唤醒。
• dashboard 的「/summary 总结范围」保存的就是 summaryRange。
• 如果本次触发前存在上一条 @同一机器人 /summary，总结窗口只包含上一条之后到本次触发为止的消息；找不到上一条时回退到 limit / sinceHours。
• limit 与 sinceHours 同时也是安全上限；两者都为 0 时表示不做该维度限制。

#旧内容触发配置

#语音

#运行时状态（自动维护，勿手改）

下列字段由 botmux 自身写入并随授权 / 开关一起持久化进 bots.json，列出仅为说明，不要手动编辑：

配置优先级：BOTS_CONFIG 环境变量 → ~/.botmux/bots.json。改完跑 botmux restart 生效。