OpenClaw Workboard 工作板完全使用指南

什么是 Workboard？

Workboard 是 OpenClaw 内置的 Kanban 风格看板插件，用于管理 AI 代理任务。它不是 Jira、Linear 这类项目管理工具的替代品，而是专注于 OpenClaw Gateway 内部的任务编排和代理工作流。

核心功能：创建任务卡片 → 分配给代理 → 自动派发执行 → 跟踪进度 → 审核完成。

需要多 Profile 吗？

不需要。 Workboard 是单 Gateway 实例级别的功能，只需一个 agent profile 即可使用。

启用 Workboard

方法一：CLI 命令

1openclaw plugins enable workboard
2openclaw gateway restart

方法二：直接修改配置

在 openclaw.json 的 plugins 部分添加：

 1{
 2  "plugins": {
 3    "allow": ["workboard"],
 4    "entries": {
 5      "workboard": {
 6        "enabled": true
 7      }
 8    }
 9  }
10}

然后重启 Gateway。

三种使用方式

1. Control UI（推荐）

打开 openclaw dashboard，导航栏会出现 Workboard 标签页。

• 创建卡片：点击列顶部的 “+” 按钮
• 拖拽卡片：在 Triage → Backlog → Todo → Ready → Running → Review → Done 之间拖拽
• 从卡片启动任务：点击卡片上的 “Run Codex” 或 “Run Claude”
• 链接会话：从 Sessions 页选择 “Add to Workboard”

2. CLI 命令

 1# 列出所有卡片
 2openclaw workboard list
 3
 4# 按状态筛选
 5openclaw workboard list --status ready
 6
 7# 创建卡片
 8openclaw workboard create "修复博客 SEO 问题" --priority high --labels bug,seo
 9
10# 查看卡片详情
11openclaw workboard show <card-id>
12
13# 派发就绪任务给子代理执行
14openclaw workboard dispatch

3. Slash 命令（Telegram/Discord 等聊天渠道）

1/workboard list
2/workboard show <card-id>
3/workboard create 修复博客 SEO 问题
4/workboard dispatch

卡片状态流转

1Triage → Backlog → Todo → Ready → Running → Review → Done
2                        ↑                |
3                        |    Blocked ←---+
4                        |                |
5                        +--- (修复后) ---+

Agent 工具一览

Workboard 注册了一系列工具，可以在对话中直接调用：

查看和创建

生命周期操作

依赖和编排

辅助操作

Dispatch 派发机制

dispatch 是 Workboard 的核心功能，它自动将就绪任务分配给子代理执行：

执行流程

1. 选择就绪卡片：按优先级、位置、创建时间排序
2. 最多启动 3 个 worker：每个 agent 同时只运行一个任务
3. 自动认领：为选中的卡片创建 claim，记录 session key
4. 启动子代理：发送卡片标题和上下文给子代理执行
5. 生命周期同步：子代理完成 → 卡片变 review；子代理失败 → 卡片变 blocked

选择规则

• 跳过已归档和已认领的卡片
• 跳过 owner 已有 running/review 任务的卡片
• 每次 dispatch 最多启动 3 个 worker
• 每个 owner/agent 每次只启动 1 个任务

实际使用示例

示例 1：创建一个简单任务

在聊天中告诉你的 AI 助手：

“在工作板上创建一个任务：更新博客的关于我们页面”

助手会调用 workboard_create 工具创建卡片。

示例 2：自动派发执行

1. 创建卡片并设置状态为 ready
2. 运行 openclaw workboard dispatch
3. Workboard 自动 claim 卡片，启动子代理执行
4. 子代理完成后，卡片自动进入 review 状态
5. 你审核后将卡片移至 done

示例 3：带依赖的任务链

 1# 创建父任务
 2创建 "Hugo 博客迁移到新主题" → card-abc
 3
 4# 创建子任务
 5创建 "下载并安装新主题" → card-123
 6创建 "调整 Hugo 配置" → card-456
 7创建 "测试所有页面" → card-789
 8
 9# 链接依赖
10link(parent=card-abc, child=card-123)
11link(parent=card-abc, child=card-456)
12link(parent=card-abc, child=card-789)

子任务按顺序执行，全部完成后父任务自动进入 done。

与组织架构配合

如果你像我一样有多个部门（blog、novel、audit 等），Workboard 可以这样用：

1Board: default
2├── [urgent]  修复博客 521 错误        → agent: blog
3├── [high]    写一篇 SEO 文章          → agent: blog
4├── [normal]  第三卷大纲设计           → agent: novel
5├── [low]     更新 README 文档         → unassigned
6└── [normal]  审核 Hugo 迁移结果       → agent: audit

通过 workboard_create 创建卡片时指定 agent id，然后通过 workboard_dispatch 自动派发。

常见问题

卡片创建后在哪里看？

打开 openclaw dashboard 的 Workboard 标签页，或者用 openclaw workboard list。

dispatch 说 “data-only” 是什么意思？

说明 Gateway 没有运行。运行 openclaw gateway restart 后重试。data-only 模式只能更新本地状态，不能启动子代理。

卡片一直没有被派发？

检查：

1. 卡片状态是否为 ready（不是 todo）
2. 是否有依赖未完成（父卡片不是 done）
3. 是否有同 owner 的任务正在运行

能给卡片添加附件吗？

可以，使用 workboard_attachment_add 工具。附件存储在 SQLite 中，支持文件名、内容和 MIME 类型。

总结