OpenClaw Agent 是一个自动化工具，用于快速创建和管理独立的 AI Agent。用户可以通过自然语言指令触发该功能，系统将自动完成新 Agent 的创建工作空间、配置文件生成、权限设置等复杂流程。该工具特别适用于需要为不同职能（如市场助理、客服代表、内容创作助手）快速部署专用 AI 代理的场景。
通过集成 Telegram Bot 作为通信渠道，每个新创建的 Agent 都拥有专属的身份标识和访问控制机制。系统会从主 Agent 复制认证配置、技能库以及用户文档，确保新 Agent 具备一致的运行环境和安全策略。同时，所有操作均基于 openclaw.json 配置文件进行，保证配置变更的可追溯性和一致性。
整个流程设计注重安全性与隔离性：每次添加新 Agent 前都会备份原始配置文件，并在完成后验证 JSON 格式有效性；文件权限也会被正确重置以匹配当前用户身份。最终结果是一个完全独立运行、具备完整通信能力的新 Agent，可直接投入实际任务执行。
核心功能特点
- 支持通过自然语言指令快速创建隔离式 Agent，自动提取 ID、名称、Bot Token 等关键参数
- 自动生成 SOUL.md 和 AGENTS.md 人格化描述文件，明确角色职责与协作规则
- 智能复制主 Agent 的 auth-profiles.json、skills 目录及 USER.md 配置，保持环境一致性
- 自动更新 openclaw.json 配置文件，包括 agents.list、bindings 和 channels.telegram.accounts 等模块
- 内置 JSON 语法校验机制，失败时自动回滚至最近备份版本防止配置损坏
- 完成权限修复并输出详细操作日志，提示用户重启 Gateway 以激活新 Agent
适用场景
该工具最适合在团队协作或多任务并行处理环境中使用。例如，当企业需要为市场营销部门单独配备一个负责社交媒体运营和内容策划的 AI 助理时，管理员只需发送类似“添加 ID 为 marketing、名为 Marketing Assistant、Telegram Bot Token 为 xxx、允许来自 123456789、职责是内容营销和社媒管理的 Agent”的指令，即可在数分钟内获得一个功能完备且安全隔离的新 Agent。
另一个典型应用场景是在开发测试阶段批量部署多个模拟用户或虚拟员工。每个 Agent 可承担不同角色（如技术支持、数据分析、客户回访），并通过各自的 Telegram Bot 接收任务指令。由于系统强制要求 allowFrom 字段指定可信用户 ID，因此能有效防止未授权访问，保障生产环境安全。
此外，对于希望扩展 OpenClaw 生态系统的开发者而言，add-agent 提供了一种标准化、可复用的 Agent 初始化模板。无论是内部运维还是对外提供服务，都能借助此工具实现快速迭代与规模化部署，显著降低人工配置成本与出错概率。