openclaw workboard は、同梱の Workboard Plugin 用ターミナルインターフェースです。オペレーターは、カードの一覧表示、カードの作成、個別カードの確認、および実行中の Gateway に対する準備済み作業のサブエージェントワーカー実行へのディスパッチ要求を行えます。
コマンドを使用する前に Plugin を有効にします。
使用方法
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> を渡します。所有者ごとに 1 枚という規則は引き続き適用されるため、実際の開始数はこれより少なくなる場合があります。
カードがクレームされた後にワーカーの開始に失敗した場合、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 サンドボックスアクセス、要求されたマウントおよびポリシーと一致する稼働中のコンテナハッシュが必要であり、ホストへの脱出機能があってはなりません。operator.admin を明示的に要求し、別のホストチェックアウトを許可して、通常の管理対象ワークツリー設定を使用するには --admin を渡します。そのスコープがクライアントに対して承認されていない場合、接続は失敗します。読み取り専用の Gateway トークンは読み取りメソッドを通じて Workboard データを確認できますが、カードの作成やワーカーのディスパッチはできません。Workboard の変更権限を持つ呼び出し元による手動のカード移動については、ワークスペースの制限によるその他の変更はありません。
ローカルの list、create、show、move コマンドは、現在のプロファイルが使用するローカル OpenClaw 状態ディレクトリを操作します。別の状態ルートが必要な場合は、最上位の openclaw コマンドで --dev または --profile <name> を使用します。
トラブルシューティング
カードが表示されない
同じプロファイルおよび状態ルートで Plugin が有効になっていることを確認します。--dev または --profile 設定を使用していることを確認してください。
データのみとディスパッチに表示される
Gateway を起動または再起動します。openclaw workboard dispatch を再試行します。データのみのフォールバックはローカル状態のクリーンアップに便利ですが、ワーカー実行には稼働中の Gateway が必要です。
ディスパッチで何も開始されない
アクティブなクレームがないready カードが少なくとも 1 枚あることを確認します。
done に移動するか、Workboard ツールで古いクレームを解除するか、アクティブなワーカーの終了後にディスパッチを再実行します。