Agent Deploy

核心用法

agent-deploy 是 OpenClaw 平台的多 Agent 隔离部署工具，用于在单实例环境中快速创建、列举和删除独立的 AI Agent。每个 Agent 拥有独立的 Telegram Bot、工作目录和会话存储，实现真正的资源隔离。

主要操作：

• 部署新 Agent：执行 bash {baseDir}/scripts/deploy.sh <agentId> <botToken>，自动完成工作空间创建、配置写入、路由绑定、API 密钥继承
• 列举 Agent：运行 list.sh 查看当前所有 Agent 状态
• 移除 Agent：执行 remove.sh <agentId> 安全清理资源（禁止删除主 Agent）

关键约束： 脚本强制要求 agentId（小写字母/数字/连字符）和 botToken（digits:alphanumeric 格式），并自动运行 openclaw doctor 验证与故障回滚。

显著优点

| 维度 | 优势 |

|------|------|

| **隔离性** | 每个 Agent 独立 workspace、独立容器沙箱、`tools.deny: ["gateway"]` 防止越权修改核心配置 |

| **安全性** | 禁止直接编辑 `openclaw.json`，强制使用 `openclaw config set` 安全接口，配置错误自动回滚 |

| **便捷性** | 自动继承主 Agent 的 `auth-profiles.json`，新 Agent 立即具备已配置的模型 API 访问能力 |

| **兼容性** | 支持单 Bot 到多 Account 模式的平滑迁移，热重载无需手动重启服务 |

潜在缺点与局限性

• 单点依赖：Gateway 服务故障会影响所有 Agent 的 Telegram 接入
• 资源占用：每个 Agent 独立容器沙箱，高并发场景下内存/存储开销线性增长
• Token 管理：用户需自行从 @BotFather 获取有效 Token，格式校验严格但无法验证 Token 真实性
• 不可逆限制：remove.sh 禁止删除主 Agent，误操作后主 Agent 保护机制可能阻碍紧急清理

适合人群

• 需要为不同业务线（客服、内容审核、数据分析）隔离部署专用 Bot 的开发者
• 追求多租户安全隔离、但不愿维护多套 OpenClaw 实例的团队
• 已通过 openclaw CLI 管理主 Agent，希望扩展多 Bot 架构的现有用户

常规风险

1. 配置污染风险：若绕过脚本直接修改 openclaw.json，可能导致整个平台配置损坏
2. Token 泄露风险：Bot Token 在命令行参数中传递，需确保执行环境可信
3. 沙箱逃逸风险：sandbox.workspaceAccess: "none" 为默认策略，但若用户手动修改配置可能暴露主机文件系统
4. 服务可用性风险：部署后 Bot 未响应时，可能需要手动重启 openclaw-gateway，自动化程度存在边界