为什么要单独写「实践记录」
架构与协议可以写在白板与文档里,但上线后的问题往往来自环境、版本与观测盲区。本分类用来沉淀可复用的排障步骤,而不是重复产品说明书。
最小复现清单
在报 issue 或改代码前,尽量固定以下变量:
- 客户端版本:OpenClaw Desktop / AgentOS 的构建号或 tag
- 模型与工具:是否启用特定 MCP、沙箱策略
- 日志级别:是否已打开可导出的一段 trace(占位说明)
观测从哪切入
优先看任务边界:一次用户意图从进入到结束,Task Control 是否给出明确阶段;若阶段已标失败,再下钻到 Runtime(权限、超时、资源)。
已知局限(占位)
完整跑通「本地 → 预览 → 生产」的差异表仍在整理;本文随 TASK-F203 一并落地,后续可替换为带截图与命令片段的正式稿。
小结
实践记录的价值在于把一次踩坑变成下一次的默认检查项,与「Agent 架构」「Task Control」「Runtime 系统」三条理论线形成闭环。