Lark Multi-Agent Factory

针对 @larksuite/openclaw-lark（≥ 2026.4.0） 的多 agent 批量配置向导。

与 feishu-multi-agent-factory 的区别

• 专为官方 @larksuite/openclaw-lark 插件设计（内置插件 @openclaw/feishu 用另一个）
• 支持 threadSession、replyMode、blockStreaming 等官方插件专属字段
• 创建前自动检查插件是否已安装

核心脚本

~/.openclaw/workspace/skills/lark-multi-agent-factory/scripts/setup_agents.py

官方插件专属字段说明

对话示例

批量创建 agents

用户：

帮我用官方飞书插件创建 2 个 agent：
1. id: analyst，数据分析师📊，AppId: cli_xxx1，Secret: yyy1
2. id: writer，内容创作者✍️，AppId: cli_xxx2，Secret: yyy2
用 streaming 模式，开启 threadSession

助手回应（先 dry-run 确认）：

python3 ~/.openclaw/workspace/skills/lark-multi-agent-factory/scripts/setup_agents.py \
  --dry-run \
  --config '{
    "channel": {"threadSession": true, "replyMode": "streaming"},
    "agents": [
      {"id": "analyst", "name": "数据分析师", "emoji": "📊",
       "feishu_app_id": "cli_xxx1", "feishu_app_secret": "yyy1"},
      {"id": "writer", "name": "内容创作者", "emoji": "✍️",
       "feishu_app_id": "cli_xxx2", "feishu_app_secret": "yyy2"}
    ]
  }'

确认后执行：

python3 ~/.openclaw/workspace/skills/lark-multi-agent-factory/scripts/setup_agents.py \
  --config '...' --restart

调整 channel 级别参数

# 切换 replyMode（无需重新创建 agents）
python3 ~/.../setup_agents.py --set-channel --reply-mode streaming --restart

# 开启 threadSession
python3 ~/.../setup_agents.py --set-channel --thread-session true

# 关闭 blockStreaming
python3 ~/.../setup_agents.py --set-channel --block-streaming false

操作流程

第一步：收集信息

用户说想添加 agent 时，引导收集：

我需要以下信息：

1. **Agent ID**（英文小写，如 `analyst`）
2. **名称**（如「数据分析师」）
3. **Emoji**
4. **飞书 App ID**（格式：cli_xxxxxxxx）
5. **飞书 App Secret**
6. **replyMode**（可选，默认继承 channel 设置）
   - `auto` — 自动选择（推荐）
   - `streaming` — 流式输出，打字机效果
   - `static` — 纯文本，兼容性最佳

可同时提供多个 agent。

第二步：dry-run 预览

python3 ~/.openclaw/workspace/skills/lark-multi-agent-factory/scripts/setup_agents.py \
  --dry-run --config '\x3CJSON>'

第三步：确认并创建

python3 ~/.openclaw/workspace/skills/lark-multi-agent-factory/scripts/setup_agents.py \
  --config '\x3CJSON>' --restart

JSON 格式

{
  "channel": {
    "threadSession": true,
    "replyMode": "auto",
    "blockStreaming": false
  },
  "agents": [
    {
      "id": "analyst",
      "name": "数据分析师",
      "emoji": "📊",
      "description": "负责数据分析与报表",
      "feishu_app_id": "cli_xxxxxxxx",
      "feishu_app_secret": "xxxxxxxx",
      "feishu_domain": "feishu",
      "reply_mode": "streaming"
    }
  ]
}

channel 字段可选，第一次运行时写入 channels.feishu（已有值不覆盖）。
reply_mode 为 per-agent 覆盖，仅当与 channel 级别不同时才写入账号配置。

其他命令

# 查看现有 agents 及 channel 配置
python3 ~/.../setup_agents.py --list

# 删除 agent（仅移除配置，不删目录）
python3 ~/.../setup_agents.py --remove \x3Cid>

# 跳过插件检查（调试用）
python3 ~/.../setup_agents.py --skip-plugin-check --config '...'

前置条件

1. 安装官方插件：

   openclaw plugins install @larksuite/openclaw-lark
   

2. 禁用内置插件（若已安装，两者不可同时运行）：

   openclaw plugins disable feishu
   

3. 通过 openclaw channels add 配置顶层主账号（channels.feishu.appId/appSecret）。

4. 重启 gateway 激活插件：

   openclaw gateway restart
   

自动完成的事项

安全说明

• App Secret 脱敏输出（仅显示前 4 位）
• 凭据只写入本地 ~/.openclaw/openclaw.json
• agent id 严格校验，防止路径穿越攻击