openclaw workboard 是內建
Workboard 外掛的終端介面。它讓操作者列出卡片、建立
卡片、檢視單一卡片，並要求執行中的閘道將已就緒的工作分派到
子代理工作執行。
使用命令前請先啟用外掛：
使用方式
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> | 將卡片指派給代理或擁有者 id |
--board <id> | 將卡片儲存在看板命名空間 |
--labels <items> | 逗號分隔的標籤 |
--json | 以機器 JSON 列印已建立的卡片 |
create 會直接寫入 Workboard SQLite 狀態。卡片會立即顯示在控制介面的
Workboard 分頁中，也會立即提供給 Workboard 工具使用。
show
dispatch
dispatch 會先呼叫執行中閘道的 RPC 方法
workboard.cards.dispatch。該路徑使用與儀表板分派動作相同的子代理執行階段，
因此已就緒卡片會變成帶有任務追蹤的工作者執行，並連結工作階段金鑰。已指派代理的
卡片會使用代理範圍的子代理工作階段金鑰；未指派卡片會保留未限定範圍的子代理金鑰，
以保留閘道設定的預設代理。
分派迴圈：
- 將相依項目已就緒的子項提升為
ready。 - 封鎖已過期的宣告或逾時的工作者執行。
- 在已就緒卡片上記錄分派中繼資料。
- 選取一小批未宣告的已就緒卡片。
- 為分派器或已指派代理宣告每張選取的卡片。
- 使用受限的卡片情境與卡片宣告權杖啟動子代理工作者執行。
- 在卡片上儲存工作者執行 id、工作階段金鑰、閘道任務帳本回報時的任務連結、 執行狀態，以及工作者日誌。
--url 或 --token 目標的失敗會直接回報。
文字輸出會回報工作者啟動：
started 和 startFailures；純資料後援會包含
gatewayUnavailable: true。卡片 JSON 輸出中的宣告權杖會被遮蔽。
在儀表板中，同一個分派結果會以簡短摘要顯示，讓操作者不必開啟卡片詳細資料，就能看到
已啟動、提升、封鎖、重新宣告或失敗的卡片數量。
斜線命令對等性
支援命令的通道可以使用對應的斜線命令：/workboard list 和 /workboard show 是提供給已授權命令傳送者的讀取命令。
/workboard create 和 /workboard dispatch 會變更看板狀態，在聊天介面上需要擁有者身分，
或需要具備 operator.write 或 operator.admin 的閘道用戶端。
權限
命令列介面分派路徑會以operator.read 和
operator.write 範圍呼叫閘道 RPC。唯讀閘道權杖可以透過讀取方法檢視 Workboard 資料，
但不能建立卡片或分派工作者。
本機 list、create 和 show 命令會操作目前設定檔使用的本機 OpenClaw 狀態目錄。
需要不同狀態根目錄時，請在頂層 openclaw 命令上使用 --dev 或 --profile <name>。
疑難排解
沒有顯示卡片
確認外掛已針對相同設定檔與狀態根目錄啟用：--dev 或 --profile 設定。
分派顯示純資料
啟動或重新啟動閘道：openclaw workboard dispatch。純資料後援適合本機狀態清理，但工作者執行需要
即時閘道。
分派沒有啟動任何項目
檢查至少有一張沒有作用中宣告的ready 卡片：
done，透過 Workboard 工具釋放過期宣告，或在作用中工作者完成後再次執行分派。