openclaw workboard は、同梱の
Workboard Plugin 向けのターミナルサーフェスです。オペレーターはカードの一覧表示、カードの作成、1件のカードの確認、実行中の Gateway への準備完了作業のサブエージェントワーカー実行へのディスパッチ依頼を行えます。
コマンドを使う前に Plugin を有効にします。
使用方法
list
| フラグ | 目的 |
|---|---|
--board <id> | 結果を1つのボード名前空間に限定する |
--status <status> | 結果を1つの 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 状態に直接書き込みます。カードは Control UI の Workboard タブと Workboard ツールにすぐ表示されます。
show
dispatch
dispatch はまず、実行中の Gateway RPC メソッド workboard.cards.dispatch を呼び出します。この経路はダッシュボードのディスパッチアクションと同じサブエージェントランタイムを使うため、ready のカードはリンクされたセッションキーを持つタスク追跡対象のワーカー実行になります。エージェントが割り当てられているカードは、エージェントスコープのサブエージェントセッションキーを使います。未割り当てのカードは、Gateway に設定されたデフォルトエージェントが保持されるように、スコープなしのサブエージェントキーを維持します。
ディスパッチループ:
- 依存関係の準備が整った子カードを
readyに昇格する。 - 期限切れの claim またはタイムアウトしたワーカー実行をブロックする。
readyカードにディスパッチメタデータを記録する。- claim されていない
readyカードの小さなバッチを選択する。 - 選択された各カードをディスパッチャーまたは割り当て済みエージェントに claim する。
- 境界付けられたカードコンテキストとカード claim トークンでサブエージェントワーカー実行を開始する。
- Gateway タスク台帳が報告した場合は、ワーカー実行 ID、セッションキー、タスク連携、実行ステータス、ワーカーログをカードに保存する。
--url または --token ターゲットでの失敗は直接報告されます。
テキスト出力はワーカー開始を報告します。
started と startFailures が含まれることがあります。データのみのフォールバックには gatewayUnavailable: true が含まれます。claim トークンはカード JSON 出力から伏せられます。
ダッシュボードでは、同じディスパッチ結果が短い要約として表示されるため、オペレーターはカード詳細を開かずに、開始、昇格、ブロック、再 claim、失敗したカード数を確認できます。
スラッシュコマンドとの同等性
コマンド対応チャネルでは、対応するスラッシュコマンドを使用できます。/workboard list と /workboard show は、認可されたコマンド送信者向けの読み取りコマンドです。/workboard create と /workboard dispatch はボード状態を変更するため、チャットサーフェスでは所有者ステータスが必要であり、または operator.write か operator.admin を持つ Gateway クライアントが必要です。
権限
CLI ディスパッチ経路は、operator.read と operator.write スコープで Gateway RPC を呼び出します。読み取り専用の Gateway トークンは読み取りメソッドを通じて Workboard データを確認できますが、カードの作成やワーカーのディスパッチはできません。
ローカルの list、create、show コマンドは、現在のプロファイルが使うローカル OpenClaw 状態ディレクトリに対して動作します。別の状態ルートが必要な場合は、トップレベルの openclaw コマンドで --dev または --profile <name> を使います。
トラブルシューティング
カードが表示されない
同じプロファイルと状態ルートで Plugin が有効になっていることを確認します。--dev または --profile 設定を使っていることを確認します。
ディスパッチがデータのみと表示する
Gateway を開始または再起動します。openclaw workboard dispatch を再試行します。データのみのフォールバックはローカル状態のクリーンアップには有用ですが、ワーカー実行には稼働中の Gateway が必要です。
ディスパッチで何も開始されない
アクティブな claim がないready カードが少なくとも1つあるか確認します。
done に移動する、Workboard ツールで古い claim を解放する、またはアクティブなワーカーの終了後にディスパッチを再実行します。