agentCreate

创建或卸载独立的 OpenClaw Agent,支持独立工作区、可选通道绑定(飞书/微信等)、模型选择。触发词:创建agent、new agent、创建机器人、agent setup、new bot、卸载agent、删除agent、remove agent

Audits

Pass

Install

openclaw skills install agentcreate

agentCreate

创建或卸载独立的 OpenClaw Agent。每个 Agent 拥有独立工作区、独立会话、独立模型,与主 Agent 完全隔离。

技术实现细节:

所有 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


卸载 Agent

  1. 列出所有 agent(agents list + agents bindings
  2. 用户选择目标 agent(禁止选择 main
  3. 展示 agent 信息,用户选择卸载模式:
    • 仅取消通道绑定(保留工作区和账号)
    • 完全卸载(删除 agent + 工作区 + 通道账号)
  4. 完全卸载需用户输入 yes 二次确认(不可恢复)

详细命令见 references/delete.md


核心约束

  • 禁止删除 main agent
  • 完全卸载时必须同步删除通道账号配置,否则消息可能 fallback 到 main agent
  • 删除账号配置必须用 Python 直接操作 openclaw.jsongateway config.patch 只能合并写入,无法删除 key)
  • 新增/修改配置通过 gateway config.patch 写入,禁止直接编辑配置文件
  • 修改配置前先备份当前值,失败时立即回滚