Task Flow는 백그라운드 작업 위에 위치하는 플로 오케스트레이션 기반입니다. 개별 작업은 분리된 작업의 단위로 유지하면서, 자체 상태, 리비전 추적, 동기화 의미 체계를 가진 내구성 있는 다단계 플로를 관리합니다.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Task Flow를 사용할 때
작업이 여러 순차 단계나 분기 단계에 걸쳐 있고 Gateway 재시작 후에도 내구성 있는 진행 상황 추적이 필요할 때 Task Flow를 사용하세요. 단일 백그라운드 작업에는 일반 작업으로 충분합니다.| 시나리오 | 사용 |
|---|---|
| 단일 백그라운드 작업 | 일반 작업 |
| 다단계 파이프라인(A 다음 B 다음 C) | Task Flow(관리됨) |
| 외부에서 생성된 작업 관찰 | Task Flow(미러링됨) |
| 일회성 알림 | Cron 작업 |
신뢰할 수 있는 예약 워크플로 패턴
시장 인텔리전스 브리핑과 같은 반복 워크플로의 경우, 일정, 오케스트레이션, 신뢰성 검사를 별도 계층으로 다루세요.- 타이밍에는 예약 작업을 사용하세요.
- 워크플로가 이전 컨텍스트를 기반으로 구축되어야 한다면 영구 cron 세션을 사용하세요.
- 결정적 단계, 승인 게이트, 재개 토큰에는 Lobster를 사용하세요.
- 자식 작업, 대기, 재시도, Gateway 재시작을 가로지르는 다단계 실행을 추적하려면 Task Flow를 사용하세요.
isolated 대신 session:<id>를 사용하세요. 각 실행이 새로 시작되어야 하고 필요한 모든 상태가 워크플로에 명시되어 있다면 isolated를 사용하세요.
워크플로 안에서는 LLM 요약 단계 전에 신뢰성 검사를 배치하세요.
- 브라우저 가용성과 프로필 선택. 예를 들어 관리되는 상태에는
openclaw, 로그인된 Chrome 세션이 필요할 때는user를 사용합니다. 브라우저를 참고하세요. - 각 소스의 API 자격 증명과 할당량.
- 필요한 엔드포인트에 대한 네트워크 도달 가능성.
- 에이전트에 필요한 도구 활성화 여부. 예:
lobster,browser,llm-task. - Cron의 실패 대상이 구성되어 있어 사전 검사 실패가 표시되는지 여부. 예약 작업을 참고하세요.
sourceUrl, retrievedAt, asOf를 보존하도록 요청해야 합니다. 워크플로 안에서 스키마 검증 모델 단계가 필요할 때는 LLM Task를 사용하세요.
재사용 가능한 팀 또는 커뮤니티 워크플로의 경우 CLI, .lobster 파일, 모든 설정 참고 사항을 Skills 또는 Plugin으로 패키징하고 ClawHub를 통해 게시하세요. Plugin API에 필요한 일반 기능이 없는 경우가 아니라면 워크플로별 가드레일은 해당 패키지 안에 유지하세요.
동기화 모드
관리 모드
Task Flow가 전체 수명 주기를 소유합니다. 플로 단계로 작업을 만들고, 완료까지 구동하며, 플로 상태를 자동으로 진행합니다. 예: (1) 데이터를 수집하고, (2) 보고서를 생성하고, (3) 전달하는 주간 보고서 플로입니다. Task Flow는 각 단계를 백그라운드 작업으로 만들고, 완료를 기다린 다음, 다음 단계로 이동합니다.미러링 모드
Task Flow는 외부에서 생성된 작업을 관찰하고, 작업 생성의 소유권을 가져오지 않으면서 플로 상태를 동기화 상태로 유지합니다. 작업이 Cron 작업, CLI 명령, 또는 다른 소스에서 시작되고, 그 진행 상황을 하나의 플로로 통합해 보고 싶을 때 유용합니다. 예: 함께 “morning ops” 루틴을 구성하는 세 개의 독립적인 Cron 작업입니다. 미러링된 플로는 언제 또는 어떻게 실행되는지를 제어하지 않고 전체 진행 상황을 추적합니다.내구성 있는 상태와 리비전 추적
각 플로는 자체 상태를 영구 저장하고 리비전을 추적하므로 Gateway 재시작 후에도 진행 상황이 유지됩니다. 리비전 추적은 여러 소스가 동일한 플로를 동시에 진행하려 할 때 충돌 감지를 가능하게 합니다. 플로 레지스트리는 주기적 체크포인트와 종료 체크포인트를 포함한 제한된 write-ahead-log 유지 관리를 갖춘 SQLite를 사용하므로, 장시간 실행되는 Gateway가 제한 없는registry.sqlite-wal 사이드카 파일을 유지하지 않습니다.
취소 동작
openclaw tasks flow cancel은 플로에 고정 취소 의도를 설정합니다. 플로 안의 활성 작업은 취소되고 새 단계는 시작되지 않습니다. 취소 의도는 재시작 후에도 유지되므로, 모든 자식 작업이 종료되기 전에 Gateway가 재시작되더라도 취소된 플로는 취소된 상태로 남습니다.
CLI 명령
| 명령 | 설명 |
|---|---|
openclaw tasks flow list | 추적 중인 플로를 상태 및 동기화 모드와 함께 표시 |
openclaw tasks flow show <id> | 플로 ID 또는 조회 키로 단일 플로 검사 |
openclaw tasks flow cancel <id> | 실행 중인 플로와 해당 활성 작업 취소 |
플로와 작업의 관계
플로는 작업을 대체하지 않고 조정합니다. 하나의 플로는 수명 동안 여러 백그라운드 작업을 구동할 수 있습니다. 개별 작업 레코드를 검사하려면openclaw tasks를 사용하고, 오케스트레이션하는 플로를 검사하려면 openclaw tasks flow를 사용하세요.