核心用法
openclaw-new-agent 是 OpenClaw 生态的配套配置工具，专用于在已有 OpenClaw 实例上部署多个独立的飞书机器人 Agent。它通过标准化的六步流程（场景确认→备份→工作区创建→配置修改→验证→回滚），实现多账号模式下的 Agent 快速扩容。
核心能力包括：
- 工作区隔离：每个 Agent 拥有独立的
/workspace-{name}/目录，包含 SOUL.md（角色定义）、USER.md（用户信息）、MEMORY.md（长期记忆）等完整结构 - 自动白名单：支持
allowFrom自动获取机制——配置初期留空，通过日志抓取实际发送者的 open_id - 一键模板：提供飞书开放平台预配置链接，自动生成含 WebSocket 事件订阅的多账号模式应用
- 局部热更新：使用
gateway config.patch而非全量覆盖，确保现有 Agent 零中断
显著优点
1. 运维安全性：强制备份机制（openclaw.json.{标签}.bak）+ 完整回滚脚本，配置失败可秒级恢复
2. 权限精细化：支持按 Agent 配置 dmPolicy/groupPolicy，实现私聊/群聊的独立白名单管控
3. 角色可定义：SOUL.md 模板标准化 Agent 的核心能力、风格、原则与边界，便于团队协作
4. 日志可追溯：所有消息路由、WebSocket 连接状态均可在 ~/.openclaw/logs/gateway.log 中审计
潜在缺点与局限性
- 依赖外部平台：需手动在飞书开放平台创建应用并获取凭证，流程无法完全自动化
- Node 版本敏感：文档引用特定 Node 路径（
v22.22.1），跨版本可能存在兼容风险 - 无 GUI 界面：纯命令行交互，对非技术用户门槛较高
- 白名单延迟：
allowFrom自动获取需等待首次消息触发，无法预先完成全量配置
适合人群
- 已部署 OpenClaw 且需业务隔离的用户（如：客服机器人 vs 代码助手 vs 个人助理）
- 团队协作场景：不同成员拥有独立工作区与记忆系统
- 多飞书账号管理者：需统一网关、分账号路由的高级用户
常规风险
| 风险点 | 说明 |
|--------|------|
| 配置覆盖 | 误操作 `>` 重定向可能导致 `openclaw.json` 损坏，必须严格遵循备份步骤 |
| App Secret 泄露 | 凭证存储于本地 JSON，建议设置文件权限 `600` |
| WebSocket 连接风暴 | 多 Agent 并发可能触发飞书限流，需监控 `gateway.log` 中的重连日志 |
| allowFrom 遗漏 | 未完整添加所有发送账号将导致消息静默丢弃，难以排查 |