CLI рабочей панели

openclaw workboard — терминальный интерфейс для встроенного Plugin Workboard. Он позволяет оператору выводить список карточек, создавать карточку, просматривать одну карточку и просить запущенный Gateway отправить готовую работу в запуски рабочих субагентов.

Включите Plugin перед использованием команды:

openclaw plugins enable workboardopenclaw gateway restart

Использование

openclaw workboard list [--board <id>] [--status <status>] [--include-archived] [--json]openclaw workboard create <title...> [--notes <text>] [--status <status>] [--priority <priority>] [--agent <id>] [--board <id>] [--labels <items>] [--json]openclaw workboard show <id> [--json]openclaw workboard dispatch [--url <url>] [--token <token>] [--timeout <ms>] [--json]

Команда читает и записывает ту же принадлежащую Plugin базу данных SQLite, которую используют панель управления и инструменты агента Workboard. Идентификаторы карточек можно передавать как полный идентификатор или как однозначный префикс, когда команда принимает идентификатор карточки.

list

openclaw workboard listopenclaw workboard list --board default --status readyopenclaw workboard list --json

Текстовый вывод компактный:

7f4a2c10  ready     high    default agent-a  Fix stale worker heartbeat

Столбцы: префикс идентификатора, статус, приоритет, идентификатор доски, необязательный идентификатор агента и заголовок.

Флаги:

Компактный текстовый вывод по умолчанию скрывает архивные карточки, чтобы CLI соответствовал команде /workboard list. Передайте --include-archived, чтобы показать их. JSON-вывод сохраняет полный список карточек, включая архивные карточки, для существующей автоматизации.

create

openclaw workboard create "Fix stale worker heartbeat" --priority high --labels bug,workboardopenclaw workboard create "Write Workboard docs" --status ready --agent docs-agent --board docs --notes "Cover CLI, slash command, dispatch, and SQLite state."

Флаги:

create записывает напрямую в SQLite-состояние Workboard. Карточка сразу становится видимой на вкладке Workboard в Control UI и для инструментов Workboard.

show

openclaw workboard show 7f4a2c10openclaw workboard show 7f4a2c10 --json

Текстовый вывод печатает компактную строку карточки и заметки. JSON-вывод возвращает полную запись карточки, включая метаданные выполнения, попытки, комментарии, ссылки, доказательства, артефакты, журналы воркера, состояние протокола, диагностику и метаданные автоматизации.

dispatch

openclaw workboard dispatchopenclaw workboard dispatch --jsonopenclaw 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 сообщаются напрямую.

Текстовый вывод сообщает о запусках воркеров:

dispatch complete: started=2 failures=0

Вывод отката явно указывает это:

gateway unavailable; data dispatch only: promoted=1 blocked=0

JSON-вывод включает результат отправки. Отправка через Gateway может включать started и startFailures; откат только к данным включает gatewayUnavailable: true. Токены заявок редактируются из JSON-вывода карточек.

В панели управления тот же результат отправки показывается как краткая сводка, чтобы оператор мог видеть, сколько карточек запущено, повышено, заблокировано, возвращено или завершилось с ошибкой, не открывая подробности карточки.

Паритет слэш-команд

Каналы с поддержкой команд могут использовать соответствующую слэш-команду:

/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 <name> в команде верхнего уровня openclaw, когда нужен другой корень состояния.

Устранение неполадок

Карточки не появляются

Подтвердите, что Plugin включен для того же профиля и корня состояния:

openclaw plugins inspect workboard --runtime --json

Если панель управления показывает карточки, а CLI — нет, проверьте, что обе команды используют одну и ту же настройку --dev или --profile.

Отправка сообщает о режиме только данных

Запустите или перезапустите Gateway:

openclaw gateway restartopenclaw gateway status --deep

Затем повторите openclaw workboard dispatch. Откат только к данным полезен для локальной очистки состояния, но для запусков воркеров нужен работающий Gateway.

Отправка ничего не запускает

Проверьте, что есть хотя бы одна карточка ready без активной заявки:

openclaw workboard list --status ready

Карточки также могут пропускаться, когда у того же владельца уже есть выполняющаяся работа или работа на проверке. Переместите завершенную работу в done, освободите устаревшие заявки через инструменты Workboard или снова запустите отправку после завершения активного воркера.

Связанные материалы

• Plugin Workboard
• Справочник CLI
• Слэш-команды
• Control UI