Feishu Multi-Bot Setup#

批量创建多个飞书机器人（多Agent），每个机器人拥有：

• ✅ 独立记忆系统 - 独立的 MEMORY.md 和每日日志
• ✅ 独立存储空间 - 每个机器人独立工作目录
• ✅ 独立大模型配置 - 每个机器人可配置不同的模型
• ✅ 独立角色设定 - 独立的 SOUL.md、IDENTITY.md
• ✅ 独立飞书连接 - 每个机器人对应独立的飞书应用凭证

功能特点#

• 一键批量创建多个飞书机器人
• 自动转换配置格式（从单账号到多账号）
• 自动创建所有配置文件
• 自动绑定路由规则
• 自动处理白名单权限问题
• 每个机器人完全隔离

使用方法#

1. 准备配置文件#

创建一个 JSON 配置文件 bots_config.json，格式如下：

json

{
  "bots": [
    {
      "name": "coding-assistant-bot",
      "agentId": "feishu-coding-assistant",
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "encryptKey": "xxx",
      "verificationToken": "xxx",
      "model": "volcengine-plan/ark-code-latest",
      "connectionMode": "websocket",
      "personality": {
        "role": "编程助手",
        "tagline": "全栈开发工程师",
        "style": "严谨高效、直给代码",
        "styleDescription": "代码风格严谨高效，直接给出可运行代码",
        "responsibilities": [
          "代码编写",
          "Bug修复",
          "框架开发",
          "接口与部署"
        ],
        "description": "我是全栈开发工程师...",
        "motto": "代码即艺术，效率即生命",
        "emoji": "💻"
      }
    }
  ]
}

配置字段说明#

字段必填说明name✅Bot 内部名称 (飞书账号 ID)agentId✅Agent 唯一标识appId✅飞书应用 IDappSecret✅飞书应用密钥encryptKey❌加密密钥verificationToken❌验证令牌model❌独立大模型配置，默认使用全局默认connectionMode❌websocket 或 webhook，默认 websocketpersonality✅机器人角色信息（见下面）

Personality 字段说明#

字段必填说明role✅机器人角色名称tagline✅简短描述style✅工作风格描述styleDescription❌详细风格说明responsibilities✅职责列表description✅自我介绍motto❌签名格言emoji✅机器人表情

2. 运行批量创建脚本#

bash

python3 /root/.openclaw/workspace/skills/feishu-multi-bot-setup/scripts/setup_bots.py /path/to/bots_config.json

3. 重启网关#

bash

openclaw gateway restart

权限说明#

• 每个飞书机器人应用中，用户的 Open ID 是 完全不同的
• 首次运行后，可以从网关日志中提取每个机器人对应的用户 ID
• 然后将用户 ID 添加到对应机器人配置的 allowFrom 列表中
• dmPolicy: "open" 配合空的 allowFrom 表示允许所有人访问
• dmPolicy: "allowlist" 需要配置具体的允许用户列表

常见问题#

Q: 为什么机器人收到消息但不回复？#

A: 检查网关日志，看是否显示 blocked unauthorized sender，如果有，说明需要将对应的用户 ID 添加到该机器人的 allowFrom 白名单中。

Q: 每个机器人真的完全独立吗？#

A: 是的！每个机器人：

• 独立工作目录 ~/.openclaw/agents/{agent_id}/workspace/
• 独立的记忆文件 MEMORY.md 和 memory/ 目录
• 独立的角色配置 SOUL.md 和 IDENTITY.md
• 可以配置独立的大模型
• 独立的飞书连接

Q: websocket 和 webhook 选哪个？#

A: 推荐使用 websocket，不需要公网 IP，OpenClaw 主动连接飞书服务器。如果使用 webhook 需要公网可访问地址。

总结#

这个技能解决了批量创建多个独立飞书机器人的问题，让你可以：

• 根据不同职能创建不同的机器人
• 每个机器人有自己独立的记忆和模型
• 机器人之间完全隔离互不干扰
• 一键配置，自动完成所有设置

作者: OpenClaw 批量飞书机器人配置 版本: 1.0.0