Sponsored by Vmake Labs Video Enhancer - Vmake Labs Video Enhancer는 AI를 활용해 동영상 화질을 개선하고, 디테일을 복원하며, 흐림을 줄이고 최대 8K까지 업스케일링합니다.

AI 광고 라이브러리

Openclaw Skills

Long Task Handler

Openclaw용 Long Task Handler

Long Task Handler는 Agent의 응답성을 보장하기 위해 빌드 및 데이터 마이그레이션과 같이 장시간 실행되는 프로세스를 백그라운드에서 관리하고 모니터링합니다.

frankieway

v1.0.0

Mar 31, 2026

설치

정보

Skill.md

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.


                  npx clawhub@latest install long-task-handler

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌

~/.openclaw/skills/

워크스페이스

<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.


                  Clawhub를 사용해서 long-task-handler 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Long Task Handler란 무엇인가요?

Long Task Handler는 표준 타임아웃 제한을 초과하는 실행 주기를 관리하기 위한 특수 모듈입니다. Openclaw Skills가 소프트웨어 컴파일, 대규모 데이터 마이그레이션, 머신러닝 모델 학습과 같은 고부하 작업을 백그라운드에서 실행하도록 하여 처리할 수 있게 합니다. 이 기능을 활용하면 AI Agent가 응답성을 유지하면서 복잡한 워크플로우에 대한 실시간 진행 상태 업데이트와 격리된 실행 환경을 제공할 수 있습니다.

Long Task Handler 활용 사례

Docker, Webpack 또는 TSC와 같은 도구를 사용하여 대규모 소프트웨어 프로젝트 컴파일 및 빌드.
대규모 데이터 마이그레이션 수행 또는 1GB를 초과하는 데이터 세트 처리.
머신러닝 모델 미세 조정 또는 수 시간 지속되는 학습 epoch 실행.
지속적인 모니터링이 필요한 미디어 처리 작업 또는 복잡한 클라우드 배포 실행.

Long Task Handler 작동 원리

작업 평가: 해당 기능은 명령을 분석하여 장기 실행 작업의 지표를 식별하고 예상 소요 시간을 계산합니다.
즉각적인 확인: Agent는 5초 이내에 작업을 확인하고 예상 완료 시간을 제공합니다.
백그라운드 실행: 작업은 예상 길이에 따라 백그라운드 프로세스나 격리된 하위 Agent로 이동합니다.
진행 상태 폴링: 시스템은 30-60초마다 프로세스 출력을 주기적으로 폴링하여 사용자에게 진행 상태를 보고합니다.
완료 보고: 완료 후, 해당 기능은 종료 코드, 소요 시간 및 로그 요약이 포함된 상세 알림을 보냅니다.

Long Task Handler 설정 가이드

이 기능을 워크플로우에 통합하려면 프로젝트 루트의 설정을 업데이트하세요.

# openclaw.json 설정 업데이트
{
  "skills": {
    "long-task-handler": {
      "enabled": true,
      "defaultTimeoutSeconds": 3600,
      "pollIntervalSeconds": 30,
      "maxConcurrentLongTasks": 3
    }
  }
}

Long Task Handler 데이터 스키마 및 분류 체계

이 기능은 Openclaw Skills 작업의 전체 수명 주기 동안 투명성을 보장하기 위해 작업 메타데이터와 실행 로그를 구성합니다:

속성	설명
sessionId	백그라운드 작업을 추적하기 위한 고유 식별자.
estimatedDuration	복잡도에 따라 짧음, 보통, 또는 긴 작업으로 분류.
pollIntervalMs	Agent가 새 출력을 확인하는 빈도.
exitCode	시스템 프로세스에서 반환된 최종 상태 코드.
logArchive	작업 후 검토를 위한 stdout 및 stderr의 영구 저장소.