AI 에이전트가 webhook 게이트웨이를 통해 복잡한 차단 요소를 관리자 에이전트 또는 사람에게 에스컬레이션하기 위한 전문 프로토콜입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install agent-escalation
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 agent-escalation 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
에스컬레이션 기술 (Escalation Skill)란 무엇인가요?
에스컬레이션 기술은 Openclaw Skills 생태계 내에서 중요한 안정성 구성 요소입니다. 이는 자율 에이전트가 자신의 한계를 인식하고 보다 유능한 관리자 엔티티에 컨텍스트를 전달할 수 있는 구조화된 메커니즘을 제공합니다. 이를 통해 기술적 장애물, 구성 오류 또는 중대한 결정이 무한 루프나 환각된 솔루션으로 이어지지 않고 정밀하게 처리되도록 보장합니다.
이 기술을 구현함으로써 개발자는 AI 기반 워크플로우에 대해 높은 서비스 수준을 유지할 수 있습니다. 이는 자율적인 작업 실행과 사람의 감독 사이의 간극을 메우는 안전망 역할을 하며, 전용 webhook 게이트웨이를 활용하여 핸드오버 과정에서 세션 무결성과 전체 문제 컨텍스트를 유지합니다.
에스컬레이션 기술 (Escalation Skill) 활용 사례
- 2-3회의 자동 시도 후에도 해결되지 않는 지속적인 기술 오류 또는 API 실패.
- 에이전트의 범위를 벗어난 상위 수준의 권한 또는 인프라 구성이 필요한 시나리오.
- 사람의 판단이나 전략적 의사결정이 필요한 모호한 고객 요청.
- 수동 재인증이 필요한 만료된 인증 토큰 또는 보안 자격 증명 처리.
에스컬레이션 기술 (Escalation Skill) 작동 원리
- AI 에이전트가 에스컬레이션 기준을 충족하는 지속적인 실패 또는 범위 외 요청을 식별합니다.
- 에이전트가 로컬 에스컬레이션 스크립트를 실행하여 문제, 이전 시도 및 오류 로그에 대한 구조화된 인수를 전달합니다.
- 스크립트가 로컬 게이트웨이의
/hooks/agent엔드포인트로 POST 요청을 트리거합니다. - 관리자 세션이 초기화되어 중복 작업을 방지하기 위해 이전 상호 작용의 전체 컨텍스트를 상속받습니다.
- 관리자가 문제를 해결하거나 Telegram과 같은 통신 채널을 통해 사람 운영자에게 알림을 추가로 에스컬레이션합니다.
에스컬레이션 기술 (Escalation Skill) 설정 가이드
Openclaw Skills를 사용하여 에이전트 환경에 이 기능을 통합하려면 기술 디렉토리에서 스크립트에 액세스할 수 있는지 확인하십시오.
# 수동 또는 에이전트 실행을 통한 에스컬레이션 트리거 예시
bash <SKILL_DIR>/scripts/escalate.sh \
"[문제 설명]" \
"[시도된 내용]" \
"[현재 오류/결과]"
지정된 엔드포인트에서 수신 후크를 수신하도록 로컬 게이트웨이가 구성되어 있는지 확인하십시오.
에스컬레이션 기술 (Escalation Skill) 데이터 스키마 및 분류 체계
에스컬레이션 프로세스는 관리자가 충분한 컨텍스트를 가질 수 있도록 데이터를 세 가지 기본 필드로 구성합니다.
| 필드 | 요구 사항 | 설명 |
|---|---|---|
| Problem | 필수 | 특정 차단 요소 또는 기술적 장애물에 대한 간결한 요약. |
| Attempts | 필수 | 에이전트가 수행한 작업과 실패한 이유에 대한 자세한 로그. |
| Result | 선택 사항 | 최종 오류 메시지, 스택 추적 또는 환경 상태. |
모든 데이터는 JSON 페이로드를 통해 POST /hooks/agent 엔드포인트로 전송됩니다.
에스컬레이션 기술 (Escalation Skill) 고급 기능
- 중대한 의사 결정 환경을 위한 휴먼 인 더 루프(Human-in-the-loop) 통합.
- 다단계 에스컬레이션 경로 (예: 에이전트 -> 관리자 -> 사람 운영자).
- 관리자가 핸드오버 전 에이전트의 정확한 상태를 볼 수 있도록 하는 세션 지속성.
- Openclaw Skills 내에서 에이전트 차단 요소에 대한 실시간 가시성을 위한 자동 Telegram 알림.
SKILL.md
로드 중
관련 Openclaw 스킬
Summarize
다양한 LLM 제공업체를 사용하여 URL, YouTube 트랜스크립트 및 로컬 문서에서 콘텐츠를 추출하고 요약하도록 설계된 고속 CLI 도구입니다.
Border Radius 생성기
균일, 코너별 또는 복잡한 기하학적 모양에 대한 정밀한 CSS 및 Tailwind CSS border-radius 코드를 생성하기 위한 유틸리티입니다.
JSON Formatter
설정 가능한 들여쓰기를 통해 JSON 데이터 구조를 미화, 압축 및 검증하기 위한 고성능 유틸리티입니다.
종횡비 계산기
단순화된 종횡비 계산, 누락된 치수 찾기 및 업계 표준 디스플레이 형식 식별을 위한 기술 유틸리티입니다.
Douyin & TikTok Trend Fetcher
TikTok 및 Douyin에서 실시간 트렌드 해시태그, 바이럴 음악 및 상위 크리에이터 데이터를 추출하는 자동 분석 도구입니다.
chen-memory-setup
AI 에이전트를 위한 영구 벡터 메모리 및 장기 컨텍스트를 활성화하고 구성하도록 설계된 특수 스킬입니다.
추천*
