openclaw workboard는 번들로 제공되는 Workboard Plugin의 터미널 표면입니다. 운영자는 이를 사용해 카드를 나열하고, 카드를 만들고, 카드 하나를 검사하며, 실행 중인 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> | 카드를 에이전트 또는 소유자 ID에 할당 |
--board <id> | 카드를 보드 네임스페이스에 저장 |
--labels <items> | 쉼표로 구분된 레이블 |
--json | 생성된 카드를 기계용 JSON으로 출력 |
create는 Workboard SQLite 상태에 직접 씁니다. 카드는 Control UI Workboard 탭과 Workboard 도구에 즉시 표시됩니다.
show
dispatch
dispatch는 먼저 실행 중인 Gateway RPC 메서드 workboard.cards.dispatch를 호출합니다. 이 경로는 대시보드 디스패치 작업과 동일한 하위 에이전트 런타임을 사용하므로, 준비된 카드는 연결된 세션 키가 있는 작업 추적 작업자 실행이 됩니다. 에이전트가 할당된 카드는 에이전트 범위 하위 에이전트 세션 키를 사용하고, 할당되지 않은 카드는 범위가 지정되지 않은 하위 에이전트 키를 유지하여 Gateway에 구성된 기본 에이전트가 보존되도록 합니다.
디스패치 루프:
- 종속성이 준비된 하위 카드를
ready로 승격합니다. - 만료된 클레임 또는 시간 초과된 작업자 실행을 차단합니다.
- 준비된 카드에 디스패치 메타데이터를 기록합니다.
- 클레임되지 않은 준비 카드의 작은 배치를 선택합니다.
- 선택된 각 카드를 디스패처 또는 할당된 에이전트에 대해 클레임합니다.
- 제한된 카드 컨텍스트와 카드 클레임 토큰으로 하위 에이전트 작업자 실행을 시작합니다.
- Gateway 작업 원장이 보고할 때 작업자 실행 ID, 세션 키, 작업 연결, 실행 상태, 작업자 로그를 카드에 저장합니다.
--url 또는 --token 대상의 실패는 직접 보고됩니다.
텍스트 출력은 작업자 시작을 보고합니다.
started 및 startFailures가 포함될 수 있고, 데이터 전용 대체에는 gatewayUnavailable: true가 포함됩니다. 클레임 토큰은 카드 JSON 출력에서 수정 처리됩니다.
대시보드에서는 동일한 디스패치 결과가 짧은 요약으로 표시되므로, 운영자는 카드 세부 정보를 열지 않고도 몇 개의 카드가 시작, 승격, 차단, 회수 또는 실패했는지 확인할 수 있습니다.
슬래시 명령 동등성
명령을 지원하는 채널은 일치하는 슬래시 명령을 사용할 수 있습니다./workboard list와 /workboard show는 권한이 있는 명령 발신자를 위한 읽기 명령입니다. /workboard create와 /workboard dispatch는 보드 상태를 변경하며, 채팅 표면에서는 소유자 상태가 필요하고 Gateway 클라이언트에서는 operator.write 또는 operator.admin이 필요합니다.
권한
CLI 디스패치 경로는operator.read 및 operator.write 범위로 Gateway RPC를 호출합니다. 읽기 전용 Gateway 토큰은 읽기 메서드를 통해 Workboard 데이터를 검사할 수 있지만, 카드를 만들거나 작업자를 디스패치할 수는 없습니다.
로컬 list, create, show 명령은 현재 프로필이 사용하는 로컬 OpenClaw 상태 디렉터리에서 동작합니다. 다른 상태 루트가 필요하면 최상위 openclaw 명령에서 --dev 또는 --profile <name>을 사용하세요.
문제 해결
카드가 나타나지 않음
동일한 프로필과 상태 루트에 대해 Plugin이 활성화되어 있는지 확인하세요.--dev 또는 --profile 설정을 사용하는지 확인하세요.
디스패치가 데이터 전용이라고 표시됨
Gateway를 시작하거나 다시 시작하세요.openclaw workboard dispatch를 다시 시도하세요. 데이터 전용 대체는 로컬 상태 정리에 유용하지만, 작업자 실행에는 활성 Gateway가 필요합니다.
디스패치가 아무것도 시작하지 않음
활성 클레임이 없는ready 카드가 하나 이상 있는지 확인하세요.
done으로 이동하고, Workboard 도구를 통해 오래된 클레임을 해제하거나, 활성 작업자가 완료된 후 디스패치를 다시 실행하세요.