任务 ID: task-e897a10b  |  文件: task.md  |  最后修改: 2026-03-03 18:35:46

Task task-e897a10b — Kizuna 节点和 Agent 管理(Step 3)

文件路径

原始需求

开发 Kizuna 节点和 Agent 管理功能(Phase 1 Step 3),实现节点注册、查询、删除。

参考文档/root/.openclaw/workspace/memory/docs/kizuna-design-phase1-v5.md

交付物
- nodes.json 存储
- Hub API:
- POST /nodes/register — 注册节点
- GET /nodes/list — 列出节点
- DELETE /nodes/{id} — 删除节点
- CLI 子命令:
- register-node — 注册节点
- list-nodes — 列出节点
- remove-node — 删除节点

验收标准
- ✅ 能注册本地节点(le-b)
- ✅ 能查询节点和 Agent 列表
- ✅ TASK.md 验证时能检查节点存在性

源码位置
- Hub: /srv/kizuna/kizuna-hub/main.py(扩展)
- CLI: /srv/kizuna/cli/kizuna-ctl(扩展)

代码要求
- 最小化实现
- 完善的错误处理


执行链

coder → reviewer → 爱衣质检


各 Agent 职责


Ai.Dev(session key: agent:coder:main

任务:开发节点和 Agent 管理功能

具体要求
1. 阅读设计文档中的节点管理部分
2. 在 Hub 中添加 3 个 API 端点
3. 在 CLI 中添加 3 个子命令
4. 实现 nodes.json 存储
5. 提供测试命令示例

输出
- 更新后的 Hub 和 CLI 源码
- 测试命令示例

开始时:
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh coder receive "Kizuna 节点管理开发" task-e897a10b

完成后:
1. 将执行日志追加到 session.md
2. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh coder handoff "Kizuna 节点管理开发" reviewer task-e897a10b
3. sessions_send 通知 reviewer(agent:reviewer:main必须传 timeoutSeconds=0):
task_id=task-e897a10b task=/root/.openclaw/workspace/tasks/task-e897a10b/task.md


Ai.Rev(session key: agent:reviewer:main

任务:审核节点管理功能并测试

具体要求
1. 代码审查
2. 功能测试:
- 注册本地节点
- 列出节点
- 删除节点
- 验证 nodes.json 读写
3. 问题记录

输出
- review.md(审查报告 + 测试结果)

开始时:
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh reviewer receive "Kizuna 节点管理开发" task-e897a10b

完成后:
1. 将执行报告追加到 session.md
2. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh reviewer handoff "Kizuna 节点管理开发" main task-e897a10b
3. sessions_send 通知爱衣(agent:main:main必须传 timeoutSeconds=0):
task_id=task-e897a10b task=/root/.openclaw/workspace/tasks/task-e897a10b/task.md


⚠️ 爱衣质检 SOP(收到最终通知后执行)

Step 1:评估工作区大小

du -sb /root/.openclaw/workspace/tasks/task-e897a10b/

Step 2:读取 session.md

wc -l /root/.openclaw/workspace/tasks/task-e897a10b/session.md

若行数 N > 0,read session.md 全文。

Step 3:质检要点

通用检查(每次必须):
- 产出是否符合原始需求?
- 执行过程是否有明显问题?
- Agent 间是否有未解决的分歧?

任务特定检查:
- 是否实现了 3 个 Hub API 和 3 个 CLI 命令?
- Reviewer 的测试是否通过?
- nodes.json 是否正常工作?

Step 4:输出结论

通过
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh main done "Kizuna 节点管理开发" task-e897a10b
2. 用 message 工具发送给主人(telegram, 92763607),归纳任务结果

不通过(rejectCount == 0)
1. 分析问题根因,设计新执行链
2. 创建新的 task.md(task_id 加后缀 -retry1),session.md 独立
3. 在原 session.md 末尾追加一行 rejectCount=1
4. sessions_send 给新执行链起始 Agent
5. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh main retry "Kizuna 节点管理开发" "<新执行链>" <起始role> 1 task-e897a10b

rejectCount >= 1(第二次仍失败)
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh main fail "Kizuna 节点管理开发" task-e897a10b
2. message 主人,归纳问题和两次失败原因,请主人裁决

超限处理(工作区 > 80KB)

  1. 仅读 task.md(了解需求)
  2. 读 session.md 末尾 200 行
  3. message 主人:任务已完成,但工作区内容繁多,建议人工审计,附简单归纳