为了用好OpenClaw我VibeCoding(10天+311次commit)了一个开源软件
最近在深度使用 OpenClaw 的过程中,我反复遇到一些非常影响体验的问题。他们不一定是"不能用"的问题,但都是那种会不断打断你工作流、让人抓狂的小坑。
于是我干脆针对这些痛点,做了一个自己的 OpenClaw Dashboard,把一系列我觉得最需要的能力补上了。
先说痛点
1. 任务发出去了,但像石沉大海一样
你兴冲冲地给 OpenClaw 发了个任务,结果半天没收到回复。
你默默打开 OpenClaw 的 dashboard,反复刷新,发现还是一点动静都没有。再仔细一看他最后的操作,才发现原来他刚刚重启了 gateway,所以根本没法给你回复。
2. gateway 因为内存不够被 kill,消息也就永远没回音了
还有一种常见情况是:机器内存不够,gateway 直接被系统 kill 掉。
结果和上面一样------你这边看到的,就是消息发出去了,但永远等不到回复。
3. 模型悄悄 fallback 了,你过很久才发现
你明明配置了好几个模型,结果某个模型限流了,或者临时不稳定,OpenClaw 就悄悄 fallback 到了另一个模型。
最难受的是,这件事他不会非常明显地告诉你。你可能过了半天才后知后觉:
"怪不得这次效果突然变差了,原来底层模型已经换了。"
4. 想看清 Agent 到底干了什么,但官方 dashboard 不够直观
很多时候,我们真正想知道的是:
- Agent 背后到底做了哪些推理
- 调了哪些工具
- 每一步是怎么走的
- 到底是哪里出了问题
但 OpenClaw 官方 dashboard 里,Agent 的 thinking 被删掉了,工具和工具调用的展示也不够友好,导致排查问题时非常费劲,很难真正看懂 Agent 到底做了什么。
5. Agent 把自己的核心文件改坏了,想回滚都难
有时候你会让 Agent 帮你修改他自己的核心文件。
结果一不小心改坏了,之前的内容找不回来了;或者虽然改了,但你也不知道他到底改了哪里。
这种感觉就像把系统交给一个很勤快、但偶尔会手滑的同事,而你手里还没有版本记录。
6. 想复用一套通用模板,却只能复制很多份
很多时候,我们会有一套通用的 Agent 模板,希望多个 Agent 都能共用。
但现实往往是:你把这些内容复制了很多份,每个 Agent 一份。
一旦后面要修改,所有 Agent 都要手动同步改,维护成本非常高。
解决方案
针对上面的这些问题,我做了一套比较完整的功能,尽量把这些日常使用中的"别扭感"抹平。
1. 透视 Agent
1.1 整体透视:先看清楚有哪些 Agent
首先,我希望能更直观地看到系统里到底有哪些 Agent,整体状态如何,一眼有全局感。
1.2 核心文件透视:把关键内容放到同一个页面里
我把 Agent 的核心文件、Skills 目录等内容都展示在同一个页面上,并加上了翻译功能。
这样一来,我们就能更快地看到并理解一个 Agent 的完整结构和关键内容。再配合编辑能力,也可以直接在这个页面里快速修改并保存。
1.3 消息透视:看清楚每次任务到底发生了什么
除了静态文件,我还把 Agent 的 session 数据也直接展示到了页面上。
这样你就能非常直观地看到:
每次发布任务后,这个 Agent 到底做了什么、走了哪些步骤、卡在了哪里。
同时支持实时刷新,不需要像官方 dashboard 一样,很多 session 还得自己手动刷新才能看到最新状态。
1.4 状态透视:Agent 和 session 是否在工作,一眼可见
每个 Agent 以及每个 session 的运行状态,也都可以直接看到。
我是在左侧加了状态标识,并且通过判断 OpenClaw 执行时产生的文件锁,来比较准确地识别他当前是否正在工作。
这样你就能很快区分:他到底是真的在跑,还是其实已经挂了、停了、卡住了。
2. 批量生产 Agent:Blueprint
有时候,我们希望为不同项目生成很多"长得很像"的 Agent。
他们的大部分配置相同,但又会有一些细节差异。
这时候,如果纯靠复制粘贴,就会很痛苦:能复用的地方没法复用,后续同步修改也很麻烦。
所以我引入了 Blueprint 的概念。
Blueprint 本质上是一套 Agent 模板,你可以在里面使用变量(例如 !{variable})来定义那些会变化的部分。
举个我自己的例子:
我可以先做一套"开发经理"Blueprint,然后为不同实例配置不同变量,比如:
- 他自己的开发容器
- 他自己的 Claude Code 聊天房间(用于我和 Claude Code 对话)
这样一来,这类 Agent 的个性化需求可以通过变量解决,而通用行为依然由 Blueprint 统一管理。
后续如果我要调整这类 Agent 的行为,只需要改 Blueprint,所有继承自他的 Agent 就都可以同步更新。
顺便,我还专门写了一套 skill,供 Agent 自己修改 Blueprint 使用。
这里有个关键点:
不能直接修改 Agent 自己 workspace 下的文件,而应该修改 Blueprint。
而且在修改过程中,还必须保留变量结构。
所以这个 skill 里会明确描述这些规则,避免 Agent 改着改着把模板体系改坏。
3. 版本控制:让修改可追踪、可回滚
为了避免 Agent 把内容改坏之后无法恢复,也为了方便 review Agent 做过哪些修改,我又引入了版本控制。
这样无论是 Blueprint 还是 Agent 的改动,都能清楚看到差异,必要时也能快速找回之前的版本。
对于日常使用来说,这点非常重要:
- 改坏了,能回滚
- 改过什么,能 review
- 为什么效果变了,能追踪
整体使用体验会安心很多。
4. 适配手机显示:手机端也能用
未来展望
目前这套工具对我自己来说,其实已经基本够用了。后面如果继续做下去,我大概还会考虑这些方向:
1. Blueprint 市场
如果能把 Blueprint 做成可分享、可复用的市场,大家就可以更方便地直接复制别人已经配置好的 Agent,减少从零搭建的成本。
2. 增加鉴权能力
这样即使在外网环境下,也能更安全地访问和使用整套系统。
GitHub
项目地址:claw-Agent-dashboard
https://github.com/boydfd/claw-Agent-dashboard
欢迎使用。
如果觉得这个项目对你有帮助,也欢迎顺手点个 Star 支持一下。