> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # CLI рабочей панели `openclaw workboard` — терминальный интерфейс для встроенного [Plugin Workboard](/ru/plugins/workboard). Он позволяет оператору выводить список карточек, создавать карточку, просматривать одну карточку и просить запущенный Gateway отправить готовую работу в запуски рабочих субагентов. Включите Plugin перед использованием команды: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins enable workboard openclaw gateway restart ``` ## Использование ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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] ``` Команда читает и записывает ту же принадлежащую Plugin базу данных SQLite, которую используют панель управления и инструменты агента Workboard. Идентификаторы карточек можно передавать как полный идентификатор или как однозначный префикс, когда команда принимает идентификатор карточки. ## `list` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw workboard list openclaw workboard list --board default --status ready openclaw workboard list --json ``` Текстовый вывод компактный: ```text theme={"theme":{"light":"min-light","dark":"min-dark"}} 7f4a2c10 ready high default agent-a Fix stale worker heartbeat ``` Столбцы: префикс идентификатора, статус, приоритет, идентификатор доски, необязательный идентификатор агента и заголовок. Флаги: | Флаг | Назначение | | -------------------- | ------------------------------------------------------- | | `--board ` | Ограничить результаты одним пространством имен доски | | `--status ` | Ограничить результаты одним статусом Workboard | | `--include-archived` | Включить архивные карточки в компактный текстовый вывод | | `--json` | Вывести полный список карточек как машинный JSON | Компактный текстовый вывод по умолчанию скрывает архивные карточки, чтобы CLI соответствовал команде `/workboard list`. Передайте `--include-archived`, чтобы показать их. JSON-вывод сохраняет полный список карточек, включая архивные карточки, для существующей автоматизации. ## `create` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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." ``` Флаги: | Флаг | Назначение | | ----------------------- | ------------------------------------------------------ | | `--notes ` | Начальные заметки карточки | | `--status ` | Начальный статус, по умолчанию `todo` | | `--priority ` | Приоритет, по умолчанию `normal` | | `--agent ` | Назначить карточку агенту или идентификатору владельца | | `--board ` | Сохранить карточку в пространстве имен доски | | `--labels ` | Метки, разделенные запятыми | | `--json` | Вывести созданную карточку как машинный JSON | `create` записывает напрямую в SQLite-состояние Workboard. Карточка сразу становится видимой на вкладке Workboard в Control UI и для инструментов Workboard. ## `show` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw workboard show 7f4a2c10 openclaw workboard show 7f4a2c10 --json ``` Текстовый вывод печатает компактную строку карточки и заметки. JSON-вывод возвращает полную запись карточки, включая метаданные выполнения, попытки, комментарии, ссылки, доказательства, артефакты, журналы воркера, состояние протокола, диагностику и метаданные автоматизации. ## `dispatch` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw workboard dispatch openclaw workboard dispatch --json openclaw workboard dispatch --url http://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN" ``` `dispatch` сначала вызывает RPC-метод запущенного Gateway `workboard.cards.dispatch`. Этот путь использует тот же runtime субагентов, что и действие отправки в панели управления, поэтому готовые карточки становятся отслеживаемыми как задачи запусками воркеров со связанными ключами сессий. Карточки с назначенным агентом используют ключи сессий субагента в области агента; неназначенные карточки сохраняют ключ субагента без области, чтобы настроенный в Gateway агент по умолчанию сохранялся. Цикл отправки: 1. Повышает дочерние элементы с готовыми зависимостями до `ready`. 2. Блокирует истекшие заявки или запуски воркеров, превысившие время ожидания. 3. Записывает метаданные отправки в готовые карточки. 4. Выбирает небольшой пакет незаявленных готовых карточек. 5. Заявляет каждую выбранную карточку для диспетчера или назначенного агента. 6. Запускает рабочий запуск субагента с ограниченным контекстом карточки и токеном заявки карточки. 7. Сохраняет в карточке идентификатор запуска воркера, ключ сессии, связь с задачей, когда журнал задач Gateway сообщает о ней, статус выполнения и журнал воркера. Выбор намеренно консервативен. Одна отправка по умолчанию запускает не более трех воркеров, пропускает архивные или уже заявленные карточки и запускает только одну карточку на владельца или агента за один проход. Карточки, уже принадлежащие активной выполняющейся работе или работе на проверке, остаются для последующей отправки. Если запуск воркера завершается ошибкой после того, как карточка заявлена, Workboard блокирует эту карточку, очищает заявку и записывает сбой в метаданные выполнения карточки и журнала воркера. Так неудачные запуски остаются видимыми, а не молча возвращаются в очередь. Если явная цель Gateway не указана, а локальный Gateway недоступен или еще не предоставляет метод отправки Workboard, CLI откатывается к отправке только данных по локальному состоянию Workboard. Отправка только данных все еще может повышать зависимости, очищать устаревшие заявки и блокировать запуски, превысившие время ожидания, но она не запускает воркеров. Ошибки аутентификации, разрешений, валидации и ошибки для явной цели `--url` или `--token` сообщаются напрямую. Текстовый вывод сообщает о запусках воркеров: ```text theme={"theme":{"light":"min-light","dark":"min-dark"}} dispatch complete: started=2 failures=0 ``` Вывод отката явно указывает это: ```text theme={"theme":{"light":"min-light","dark":"min-dark"}} gateway unavailable; data dispatch only: promoted=1 blocked=0 ``` JSON-вывод включает результат отправки. Отправка через Gateway может включать `started` и `startFailures`; откат только к данным включает `gatewayUnavailable: true`. Токены заявок редактируются из JSON-вывода карточек. В панели управления тот же результат отправки показывается как краткая сводка, чтобы оператор мог видеть, сколько карточек запущено, повышено, заблокировано, возвращено или завершилось с ошибкой, не открывая подробности карточки. ## Паритет слэш-команд Каналы с поддержкой команд могут использовать соответствующую слэш-команду: ```text theme={"theme":{"light":"min-light","dark":"min-dark"}} /workboard list /workboard show 7f4a2c10 /workboard create Fix stale worker heartbeat /workboard dispatch ``` Отправка через слэш-команду также использует runtime субагентов Gateway, поэтому она следует тому же поведению заявок, запуска воркеров и сбоев, что и путь Gateway в панели управления и CLI. `/workboard list` и `/workboard show` — команды чтения для авторизованных отправителей команд. `/workboard create` и `/workboard dispatch` изменяют состояние доски и требуют статуса владельца на чат-поверхностях или клиента Gateway с `operator.write` или `operator.admin`. ## Разрешения Путь отправки CLI вызывает RPC Gateway с областями `operator.read` и `operator.write`. Токен Gateway только для чтения может просматривать данные Workboard через методы чтения, но не может создавать карточки или отправлять воркеров. Локальные команды `list`, `create` и `show` работают с локальным каталогом состояния OpenClaw, который использует текущий профиль. Используйте `--dev` или `--profile ` в команде верхнего уровня `openclaw`, когда нужен другой корень состояния. ## Устранение неполадок ### Карточки не появляются Подтвердите, что Plugin включен для того же профиля и корня состояния: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins inspect workboard --runtime --json ``` Если панель управления показывает карточки, а CLI — нет, проверьте, что обе команды используют одну и ту же настройку `--dev` или `--profile`. ### Отправка сообщает о режиме только данных Запустите или перезапустите Gateway: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw gateway restart openclaw gateway status --deep ``` Затем повторите `openclaw workboard dispatch`. Откат только к данным полезен для локальной очистки состояния, но для запусков воркеров нужен работающий Gateway. ### Отправка ничего не запускает Проверьте, что есть хотя бы одна карточка `ready` без активной заявки: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw workboard list --status ready ``` Карточки также могут пропускаться, когда у того же владельца уже есть выполняющаяся работа или работа на проверке. Переместите завершенную работу в `done`, освободите устаревшие заявки через инструменты Workboard или снова запустите отправку после завершения активного воркера. ## Связанные материалы * [Plugin Workboard](/ru/plugins/workboard) * [Справочник CLI](/ru/cli) * [Слэш-команды](/ru/tools/slash-commands) * [Control UI](/ru/web/control-ui)