核心用法
openclaw-new-agent 是专为 OpenClaw 生态设计的多账号飞书机器人部署工具，解决单实例运行多个独立 Agent 的核心需求。通过标准化五步法（确认场景→备份配置→创建工作区→修改配置→验证测试），用户可在现有 OpenClaw 实例上快速新增具备独立身份、隔离工作区的飞书机器人。
关键流程设计体现工程严谨性：强制备份机制（.beforemultiagentbak）防止配置回滚灾难；平级工作区架构（workspace-{name}）确保各 Agent 文件系统隔离；gateway config.patch 局部更新策略避免配置覆盖风险；allowFrom 自动填充机制通过日志捕获降低用户配置门槛。
显著优点
- 场景化引导：内置飞书模板应用一键创建链接，自动生成预配置 WebSocket 事件订阅的机器人
- 安全隔离：每个 Agent 拥有独立 SOUL.md（角色定义）、USER.md（用户画像）、MEMORY.md（长期记忆），实现多租户级别的上下文隔离
- 权限精细化：支持单聊/群聊双维度白名单（
allowFrom/groupAllowFrom），dmPolicy与groupPolicy独立管控 - 零停机配置：动态 config.patch + 网关热重启，服务不中断完成 Agent 扩容
- 完整回滚方案：标准化备份命名与一键恢复命令，降低运维风险
潜在局限
- 依赖飞书生态：仅支持 Lark/Feishu 平台，无多平台适配能力
- 手动凭证管理：App Secret 需用户手动提供，未集成飞书 OAuth 自动授权
- 单点日志依赖：
allowFrom自动获取依赖网关日志解析，若日志轮转或权限问题可能导致填充失败 - 无资源监控：缺少 Agent 级 CPU/内存/调用频次监控，大规模部署时运维盲区
适合人群
- 需要为不同业务线（客服/开发/运营）配置专属机器人的 OpenClaw 用户
- 追求多 Agent 上下文隔离、避免记忆污染的团队
- 具备基础 Linux/Node.js 环境操作能力的技术使用者
常规风险
1. 配置覆盖风险：若未使用 config.patch 而直接编辑 openclaw.json，可能丢失其他 Agent 配置
2. 权限泄露风险：allowFrom 配置不当可能导致未授权用户访问敏感 Agent
3. Webhook 冲突：多机器人若共享事件订阅地址，可能引发消息路由混乱
4. Secret 硬编码：配置文件中 App Secret 明文存储，需确保 ~/.openclaw/ 目录权限为 700
安全等级说明
基于代码仓库公开可审计（MIT 协议）、配置操作需本地文件系统权限、无外部网络依赖等特征，综合评估为 S级。建议用户启用飞书 IP 白名单并定期轮换 App Secret。