--- read_when: - Chcesz przeglądać lub tworzyć karty Workboard z terminala - Chcesz wysyłać uruchomienia workerów Workboard z CLI - Debugujesz zachowanie Workboard CLI lub polecenia slash summary: Dokumentacja referencyjna CLI dla kart `openclaw workboard`, dispatch i uruchomień workerów title: CLI tablicy roboczej x-i18n: generated_at: "2026-06-27T17:24:40Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: bb6f5ab36b3f1f4d0eb06e5dfa9adbbe9bb14bf2ac389630da7725811ac6f47f source_path: cli/workboard.md workflow: 16 --- `openclaw workboard` to powierzchnia terminalowa dla dołączonego [Plugin Workboard](/pl/plugins/workboard). Pozwala operatorowi wyświetlać karty, tworzyć kartę, sprawdzać jedną kartę i prosić działający Gateway o przekazanie gotowej pracy do uruchomień workerów subagentów. Włącz Plugin przed użyciem polecenia: ```bash openclaw plugins enable workboard openclaw gateway restart ``` ## Użycie ```bash openclaw workboard list [--board ] [--status ] [--include-archived] [--json] openclaw workboard create [--notes ] [--status ] [--priority ] [--agent ] [--board ] [--labels ] [--json] openclaw workboard show [--json] openclaw workboard dispatch [--url ] [--token ] [--timeout ] [--json] ``` Polecenie odczytuje i zapisuje tę samą bazę SQLite należącą do Plugin, której używają dashboard i narzędzia agenta Workboard. Identyfikatory kart można przekazywać jako pełny identyfikator albo jako jednoznaczny prefiks, gdy polecenie akceptuje identyfikator karty. ## `list` ```bash openclaw workboard list openclaw workboard list --board default --status ready openclaw workboard list --json ``` Wyjście tekstowe jest zwięzłe: ```text 7f4a2c10 ready high default agent-a Fix stale worker heartbeat ``` Kolumny to prefiks identyfikatora, status, priorytet, identyfikator tablicy, opcjonalny identyfikator agenta i tytuł. Flagi: | Flaga | Cel | | -------------------- | --------------------------------------------------------- | | `--board ` | Ogranicz wyniki do jednej przestrzeni nazw tablicy | | `--status ` | Ogranicz wyniki do jednego statusu Workboard | | `--include-archived` | Uwzględnij zarchiwizowane karty w zwięzłym wyjściu tekstowym | | `--json` | Wypisz pełną listę kart jako maszynowy JSON | Zwięzłe wyjście tekstowe domyślnie ukrywa zarchiwizowane karty, aby CLI odpowiadało poleceniu `/workboard list`. Przekaż `--include-archived`, aby je pokazać. Wyjście JSON zachowuje pełną listę kart, w tym zarchiwizowane karty, dla istniejącej automatyzacji. ## `create` ```bash openclaw workboard create "Fix stale worker heartbeat" --priority high --labels bug,workboard openclaw workboard create "Write Workboard docs" --status ready --agent docs-agent --board docs --notes "Cover CLI, slash command, dispatch, and SQLite state." ``` Flagi: | Flaga | Cel | | ----------------------- | ----------------------------------------------- | | `--notes ` | Początkowe notatki karty | | `--status ` | Początkowy status, domyślnie `todo` | | `--priority ` | Priorytet, domyślnie `normal` | | `--agent ` | Przypisz kartę do agenta lub identyfikatora właściciela | | `--board ` | Zapisz kartę w przestrzeni nazw tablicy | | `--labels ` | Etykiety rozdzielone przecinkami | | `--json` | Wypisz utworzoną kartę jako maszynowy JSON | `create` zapisuje bezpośrednio do stanu SQLite Workboard. Karta jest natychmiast widoczna na karcie Workboard w Control UI oraz dla narzędzi Workboard. ## `show` ```bash openclaw workboard show 7f4a2c10 openclaw workboard show 7f4a2c10 --json ``` Wyjście tekstowe wypisuje zwięzły wiersz karty i notatki. Wyjście JSON zwraca pełny rekord karty, w tym metadane wykonania, próby, komentarze, linki, dowody, artefakty, logi workerów, stan protokołu, diagnostykę i metadane automatyzacji. ## `dispatch` ```bash openclaw workboard dispatch openclaw workboard dispatch --json openclaw workboard dispatch --url http://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN" ``` `dispatch` najpierw wywołuje metodę RPC działającego Gateway `workboard.cards.dispatch`. Ta ścieżka używa tego samego runtime subagentów co akcja dispatch w dashboardzie, więc gotowe karty stają się śledzonymi zadaniami uruchomieniami workerów z powiązanymi kluczami sesji. Karty z przypisanym agentem używają kluczy sesji subagentów o zakresie agenta; nieprzypisane karty zachowują klucz subagenta bez zakresu, aby skonfigurowany domyślny agent Gateway został zachowany. Pętla dispatch: 1. Awansuje dzieci gotowe pod względem zależności do `ready`. 2. Blokuje wygasłe roszczenia lub uruchomienia workerów po przekroczeniu czasu. 3. Zapisuje metadane dispatch na gotowych kartach. 4. Wybiera małą partię nieprzypisanych gotowych kart. 5. Obejmuje roszczeniem każdą wybraną kartę dla dyspozytora lub przypisanego agenta. 6. Uruchamia workera subagenta z ograniczonym kontekstem karty i tokenem roszczenia karty. 7. Zapisuje na karcie identyfikator uruchomienia workera, klucz sesji, powiązanie zadania, gdy ledger zadań Gateway je zgłosi, status wykonania i log workera. Wybór jest celowo konserwatywny. Jeden dispatch domyślnie uruchamia najwyżej trzech workerów, pomija zarchiwizowane lub już objęte roszczeniem karty i w jednym przebiegu uruchamia tylko jedną kartę na właściciela lub agenta. Karty już posiadane przez aktywną pracę uruchomioną lub przeglądu pozostają do późniejszego dispatch. Jeśli uruchomienie workera nie powiedzie się po objęciu karty roszczeniem, Workboard blokuje tę kartę, czyści roszczenie i zapisuje błąd w metadanych wykonania karty oraz logu workera. Dzięki temu nieudane uruchomienia pozostają widoczne, zamiast po cichu wracać kartę do kolejki. Jeśli nie podano jawnego celu Gateway, a lokalny Gateway jest niedostępny albo jeszcze nie udostępnia metody dispatch Workboard, CLI przechodzi awaryjnie do dispatch opartego wyłącznie na danych względem lokalnego stanu Workboard. Dispatch wyłącznie na danych nadal może awansować zależności, czyścić nieaktualne roszczenia i blokować uruchomienia po przekroczeniu czasu, ale nie uruchamia workerów. Błędy uwierzytelniania, uprawnień, walidacji oraz błędy dla jawnego celu `--url` lub `--token` są zgłaszane bezpośrednio. Wyjście tekstowe raportuje uruchomienia workerów: ```text dispatch complete: started=2 failures=0 ``` Wyjście awaryjne jest jawne: ```text gateway unavailable; data dispatch only: promoted=1 blocked=0 ``` Wyjście JSON zawiera wynik dispatch. Dispatch oparty na Gateway może zawierać `started` i `startFailures`; awaryjny tryb wyłącznie na danych zawiera `gatewayUnavailable: true`. Tokeny roszczeń są redagowane z wyjścia JSON kart. W dashboardzie ten sam wynik dispatch jest pokazany jako krótkie podsumowanie, aby operator mógł zobaczyć, ile kart uruchomiono, awansowano, zablokowano, odzyskano lub zakończyło się błędem bez otwierania szczegółów kart. ## Zgodność poleceń slash Kanały obsługujące polecenia mogą używać odpowiadającego polecenia slash: ```text /workboard list /workboard show 7f4a2c10 /workboard create Fix stale worker heartbeat /workboard dispatch ``` Dispatch z polecenia slash również używa runtime subagentów Gateway, więc zachowuje to samo roszczenie, uruchamianie workerów i obsługę błędów co dashboard oraz ścieżka Gateway w CLI. `/workboard list` i `/workboard show` to polecenia odczytu dla autoryzowanych nadawców poleceń. `/workboard create` i `/workboard dispatch` modyfikują stan tablicy i wymagają statusu właściciela na powierzchniach czatu albo klienta Gateway z `operator.write` lub `operator.admin`. ## Uprawnienia Ścieżka dispatch w CLI wywołuje RPC Gateway z zakresami `operator.read` i `operator.write`. Token Gateway tylko do odczytu może sprawdzać dane Workboard przez metody odczytu, ale nie może tworzyć kart ani uruchamiać workerów. Lokalne polecenia `list`, `create` i `show` działają na lokalnym katalogu stanu OpenClaw używanym przez bieżący profil. Użyj `--dev` lub `--profile ` w poleceniu najwyższego poziomu `openclaw`, gdy potrzebujesz innego katalogu głównego stanu. ## Rozwiązywanie problemów ### Nie pojawiają się żadne karty Potwierdź, że Plugin jest włączony dla tego samego profilu i katalogu głównego stanu: ```bash openclaw plugins inspect workboard --runtime --json ``` Jeśli dashboard pokazuje karty, ale CLI nie, sprawdź, czy oba polecenia używają tego samego ustawienia `--dev` lub `--profile`. ### Dispatch zgłasza tryb wyłącznie na danych Uruchom lub zrestartuj Gateway: ```bash openclaw gateway restart openclaw gateway status --deep ``` Następnie ponów `openclaw workboard dispatch`. Awaryjny tryb wyłącznie na danych jest przydatny do czyszczenia lokalnego stanu, ale uruchomienia workerów wymagają działającego Gateway. ### Dispatch niczego nie uruchamia Sprawdź, czy istnieje co najmniej jedna karta `ready` bez aktywnego roszczenia: ```bash openclaw workboard list --status ready ``` Karty mogą być też pomijane, gdy ten sam właściciel ma już pracę uruchomioną lub w przeglądzie. Przenieś ukończoną pracę do `done`, zwolnij nieaktualne roszczenia przez narzędzia Workboard albo uruchom dispatch ponownie po zakończeniu aktywnego workera. ## Powiązane - [Plugin Workboard](/pl/plugins/workboard) - [Dokumentacja CLI](/pl/cli) - [Polecenia slash](/pl/tools/slash-commands) - [Control UI](/pl/web/control-ui)