agentCreate
# agentCreate
创建或卸载独立的 OpenClaw Agent。每个 Agent 拥有独立工作区、独立会话、独立模型,与主 Agent 完全隔离。
技术实现细节:
- 创建流程 → 见 [references/create.md](references/create.md)
- 卸载流程 → 见 [references/delete.md](references/delete.md)
所有 CLI 操作必须通过 qclaw-openclaw skill 的 wrapper 脚本执行,禁止直接调用 `openclaw` 命令。
---
## 创建 Agent
**收集信息(按顺序引导,每次只问必要项):**
1. **Agent ID**(英文,小写字母/数字/连字符,唯一)
2. **通道绑定**(可选):先运行 `config get channels` 列出已有通道和账号供选择;若新建账号,收集对应凭据;也可跳过不绑定
3. **模型**:运行 `models list` 获取实时列表供用户选择,默认 `qclaw/modelroute`
4. **确认**:展示汇总表,用户确认后再执行
**执行前检查:**
- Agent ID 未被占用(`agents list`)
- 若绑定通道,账号已存在或已新建
详细命令见 [references/create.md](references/create.md)。
---
## 卸载 Agent
1. 列出所有 agent(`agents list` + `agents bindings`)
2. 用户选择目标 agent(禁止选择 `main`)
3. 展示 agent 信息,用户选择卸载模式:
- **仅取消通道绑定**(保留工作区和账号)
- **完全卸载**(删除 agent + 工作区 + 通道账号)
4. 完全卸载需用户输入 `yes` 二次确认(不可恢复)
详细命令见 [references/delete.md](references/delete.md)。
---
## 核心约束
- 禁止删除 `main` agent
- 完全卸载时**必须**同步删除通道账号配置,否则消息可能 fallback 到 main agent
- 删除账号配置必须用 Python 直接操作 `openclaw.json`(`gateway config.patch` 只能合并写入,无法删除 key)
- 新增/修改配置通过 `gateway config.patch` 写入,禁止直接编辑配置文件
- 修改配置前先备份当前值,失败时立即回滚
标签
skill
ai