openclaw workboard — это терминальный интерфейс встроенного плагина Workboard. Он позволяет оператору выводить список карточек, создавать карточку, просматривать отдельную карточку и поручать работающему Gateway запуск готовых задач в рабочих запусках субагентов.
Перед использованием команды включите плагин:
Использование
status: triage, backlog, todo, scheduled, ready, running, review, blocked, done. Допустимые значения priority: low, normal, high, urgent.
list
По умолчанию компактный текстовый вывод скрывает архивированные карточки, чтобы CLI соответствовал
/workboard list. Чтобы показать их, передайте --include-archived. Вывод JSON всегда содержит полный список карточек, включая архивированные, для совместимости с существующей автоматизацией.
create
create выполняет запись непосредственно в состояние SQLite Workboard. Карточка сразу становится видна на вкладке Workboard в Control UI и инструментам Workboard.
show
move
move изменяет статус карточки тем же ручным операторским способом, что и перетаскивание карточки на панели управления. Принимается полный идентификатор карточки или его однозначный префикс. Активные блокировки из-за зависимостей и расписания продолжают действовать. Операторы могут перемещать занятую карточку без токена закрепления её агента; токены закрепления по-прежнему применяются только к изменениям через инструменты агента и удаляются из вывода JSON.
dispatch
dispatch вызывает у работающего Gateway метод RPC workboard.cards.dispatch, который использует ту же среду выполнения субагентов, что и действие запуска на панели управления, поэтому готовые карточки превращаются в отслеживаемые как задачи рабочие запуски со связанными ключами сеансов. --max-starts использует добавочный метод workboard.cards.dispatchWithOptions, поэтому более старый Gateway отклоняет этот параметр до запуска каких-либо рабочих процессов; после обновления перезапустите Gateway, прежде чем использовать флаг. Карточки с назначенным агентом используют ключи сеансов субагентов в области агента; неназначенные карточки сохраняют ключ субагента без области, чтобы использовался настроенный в Gateway агент по умолчанию.
Цикл запуска:
- Переводит дочерние карточки с выполненными зависимостями в
ready. - Блокирует просроченные закрепления или рабочие запуски с истёкшим временем ожидания.
- Записывает метаданные запуска в готовые карточки.
- Выбирает небольшую группу незакреплённых готовых карточек.
- Закрепляет каждую выбранную карточку за диспетчером или назначенным агентом.
- Запускает рабочий процесс субагента с ограниченным контекстом карточки и токеном закрепления карточки.
- Сохраняет в карточке идентификатор рабочего запуска, ключ сеанса, связь с задачей, если её сообщает реестр задач Gateway, статус выполнения и журнал рабочего процесса.
--max-starts <count> с положительным целым числом, чтобы изменить ограничение на проход; правило одной карточки на владельца продолжает действовать, поэтому фактическое количество запусков может быть меньше.
Если запуск рабочего процесса завершается ошибкой после закрепления карточки, 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 обычно запрашивает области Gatewayoperator.write и operator.read. Карточки, привязанные к рабочему пространству, выполняются непосредственно в точно настроенном рабочем пространстве агента; запрос рабочего дерева ограничивается этим каталогом и не позволяет хосту материализовать управляемый репозиторием код. Выбранный рабочий процесс должен иметь доступ на запись к изолированной, не общей песочнице Docker для этого точного рабочего пространства, актуальный хеш контейнера, соответствующий запрошенным точкам монтирования и политике, и не иметь возможности выхода на хост. Передайте --admin, чтобы явно запросить operator.admin, разрешить другое рабочее дерево на хосте и использовать обычную настройку управляемого рабочего дерева; подключение завершится ошибкой, если эта область не одобрена для клиента. Токен Gateway только для чтения может просматривать данные Workboard через методы чтения, но не может создавать карточки или запускать рабочие процессы. В остальных случаях ограничения рабочего пространства не влияют на ручное перемещение карточек вызывающими сторонами с разрешением на изменение Workboard.
Локальные команды list, create, show и move работают с локальным каталогом состояния OpenClaw, используемым текущим профилем. Если требуется другой корень состояния, используйте --dev или --profile <name> в команде верхнего уровня openclaw.
Устранение неполадок
Карточки не отображаются
Убедитесь, что плагин включён для того же профиля и корня состояния:--dev или --profile.
Запуск сообщает о режиме только с данными
Запустите или перезапустите Gateway:openclaw workboard dispatch. Резервный режим только с данными полезен для очистки локального состояния, но для рабочих запусков необходим работающий Gateway.
Запуск ничего не запускает
Проверьте наличие хотя бы одной карточкиready без активного закрепления:
done, освободите устаревшие закрепления с помощью инструментов Workboard или снова выполните запуск после завершения активного рабочего процесса.