夜雨聆风先说一句总的：这篇文章主要讲我真实怎么用 OpenClaw，以及trace系统帮我解决了什么问题。你要是也有「能跑但说不清」的时候，下面可能能对上号。
先看一眼「整块屏长什么样」，再讲讲为啥会想到开源这个项目。
一、Coding Agents们升级了我的研发方式
除了写代码的同事们，现在的协作规模和方式变化很大，多了coding Agents来写代码。
ClaudeCode、Cursor，openClaw在我用起来，是分别擅长不同的研发场景，不是很多公众号写的非此即彼的关系。Claude架构思维好，适合大块改、跟目录绑得紧的活；Cursor现在更多类似copilot，对人机协作特别友好，我经常在 Plan（把事摊开、多文件一起改）和 Debug（对着报错和栈抠）之间切。还有一条线在服务器上面的openclaw：聊天式开发环境，从云端git worktree改完让openclaw push Gitlab，和本机并进同一个远程仓库。
现在我在家里写代码，基本都开搜狗语音，备个润喉糖，能先说清楚就尽量不敲键盘。做一些开源项目前，先把 CLAUDE.md、AGENTS.md 和整条 flow 理顺——这跟后来接 OpenClaw、写traceFlow这个开源项目是同一套逻辑：边界先清楚，再让模型动刀。
我自己一个人这么玩玩是没有什么问题的，但一旦涉及到多人协作，就开始有其他同学开始报bug，为什么这个agents没有反应？为什么我跟它说的话，他好像没有回答出来，等等。
就这些问题都指向一个同样的原因，就是AI的运行时对我们来讲是相对黑盒的，可观测差。一旦它的这个交付并没有达到预期的话，这个时候去排障、人进行补位的话就会产生很多的摩擦噪音，带来成本。
这也是我为什么会考虑去做traceflow，让openclaw的运行时在我面前去呈现，这样我就能够有针对性的去优化它运行的harness(这个词比较时髦，我觉得大白话就是AI运行的环境，一个面向AI agents的workflow)。
二、OpenClaw：团队和个人，我都是重度用户
我自己用 OpenClaw 挺多。公司里偏研发的场景：比如自动改代码、worktree 支撑多人并行、自动指 reviewer、团队日常问答、定时任务等，链路一长，你就会问：会话上下文顶到哪了？Prompt 里进了啥？Skill 到底有没有被用？ 往往变成「好像是这样没问题」，而不是「我能清楚解释给你看它是怎么做到的」。
个人项目也一样。说白了，要对齐现象和依据的时候，缺一条能摊开的路径——不是一句「模型胡说」能交差，而是：此刻会话里装了什么、哪些 Skill 动过、窗口吃到哪——你自己都未必一眼说清。有人叫这「记忆幻觉」，我更愿意讲：根上是运行时对你不够可见。
三、为啥要单独开源 traceFlow
traceflow会话面板: openclaw的会话信息
traceflow会话面板：openclaw的会话详情度量
traceflow的systemPrompt面板：openclaw的systemPrompt分析
对于做openclaw-traceflow项目的动机，源于我需要的不是再多一个「能点的openclaw后台」，而是能核对的事实。
openClaw 自带界面能覆盖很多日常操作；但当我要和同事把事说圆、把 Skill / 会话 / 上下文摊开讨论时，我还是想要一块独立进程的屏，将openclaw在干什么，透明出来。
取名叫做traceFlow意思也简单：把 trace 摊开，能聊、能查。
四、写 TraceFlow 这个仓库的一些玩法
写这个仓库的时候，一开始觉得应该工作量不大，但是越做越多。本来以为去读个openclaw的state、workspace就差不多了，但发现有较多的性能问题、数据不准的问题，归档会话的问题。还有一些openclaw内部的疑似bug，比如token的usage是不完全可信的问题等。
包括交互界面设计，一开始让openclaw直接弄，出来的东西非常粗糙，基本上没法进一步的迭代。于是就要去做重新的选型。比如说我选择的是nest和ant design等。还有很多的数据口径问题，因为openclaw给的很多数据是没那么准的，因此在交互设计上必须要让开发者能够知道openclaw到底是怎么统计出来的，数据口径必须透明清晰。细节还挺多的，比想象中多不少。
同时在做这个事情的过程中，也探索出来了一些好玩的研发模式。比如说我就基本上是ClaudeCode、Cursor，然后阿里云的ECS上部署了一个openclaw三者并发，流程上尽量是先写prd，让我review之后再做实施，整个项目搞下来，deploy的次数估计有五六十次，工作量比我想象的大很多。
最后，欢迎技术交流
openclaw-traceflow今天开源，虽然还有一些已知bug，但应对一些小团队、个人的场景应该够用。同时，你觉得不够好的地方也欢迎PR或者自己fork自己改。
欢迎Star/PR。
github地址:https://github.com/slashhuang/openclaw-traceflow
