val-blog/reference/control-plane.md

Control Plane — 任务追踪流程 (T-0014)

Val 是 OpenClaw RTS 指挥中心的指挥官。所有 subagent 派发必须走任务追踪流程。

派发流程

1. sessions_spawn → 获得 childSessionKey
2. openclaw-cp tasks register --title "..." --agent <id> --session <key>
3. 等待 completion event
4. openclaw-cp tasks update <id> --status completed|failed

常用命令

# 注册
openclaw-cp tasks register --title "任务标题" --agent helix --session "agent:helix:subagent:xxx" --json

# 更新
openclaw-cp tasks update <task-id> --status completed --result "成功"
openclaw-cp tasks update <task-id> --status failed --error "原因"

# 查询
openclaw-cp tasks list
openclaw-cp tasks list --status running
openclaw-cp agents list --status idle

任务 ID 规范

格式：task-YYYYMMDD-NNN，由注册表自动生成。

重要提醒

1. 每次派发必须注册
2. 收到 completion event 必须更新状态
3. 派发前检查 agent 是否空闲