最近打开 OpenClaw 的网页面板,发现顶部多了一个”工作板”的入口。点进去一看,是个看板界面,有点像 Trello。研究了一下才发现这东西挺适合我平时用 OpenClaw 做的那些长任务。

之前我让 agent 在后台跑批量下载、多服务器操作这些事,只能在聊天里反复追问”跑完了吗”。Workboard 能把每件事变成一张卡片,状态自动更新,打开看板就能看到进度。对我来说最实用的就是这个。

工作板

它到底能干嘛

一张卡片就是一个任务。你写清楚要做什么,点 Run,agent 就开始干活。卡片状态会自己变——running、review、done,或者挂了就 blocked。

你也可以先建好一批卡片,然后 dispatch 出去让 agent 一个个执行。做完的卡片自动标 review,等你看一眼确认没问题再拖到 done。

建卡片有两种方式。你自己在 Dashboard 里点 New Card 建,或者 CLI 敲命令建。另一种是 agent 在干活的时候自己建——比如它正在写文章,发现还要配图,就会自己调用 workboard_create 工具建一张”配图”卡片。两种都行。

复杂任务怎么拆

一个大任务通常要拆成好几步。Workboard 支持卡片之间的依赖:父卡片下面挂若干子卡片,子卡片全部 done 了,父卡片自动推进到 ready。

你可以提前手动拆好,也可以让 agent 在执行过程中自己拆。Board 里有个 autoDecompose 配置,开了之后 agent 遇到复杂任务会主动调用 workboard_decompose 把任务拆开。不过别指望它真的”自动”——拆分这件事还是 agent 自己判断、自己调工具完成的,不是 Workboard 检测到复杂度然后帮你拆。

依赖推进倒是全自动的。子卡片全 done,父卡片就从 todo 跳到 ready,不用你动手。

什么任务该用它

我总结下来,适合 Workboard 的任务有几个共同点:跑的时间长(几十分钟到几小时),你不确定它什么时候完,中间可能出错需要你处理,或者同时有好几个任务在跑。

像 Telegram 批量下载 90 多个视频这种,以前只能在聊天里等。现在建张卡片 dispatch 出去,随时打开看板看进度,哪批卡住了、哪批完成了,一目了然。

再比如我有三台服务器——腾讯云、京东云、软路由。同时给三台机器更新配置,以前只能一台一台来。现在每台建一张卡片,dispatch 出去三个 worker 并行跑,哪台出问题了直接看 blocked 卡片。

还有一种场景是多步骤有依赖的任务。比如你想用 AI 生成一个短剧:写剧本、生成分镜、生成画面、配音、配乐、剪辑。每一步都依赖上一步的结果,而且中间可能失败要重试。这种任务用 Workboard 就很舒服——agent 拆出子卡片,依赖关系自动管理,哪步卡了直接看到。

不需要 Workboard 的也有:几秒钟就干完的事(签到、备份、发邮件),你全程盯着聊天的,纯定时触发不需要看进度的。这些直接用 cron 就够了。

简单判断:做完等结果就行的用 cron,需要知道跑到哪了的用 Workboard。

装起来试试

Workboard 默认是关的,要手动开:

1
2
3
openclaw plugins enable workboard
openclaw gateway restart
openclaw dashboard

Dashboard 打开后顶部会多出一个 Workboard Tab。如果显示不可用,跑一下 openclaw plugins inspect workboard --runtime --json 看看插件状态。

怎么用

Dashboard 里点 New Card,填标题、备注、优先级、标签,可以分配给某个 agent。卡片默认在 triage 列,拖到 ready 就能 dispatch。

新建卡片

卡片状态有这些:triage、backlog、todo、scheduled、ready、running、review、blocked、done。拖拽切换就行。

点卡片上的 Run 按钮就开始执行,卡片自动变 running。做完变 review,失败变 blocked。点卡片上的链接能直接跳到 session 看 agent 的对话。还有个 Stop 按钮,点了终止 session,卡片变 blocked。

CLI 也能操作:

1
2
3
4
5
openclaw workboard create "清理过期日志" --priority high --labels ops
openclaw workboard list
openclaw workboard list --status ready
openclaw workboard show 7f4a2c10
openclaw workboard dispatch

聊天渠道里可以用斜杠命令:/workboard list/workboard create 清理过期日志/workboard dispatch

一张卡片从头到尾

你在 Dashboard 建一张卡片,状态是 triage。拖到 ready,点 dispatch。Gateway 找到所有 ready 的卡片,给每张启动一个 worker agent。卡片变 running,agent 在后台干活。你可以点卡片看 session 对话。

agent 跑着跑着发现任务太大,自己调 workboard_decompose 拆出子卡片。子卡片走同样的流程。全部完成后父卡片自动推进。

agent 调 workboard_complete,卡片变 review。你看完没问题拖到 done。出问题了卡片自动变 blocked,处理完拖回 todo 重新来。

注意一点:你手动把卡片设成 review、blocked 或 done 之后,Workboard 就不会再自动移动这张卡片了,要你自己拖回去才行。

它不会自己帮你建卡片

Workboard 说到底是个被动工具。你发了一个复杂任务给 agent,它不会自己说”我帮你放到看板上”。所有卡片都要有人建——要么你手动建,要么 agent 调工具建。忘了建卡片,任务照样跑,只是你看不到进度。

想半自动化的话,有几个办法。Board 配了 autoDecompose,agent 执行中发现任务复杂会自己拆。用 cron 定时建卡片也行,比如每天早上自动建好当天的任务。还可以在 AGENTS.md 里写规则,告诉 agent 遇到多步骤任务就建 Workboard 卡片。不过说白了都是你先定规则,agent 再按规则执行,不是真正的”自动判断”。

跟 cron 的关系

Workboard 替代不了 cron。cron 管”什么时候跑”,Workboard 管”跑得怎么样”。签到、备份、发早报这种定时任务直接用 cron 就够了。Workboard 适合那些跑得久、要盯进度、可能出错的事。

两者也能配合:cron 定时建卡片然后 dispatch,既有定时触发又能看状态。

注意几点

  • 这东西只在单个 Gateway 上用,不是团队协作工具,多人的话还是 GitHub Issues 或 Linear
  • 卡片数据在 Gateway 的 SQLite 里,跟着状态目录走
  • dispatch 每轮最多启动 3 个 worker,同一个 agent 一轮只分一张卡片
  • 没有 ready 卡片时 dispatch 不会做任何事
  • 卡片和 session 双向关联,session 的生命周期会同步到卡片
  • agent 操作卡片需要 claim token,没 claim 的 agent 动不了别人的卡片