跳到主内容
博客分类与文章

实践记录

本地 Agent 排障与观测手记

为什么要单独写「实践记录」

架构与协议可以写在白板与文档里,但上线后的问题往往来自环境、版本与观测盲区。本分类用来沉淀可复用的排障步骤,而不是重复产品说明书。

最小复现清单

在报 issue 或改代码前,尽量固定以下变量:

  • 客户端版本:OpenClaw Desktop / AgentOS 的构建号或 tag
  • 模型与工具:是否启用特定 MCP、沙箱策略
  • 日志级别:是否已打开可导出的一段 trace(占位说明)

观测从哪切入

优先看任务边界:一次用户意图从进入到结束,Task Control 是否给出明确阶段;若阶段已标失败,再下钻到 Runtime(权限、超时、资源)。

已知局限(占位)

完整跑通「本地 → 预览 → 生产」的差异表仍在整理;本文随 TASK-F203 一并落地,后续可替换为带截图与命令片段的正式稿。

小结

实践记录的价值在于把一次踩坑变成下一次的默认检查项,与「Agent 架构」「Task Control」「Runtime 系统」三条理论线形成闭环。