AI 에이전트 실패, 무한 루프 및 리소스 병목 현상을 식별하고 해결하기 위해 설계된 체계적인 디버깅 프레임워크입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install agent-debugger
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 agent-debugger 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Agent Debugger란 무엇인가요?
Agent Debugger는 AI 에이전트 개발의 독특한 과제를 처리하기 위해 구축된 Openclaw Skills 라이브러리 내의 전문 도구 세트입니다. 컨텍스트 오버플로, 전송 속도 제한 및 권한 오류와 같은 일반적인 자율 에이전트 문제를 진단하기 위한 구조화된 접근 방식을 제공합니다. 이러한 디버깅 프로토콜을 구현함으로써 개발자는 에이전트의 신뢰성과 효율성을 유지하고 예상치 못한 도구 실패나 로직 루프에서 회복할 수 있도록 보장할 수 있습니다.
이 스킬은 복잡한 에이전트 워크플로우를 구축하는 모든 사람에게 필수적인 동반자이며, 진단 패턴과 수정을 위한 구체적인 코드 스니펫을 모두 제공합니다. 정체된 추론 체인이든 파편화된 메모리든, Agent Debugger는 에이전트 성능을 안정화하고 token 소비를 최적화하는 데 필요한 기술적 가드레일을 제공합니다.
Agent Debugger 활용 사례
- 에이전트가 동일한 도구 호출이나 출력 패턴을 반복하는 무한 루프 해결.
- schema 불일치, 누락된 권한 또는 API 타임아웃으로 인한 도구 실패 디버깅.
- 장기 실행 대화에서 컨텍스트 오버플로 및 'context length exceeded' 오류 관리.
- 제공자 전송 속도 제한을 처리하기 위한 지수 백오프 및 요청 큐잉 구현.
- 에이전트가 이전 결정의 추적을 놓치거나 MEMORY.md 로드에 실패하는 메모리 문제 수정.
Agent Debugger 작동 원리
- 재현: 오동작이나 오류를 유발하는 정확한 단계와 입력을 문서화합니다.
- 격리: 작업을 단순화하고 불필요한 Openclaw Skills를 비활성화하며 컨텍스트를 최소화하여 특정 실패 지점을 찾습니다.
- 진단: 로그를 분석하고 현재 token 사용량을 확인하며 도구 구성 설정을 검증합니다.
- 수정: 반복 제한 추가, 재시도 로직 또는 컨텍스트 압축과 같은 수정 조치를 적용합니다.
- 예방: 새로운 가드레일로 에이전트 지침을 업데이트하고 재발을 방지하기 위해 에이전트 메모리에 해결 방법을 문서화합니다.
Agent Debugger 설정 가이드
이 스킬에서 제공하는 디버깅 프로토콜 사용을 시작하려면 작업 공간이 Openclaw Skills 개발을 위해 올바르게 구성되었는지 확인하세요.
# 작업 공간 구조 확인
ls -la ~/.openclaw/workspace/
# 메모리 파일이 있는지 확인
touch ~/.openclaw/workspace/MEMORY.md
디버그 단계에서 내부 추론을 노출하도록 에이전트를 상세 사고(verbose thinking)로 구성하세요.
{
"thinking": "verbose",
"reasoning": "on"
}
Agent Debugger 데이터 스키마 및 분류 체계
Agent Debugger는 에이전트 오류를 분류하고 추적하기 위해 구조화된 접근 방식을 활용합니다. 다음은 이 스킬에서 사용하는 주요 오류 매핑입니다.
| 오류 코드 | 주요 원인 | 복구 전략 |
|---|---|---|
context_length_exceeded |
과도한 기록/파일 데이터 | 요약 및 잘라내기 |
rate_limit_exceeded |
API 빈도 제한 | 백오프 및 큐잉 |
tool_not_found |
레지스트리 불일치 | 설치 및 경로 확인 |
permission_denied |
샌드박스 제한 | 정책 조정 |
invalid_parameters |
Schema 위반 | 입력 유효성 검사 |
Agent Debugger 고급 기능
- 반복 제한: 무한 루프를 자동으로 차단하기 위해 maxIterations 및 onLimit 동작을 정의합니다.
- 적응형 컨텍스트 압축: 컨텍스트 오버플로를 방지하기 위해 대용량 파일 읽기에 오프셋과 제한을 동적으로 사용합니다.
- 사용자 정의 재시도 로직: 특히 5xx 오류나 타임아웃에 대해 세밀한 재시도 전략을 구현합니다.
- 병렬 도구 최적화: 지연 시간을 줄이기 위해 여러 읽기 작업을 단일 호출로 결합합니다.
- 체크포인팅: 장기 실행 작업 중에 재개할 수 있도록 에이전트 상태를 주기적으로 저장합니다.
SKILL.md
로드 중
관련 Openclaw 스킬
Protein Mining Skill
문헌 조사에서 구조 분석 및 실험 우선순위 지정으로 이어지는 단백질 발견을 위한 엔드투엔드 자동화 파이프라인입니다.
Baidu Hot Topics Monitor
AI agent 워크플로우에서 직접 Baidu의 실시간 급상승 검색어, 순위 및 인기 지수를 모니터링하는 간소화된 도구입니다.
Optimacros AI 모델링 및 수식 전문가
복잡한 수식, 모델 아키텍처 및 엔터프라이즈급 액세스 보안에 집중하는 Optimacros 개발자를 위한 전문 AI 비서입니다.
암호화폐 실시간 USD 차트
8개의 주요 블록체인 네트워크에서 수천 개의 토큰에 대해 1초 OHLC 틱 및 USD 가격을 제공하는 고성능 실시간 WebSocket 피드입니다.
Multi Search Engine
고급 필터링 및 API 키 요구 사항 없이 17개의 글로벌 및 국내 엔진을 지원하는 포괄적인 검색 집계 기술입니다.
추천*
