openclaw workboard 是内置 Workboard 插件的终端界面。操作员可通过它列出卡片、创建卡片、查看单张卡片，以及请求正在运行的 Gateway 网关将就绪工作分派为子智能体工作进程运行。
使用该命令前，请启用插件：
用法
status 值：triage、backlog、todo、scheduled、ready、running、review、blocked、done。有效的 priority 值：low、normal、high、urgent。
list
紧凑文本输出默认隐藏已归档卡片，使 CLI 与
/workboard list 保持一致。传入 --include-archived 可显示它们。为兼容现有自动化，JSON 输出始终保留完整卡片列表，包括已归档卡片。
create
create 直接写入 Workboard SQLite 状态。该卡片会立即显示在 Control UI 的 Workboard 标签页中，并可供 Workboard 工具使用。
show
passed 记录工作进程对所附命令或检查的
自我评估；它不是独立验证
结果。
move
move 使用与在仪表板中拖动卡片相同的手动操作员路径来更改卡片状态。它接受完整卡片 ID 或无歧义的前缀。有效的依赖项和计划暂停仍然适用。操作员无需智能体认领令牌即可移动已认领的卡片；认领令牌仍仅限用于智能体工具变更，并会从 JSON 输出中隐去。
dispatch
dispatch 首先调用正在运行的 Gateway 网关 RPC 方法 workboard.cards.dispatch，该方法使用与仪表板分派操作相同的子智能体运行时，因此就绪卡片会成为带有关联会话键、可进行任务跟踪的工作进程运行。--max-starts 使用增量添加的 workboard.cards.dispatchWithOptions 方法，因此较旧的 Gateway 网关会在启动任何工作进程之前拒绝该选项；升级后，请先重启 Gateway 网关再使用此标志。已分配智能体的卡片使用智能体范围的子智能体会话键；未分配的卡片保留无范围的子智能体键，从而保留 Gateway 网关中配置的默认智能体。
分派循环：
- 将依赖项已就绪的子卡片提升为
ready。 - 阻止认领已过期或工作进程运行已超时的卡片。
- 在就绪卡片上记录分派元数据。
- 选择一小批尚未认领的就绪卡片。
- 为分派器或已分配的智能体认领每张选中的卡片。
- 使用有限的卡片上下文和卡片认领令牌启动子智能体工作进程运行。
- 在卡片上存储工作进程运行 ID、会话键、Gateway 网关任务账本报告的任务关联、执行状态和工作进程日志。
--max-starts <count> 可更改每次处理的上限；每个所有者一张卡片的规则仍然适用，因此实际启动数量可能更少。
如果卡片被认领后工作进程启动失败，Workboard 会阻止该卡片、清除认领，并在卡片执行和工作进程日志元数据中记录失败，使启动失败保持可见，而不是悄悄将卡片放回队列。
如果未指定明确的 Gateway 网关目标，并且本地 Gateway 网关不可用或尚未公开 Workboard 分派方法，CLI 会回退为针对本地 Workboard 状态执行仅数据分派。仅数据分派仍可提升依赖项、清理过期认领并阻止超时运行，但不会启动工作进程。身份验证、权限和验证失败，以及明确指定 --url 或 --token 目标时发生的失败，会直接报告，而不会触发回退。
文本输出会报告工作进程启动情况：
started 和 startFailures；仅数据回退包含 gatewayUnavailable: true。认领令牌会从卡片 JSON 输出中隐去。
在仪表板中，同一分派结果会显示为简短摘要，使操作员无需打开卡片详情即可看到启动、提升、阻止、重新认领或失败的卡片数量。
与斜杠命令一致
支持命令的渠道可以使用对应的斜杠命令：/workboard list 和 /workboard show 是供已获授权的命令发送者使用的读取命令。/workboard create、/workboard move 和 /workboard dispatch 会更改看板状态，并要求聊天界面上的所有者身份，或要求 Gateway 网关客户端具有 operator.write 或 operator.admin。
权限
CLI 分派路径通常请求 Gateway 网关的operator.write 和 operator.read 权限范围。绑定工作区的卡片直接在精确配置的智能体工作区中运行；工作树请求会被限制到该目录，而不是允许主机实现由仓库控制的代码。选定的工作进程必须拥有对该精确工作区可写、非共享的 Docker 沙箱访问权限，具有与请求的挂载和策略匹配的实时容器哈希，并且不具备逃逸到主机的能力。传入 --admin 可明确请求 operator.admin、允许使用另一个主机检出，并使用常规的托管工作树设置；如果客户端未获批该权限范围，连接将失败。只读 Gateway 网关令牌可以通过读取方法查看 Workboard 数据，但不能创建卡片或分派工作进程。对于拥有 Workboard 更改权限的调用方，工作区限制不会以其他方式影响手动移动卡片。
本地 list、create、show 和 move 命令操作当前配置文件所使用的本地 OpenClaw 状态目录。需要使用其他状态根目录时，请在顶层 openclaw 命令中使用 --dev 或 --profile <name>。
故障排查
未显示任何卡片
确认已为同一配置文件和状态根目录启用插件：--dev 或 --profile 设置。
分派提示仅数据模式
启动或重启 Gateway 网关：openclaw workboard dispatch。仅数据回退适用于清理本地状态，但工作进程运行需要实时可用的 Gateway 网关。
分派未启动任何内容
检查是否至少有一张未被有效认领的ready 卡片：
done，通过 Workboard 工具释放过期认领，或在活动工作进程完成后再次运行分派。