task-father 환경에서 재개 가능하고 멱등성이 있는 배치 처리를 위해 설계된 지속성 있는 큐 작업 도우미입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install queue-task
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 queue-task 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
queue-task란 무엇인가요?
queue-task 스킬은 Openclaw Skills 프레임워크 내에서 장시간 실행되는 비동기 작업을 처리하도록 설계된 전문 유틸리티입니다. 구조화된 파일 기반 큐 시스템을 제공함으로써 분산되거나 중단된 워크플로우에서 상태를 유지하는 일반적인 과제를 해결합니다. task-father 디렉토리 레이아웃을 활용하여 개발자는 안정적이고 확장 가능한 자동화를 구축할 수 있습니다.
이 스킬의 핵심은 지속성과 멱등성에 있습니다. 추가 전용(append-only) 로그를 사용하여 처리 중에 데이터가 손실되지 않도록 보장하고, 잠금 파일을 활용하여 동시 실행 중 경합 상태를 방지합니다. 대규모 데이터 세트를 처리하거나 다단계 에이전트 워크플로우를 관리할 때 queue-task는 작업을 체계적으로 유지하고 재개할 수 있도록 필요한 뼈대를 제공합니다.
queue-task 활용 사례
- 재개 가능한 상태 추적이 필요한 대용량 데이터 배치 처리.
- 여러 세션에 걸쳐 실행될 수 있는 장기 실행 AI 에이전트 작업 편성.
- 재시도 시 작업이 중복되지 않아야 하는 멱등 워크플로우 구현.
- Openclaw Skills 내의 cron 통합을 통해 정기적인 유지 관리 또는 동기화 작업 예약.
queue-task 작동 원리
- 사용자는 작업 슬러그(slug)와 배치 크기, 일정 등의 구성 매개변수를 제공합니다.
- 시스템은 상태 파일(큐, 진행률, 완료, 실패 및 잠금)을 포함하는 전용 작업 디렉토리를 초기화합니다.
- 작업은 순차 또는 배치 처리를 위해 queue.jsonl 파일에 추가됩니다.
- 실행 중에 스킬은 상호 배제를 보장하기 위해 활성 잠금 파일을 확인합니다.
- 항목이 처리됨에 따라 progress.json이 업데이트되고 결과는 done.jsonl 또는 failed.jsonl로 이동됩니다.
- 프로세스가 중단되면 스킬은 진행률 파일을 사용하여 중단된 지점부터 정확히 재개합니다.
queue-task 설정 가이드
Openclaw Skills 환경에서 queue-task를 시작하려면 다음 단계를 따르세요.
- 특정 슬러그에 대한 작업 구조 초기화:
python3 scripts/queue_task.py init <slug>
- (선택 사항) 채팅 우선 초기화를 사용하지 않는 경우 환경을 수동으로 구성:
cp config.env.example config.env
# WORKSPACE_DIR 및 BATCH_SIZE로 config.env 편집
- 설치 및 상태 확인:
python3 scripts/queue_task.py status <slug>
queue-task 데이터 스키마 및 분류 체계
이 스킬은 tasks 디렉토리 내의 플랫 파일 데이터베이스 방식을 사용하여 상태를 구성합니다. 이는 서로 다른 Openclaw Skills 구현 간의 이식성과 투명성을 보장합니다.
| 파일 | 형식 | 용도 |
|---|---|---|
queue.jsonl |
JSONL | 처리 대기 중인 보류 작업 목록을 저장합니다. |
progress.json |
JSON | 활성 배치의 현재 오프셋 및 메타데이터를 추적합니다. |
done.jsonl |
JSONL | 성공적으로 완료된 작업의 영구 로그입니다. |
failed.jsonl |
JSONL | 실패한 항목의 작업 데이터 및 오류 세부 정보를 캡처합니다. |
lock.json |
JSON | 동시 실행을 방지하고 프로세스 PID를 저장합니다. |
queue-task 고급 기능
- 고가용성 보장을 위한 오래된 잠금 감지 및 수동 제거 지원.
- 프로세스 모니터링 및 자동 재시작을 위한 supervisor 워커 템플릿 생성.
- 자동 예약을 위한 Openclaw Skills cron 표현식과의 기본 호환성.
- 여러 머신에 원활하게 배포하기 위한 환경 변수(config.env)를 통한 이식 가능한 구성.
- 고성능 쓰기 작업 및 감사 가능성을 위한 추가 전용 JSONL 로깅.
SKILL.md
로드 중
관련 Openclaw 스킬
OneDrive 연동
모바일 채팅 플랫폼에서 원활하게 공유할 수 있도록 로컬 파일을 Microsoft OneDrive로 자동으로 이동하고 이름을 변경하는 AI 에이전트용 전문 도구입니다.
Tavily 검색
Tavily API를 사용하여 AI 에이전트에 실시간 웹 검색 기능을 통합하고 관련성이 높은 구조화된 데이터를 검색하세요.
Firecrawl Scraper
Firecrawl API를 활용하여 웹사이트를 AI 애플리케이션에 최적화된 깨끗하고 구조화된 데이터로 변환하는 강력한 웹 스크레이핑 및 크롤링 도구입니다.
Perstudio AI 이미지 및 비디오 생성
자연어를 고충실도 이미지, 비디오 및 오디오로 변환하는 Openclaw Skills용 전문가급 AI 미디어 엔진입니다.
안전한 자동 채우기 (1Password 통합)
AI 에이전트로부터 비밀 정보를 비공개로 유지하면서 1Password 자격 증명을 사용하여 안전한 웹 로그인을 자동화합니다.
Secure Shopper
여러 사이트에서 제품을 조사하고 1Password 기반 자동화를 사용하여 안전한 결제를 수행하는 비동기식 AI 쇼핑 도우미입니다.
Skill Father
가이드가 포함된 온보딩 흐름을 통해 이식 가능하고 재현 가능하며 프로덕션 준비가 된 Openclaw 스킬을 구축하기 위한 결정적인 프레임워크입니다.
추천*
