Agent 管理

本文档定义 Agent 的新增、变更和下线流程，确保配置一致性和可追溯性。

Agent 配置来源

• 配置来源：Helm values 中的 config.agents.list，经 ConfigMap 渲染进 openclaw.json
• 工作空间路径：/root/.openclaw/runtime_agents/AIEmployee/<agent-id>/workspaces
• 唯一真相源：Helm values 文件

操作流程

新增 Agent

步骤：

1. 在 agents/AIEmployee/ 下创建 <agent-id>/workspaces 目录
2. 至少包含 AGENTS.md，可选 TOOLS.md、MEMORY.md 等
3. 在 values.yaml 的 config.agents.list 中追加配置：

- id: new-agent
  name: 新 Agent
  workspace: /root/.openclaw/runtime_agents/AIEmployee/new-agent/workspaces
  model: qwen-max

4. 若为协调 Agent 的子 Agent，在其 subagents.allowAgents 中加入新 id
5. 执行 helm upgrade 部署

变更 Agent

修改 config.agents.list 中对应项的 name、workspace、model、subagents 等。

WARNING

若修改 id，需同步修改目录名与所有引用（包括其他 Agent 的 subagents.allowAgents）。

下线 Agent

1. 从 config.agents.list 移除对应项
2. 从各 subagents.allowAgents 移除该 id
3. 仓库中可保留或归档 agents/AIEmployee/<id>/

协调 Agent

协调 Agent（如 digitalhuman）通过 subagents.allowAgents 声明可调用的子 Agent：

- id: digitalhuman
  name: 全栈协调
  subagents:
    allowAgents:
      - pm
      - sre
      - asset
      - test
      - cicd
      - finops

子 Agent 的 id 必须与 config.agents.list 中的定义一致。

配置同步检查清单

检查项	说明
values.yaml 已更新	Agent 列表变更的唯一入口
values-test.yaml 已同步	测试环境配置保持一致
workspace 目录已创建	包含必要的 MD 文件
subagents 引用已更新	协调 Agent 的子 Agent 列表
ConfigMap 已验证	helm template 检查生成的 openclaw.json

TIP

使用 helm template 可以在部署前预览生成的 ConfigMap，确认 Agent 配置正确：

helm template winwork ./charts/openclaw -f values.yaml | grep -A 50 "openclaw.json"