openclaw workboard — терминальный интерфейс для встроенного
Plugin Workboard. Он позволяет оператору выводить список карточек, создавать
карточку, просматривать одну карточку и просить запущенный Gateway отправить готовую работу в
запуски рабочих субагентов.
Включите Plugin перед использованием команды:
Использование
list
| Флаг | Назначение |
|---|---|
--board <id> | Ограничить результаты одним пространством имен доски |
--status <status> | Ограничить результаты одним статусом Workboard |
--include-archived | Включить архивные карточки в компактный текстовый вывод |
--json | Вывести полный список карточек как машинный JSON |
/workboard list. Передайте --include-archived, чтобы показать их. JSON-вывод
сохраняет полный список карточек, включая архивные карточки, для существующей автоматизации.
create
| Флаг | Назначение |
|---|---|
--notes <text> | Начальные заметки карточки |
--status <status> | Начальный статус, по умолчанию todo |
--priority <priority> | Приоритет, по умолчанию normal |
--agent <id> | Назначить карточку агенту или идентификатору владельца |
--board <id> | Сохранить карточку в пространстве имен доски |
--labels <items> | Метки, разделенные запятыми |
--json | Вывести созданную карточку как машинный JSON |
create записывает напрямую в SQLite-состояние Workboard. Карточка сразу
становится видимой на вкладке Workboard в Control UI и для инструментов Workboard.
show
dispatch
dispatch сначала вызывает RPC-метод запущенного Gateway
workboard.cards.dispatch. Этот путь использует тот же runtime субагентов, что и
действие отправки в панели управления, поэтому готовые карточки становятся отслеживаемыми как задачи запусками воркеров
со связанными ключами сессий. Карточки с назначенным агентом используют ключи сессий субагента
в области агента; неназначенные карточки сохраняют ключ субагента без области, чтобы
настроенный в Gateway агент по умолчанию сохранялся.
Цикл отправки:
- Повышает дочерние элементы с готовыми зависимостями до
ready. - Блокирует истекшие заявки или запуски воркеров, превысившие время ожидания.
- Записывает метаданные отправки в готовые карточки.
- Выбирает небольшой пакет незаявленных готовых карточек.
- Заявляет каждую выбранную карточку для диспетчера или назначенного агента.
- Запускает рабочий запуск субагента с ограниченным контекстом карточки и токеном заявки карточки.
- Сохраняет в карточке идентификатор запуска воркера, ключ сессии, связь с задачей, когда журнал задач Gateway сообщает о ней, статус выполнения и журнал воркера.
--url или --token сообщаются напрямую.
Текстовый вывод сообщает о запусках воркеров:
started и startFailures; откат только к данным включает
gatewayUnavailable: true. Токены заявок редактируются из JSON-вывода карточек.
В панели управления тот же результат отправки показывается как краткая сводка, чтобы
оператор мог видеть, сколько карточек запущено, повышено, заблокировано, возвращено или
завершилось с ошибкой, не открывая подробности карточки.
Паритет слэш-команд
Каналы с поддержкой команд могут использовать соответствующую слэш-команду:/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 включен для того же профиля и корня состояния:--dev или --profile.
Отправка сообщает о режиме только данных
Запустите или перезапустите Gateway:openclaw workboard dispatch. Откат только к данным полезен для локальной
очистки состояния, но для запусков воркеров нужен работающий Gateway.
Отправка ничего не запускает
Проверьте, что есть хотя бы одна карточкаready без активной заявки:
done, освободите устаревшие заявки через инструменты Workboard
или снова запустите отправку после завершения активного воркера.