상태를 유지하고 외부 실패에도 생존하는 AI agent 워크플로우를 구축하기 위한 종합적인 패턴 및 스크립트 세트입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install durable-workflow
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 durable-workflow 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Durable Workflow Patterns란 무엇인가요?
Durable Workflow Patterns는 개발자가 문제가 발생해도 진행 상황을 잃지 않는 견고한 다단계 자동화를 구축할 수 있도록 설계된 특수 툴킷입니다. 체크포인팅(checkpointing), 복구 및 알림과 같은 핵심 원칙을 구현함으로써 이 스킬은 AI agent가 API 타임아웃, 네트워크 실패 및 예상치 못한 충돌과 같은 실제 문제를 처리할 수 있도록 보장합니다.
이 Openclaw Skills 컬렉션은 지수 백오프, 서킷 브레이커 및 데드 레터 큐(dead letter queues)를 포함하여 일반적인 안정성 패턴에 대해 즉시 사용 가능한 구현을 제공합니다. 이는 단순한 스크립트 실행에서 전문 등급의 AI 배포에 필수적인 관리되고 회복력 있는 프로세스 수명 주기로 초점을 전환합니다.
Durable Workflow Patterns 활용 사례
- 외부 API 통합을 포함하는 복잡한 다단계 파이프라인 자동화.
- 재시작 후에도 진행 상황을 재개해야 하는 장기 실행 agent 루프 구축.
- 엄격한 오류 처리 및 알림이 필요한 백그라운드 작업 생성.
- 파일 기반 잠금을 사용하여 중요한 스크립트의 동시 실행 방지.
- 반복 실행이 데이터 중복을 일으키지 않는 멱등성 작업 설계.
Durable Workflow Patterns 작동 원리
- Checkpointing: 워크플로우는 각 단계가 성공적으로 완료된 후 현재 상태를 영구 JSON 파일에 저장합니다.
- State Loading: 실행 또는 재실행 시 스크립트는 기존 상태 경로를 확인하여 마지막으로 성공한 체크포인트를 결정합니다.
- Step Execution: 워크플로우는 정의된 단계를 반복하며 상태 파일에 이미 완료로 표시된 단계는 건너뜁니다.
- Failure Handling: 단계가 실패하면 일시적인 오류를 완화하기 위해 지수 백오프 및 지터가 포함된 재시도 로직을 적용합니다.
- DLQ Management: 지속적인 실패는 자동 실패 대신 수동 검토를 위해 데드 레터 큐 파일로 라우팅됩니다.
- Safe Exit: 종료 핸들러는 최종 상태 저장을 보장하고 구성된 경우 Telegram을 통해 알림을 보냅니다.
Durable Workflow Patterns 설정 가이드
Openclaw Skills에서 이러한 회복력 있는 패턴을 사용하려면 템플릿 스크립트를 복사하고 환경을 구성하세요.
# Copy the workflow skeleton
cp scripts/workflow-template.js my-workflow.js
# Run the workflow with an optional custom state path
WORKFLOW_STATE_PATH=/tmp/state.json node my-workflow.js
# Configure alerting (Optional)
export ALERT_TELEGRAM_TOKEN="your_bot_token"
export ALERT_CHAT_ID="your_chat_id"
Durable Workflow Patterns 데이터 스키마 및 분류 체계
이 스킬은 구조화된 상태 개체를 통해 워크플로우 진행 상황을 관리하고 메타데이터가 풍부한 큐를 통해 실패를 처리합니다.
| 데이터 구성 요소 | 형식 | 설명 |
|---|---|---|
| State File | JSON | 진행 상황을 추적하기 위해 step 인덱스와 results 배열을 저장합니다. |
| Lock File | 파일 (.lock) | 동시성을 방지하기 위해 실행 중인 프로세스의 PID를 포함합니다. |
| DLQ File | JSON | 실패한 item, error 메시지 및 failedAt 타임스탬프를 포함하는 개체 배열입니다. |
| Alerting Payload | JSON | Telegram Bot API로 HTTPS POST를 통해 전송되는 Markdown 형식의 메시지입니다. |
Durable Workflow Patterns 고급 기능
- 서킷 브레이커 (Circuit Breaker): 리소스 고갈을 방지하기 위해 실패하는 외부 서비스에 대한 호출을 자동으로 일시 중지합니다.
- PID 인식 잠금:
lock.js를 사용하여 이전에 충돌한 프로세스의 오래된 잠금을 자동으로 회수합니다. - 지터가 포함된 지수 백오프: API 엔드포인트의 'thundering herd' 문제를 방지하는 스마트한 재시도 타이밍입니다.
- 원자적 상태 저장: 충돌 중에 진행 파일이 손상된 상태로 남지 않도록 보장합니다.
- Telegram 통합: 최소한의 종속성 오버헤드를 위해 네이티브 HTTPS 모듈만 사용하는 내장형 알림 시스템입니다.
SKILL.md
로드 중
관련 Openclaw 스킬
DELULU AI 데이팅 에이전트
DELULU는 OpenClaw 및 Claude Code 플랫폼을 위해 친구 매칭, 스마트 대화 및 소셜 상호작용을 자동화하는 지능형 AI 데이팅 에이전트입니다.
Agent Hardening
prompt injection, 데이터 유출 및 적대적 사회 공학 공격으로부터 LLM 에이전트를 보호하기 위한 전문가 수준의 보안 프레임워크입니다.
WorkReply
WorkReply는 전문가들이 모든 기업 시나리오에 대해 영향력 있고 전략적인 메시지를 작성할 수 있도록 돕는 AI 기반 직장 커뮤니케이션 코치입니다.
Indie App Marketing Pipeline
사전 정의된 콘텐츠 뱅크에서 일주일 분량의 멀티 플랫폼 소셜 콘텐츠를 생성하고 예약하는 인디 개발자를 위한 제로 LLM 일일 마케팅 시스템입니다.
PDF Skill
Python 기반 도구를 사용하여 PDF 파일을 생성, 편집, 병합 및 구조화된 데이터를 추출하기 위한 포괄적인 문서 처리 엔진입니다.
추천*
