openclaw workboard 是内置 Workboard 插件的终端界面。它让操作员列出卡片、创建卡片、查看单张卡片，并请求正在运行的 Gateway 网关将已就绪的工作分派到子智能体 worker 运行中。
使用该命令前先启用插件：
用法
status 值：triage、backlog、todo、scheduled、ready、running、review、blocked、done。有效的 priority 值：low、normal、high、urgent。
list
| 标志 | 用途 |
|---|---|
--board <id> | 将结果限制为一个看板命名空间 |
--status <status> | 将结果限制为一种 Workboard 状态 |
--include-archived | 在紧凑文本输出中包含已归档卡片 |
--json | 以机器 JSON 打印完整卡片列表 |
/workboard list 保持一致。传入 --include-archived 可显示它们。JSON 输出始终保留完整卡片列表，包括已归档卡片，以兼容现有自动化。
create
| 标志 | 用途 |
|---|---|
--notes <text> | 初始卡片备注 |
--status <status> | 初始状态，默认 todo |
--priority <priority> | 优先级，默认 normal |
--agent <id> | 将卡片分配给智能体或 owner id |
--board <id> | 将卡片存储到看板命名空间 |
--labels <items> | 逗号分隔的标签 |
--json | 以机器 JSON 打印创建的卡片 |
create 会直接写入 Workboard SQLite 状态。该卡片会立即出现在 Control UI 的 Workboard 标签页和 Workboard 工具中。
show
dispatch
dispatch 首先调用正在运行的 Gateway 网关 RPC 方法 workboard.cards.dispatch，该方法使用与仪表板分派操作相同的子智能体运行时，因此已就绪卡片会变成带任务跟踪的 worker 运行，并链接会话键。已分配智能体的卡片会使用智能体范围的子智能体会话键；未分配卡片会保留无范围子智能体键，以便保留 Gateway 网关配置的默认智能体。
分派循环会：
- 将依赖已就绪的子卡片提升为
ready。 - 阻塞过期认领或超时的 worker 运行。
- 在已就绪卡片上记录分派元数据。
- 选择一小批未认领的已就绪卡片。
- 为分派器或已分配智能体认领每张选中的卡片。
- 使用有界卡片上下文和卡片认领令牌启动子智能体 worker 运行。
- 在卡片上存储 worker 运行 id、会话键、Gateway 网关任务账本报告时的任务链接、执行状态和 worker 日志。
--url 或 --token 目标的失败，会直接报告，而不会触发回退。
文本输出会报告 worker 启动情况：
started 和 startFailures；仅数据回退包含 gatewayUnavailable: true。卡片 JSON 输出中会隐去认领令牌。
在仪表板中，同一分派结果会显示为简短摘要，让操作员无需打开卡片详情即可看到启动、提升、阻塞、重新认领或失败的卡片数量。
斜杠命令对等性
支持命令的渠道可以使用对应的斜杠命令：/workboard list 和 /workboard show 是授权命令发送者可用的读取命令。/workboard create 和 /workboard dispatch 会修改看板状态，并且在聊天界面上需要 owner 身份，或需要具有 operator.write 或 operator.admin 的 Gateway 网关客户端。
权限
CLI 分派路径使用operator.read 和 operator.write 权限范围调用 Gateway 网关 RPC。只读 Gateway 网关令牌可以通过读取方法查看 Workboard 数据，但不能创建卡片或分派 worker。
本地 list、create 和 show 命令会操作当前配置文件使用的本地 OpenClaw 状态目录。当需要不同的状态根目录时，请在顶层 openclaw 命令上使用 --dev 或 --profile <name>。
故障排查
没有显示卡片
确认该插件已为同一配置文件和状态根目录启用：--dev 或 --profile 设置。
分派提示仅数据
启动或重启 Gateway 网关：openclaw workboard dispatch。仅数据回退对本地状态清理很有用，但 worker 运行需要可用的实时 Gateway 网关。
分派未启动任何内容
检查是否至少有一张没有活跃认领的ready 卡片：
done，通过 Workboard 工具释放陈旧认领，或在活跃 worker 完成后再次运行分派。