多 Bot 模式¶

在单个 MetaBot 进程中运行多个飞书和 Telegram Bot。

配置¶

在 .env 中设置 BOTS_CONFIG=./bots.json 启用多 Bot 模式：

{
  "feishuBots": [
    {
      "name": "metabot",
      "feishuAppId": "cli_xxx",
      "feishuAppSecret": "...",
      "defaultWorkingDirectory": "/home/user/project-a"
    },
    {
      "name": "backend-bot",
      "feishuAppId": "cli_yyy",
      "feishuAppSecret": "...",
      "defaultWorkingDirectory": "/home/user/project-b"
    }
  ],
  "telegramBots": [
    {
      "name": "tg-bot",
      "telegramBotToken": "123456:ABC...",
      "defaultWorkingDirectory": "/home/user/project-c"
    }
  ]
}

Bot 配置字段¶

字段	必填	默认值	说明
`name`	是	—	Bot 标识名
`defaultWorkingDirectory`	是	—	Claude 工作目录
`feishuAppId` / `feishuAppSecret`	飞书	—	飞书应用凭证
`telegramBotToken`	Telegram	—	Telegram Bot Token
`maxTurns`	否	不限	每次请求最大轮次
`maxBudgetUsd`	否	不限	每次请求费用上限
`model`	否	SDK 默认	Claude 模型
`allowedTools`	否	`Read,Edit,Write,Glob,Grep,Bash`	Claude 工具白名单
`outputsBaseDir`	否	`/tmp/metabot-outputs`	输出文件目录

工作原理¶

每个 Bot 拥有独立的飞书/Telegram 连接
会话按 chatId 隔离 — Bot 之间无冲突
每个 Bot 使用各自的工作目录和配置
环境变量作为 JSON 中未指定字段的默认值

设置 BOTS_CONFIG 后，FEISHU_APP_ID / FEISHU_APP_SECRET 环境变量被忽略。

Peers 配置¶

也可以在 bots.json 中配置 Peers：

{
  "feishuBots": [{ "..." }],
  "peers": [
    {
      "name": "alice",
      "url": "http://localhost:9200",
      "secret": "alice-api-secret"
    }
  ]
}

单 Bot 模式¶

不设 BOTS_CONFIG 时，MetaBot 使用环境变量运行单个 Bot：

FEISHU_APP_ID=cli_xxx
FEISHU_APP_SECRET=...
DEFAULT_WORKING_DIRECTORY=/home/user/project