
엔터프라이즈 AI 에이전트 보안 툴킷으로, SKILL.md 기반 모듈을 통해 사전 점검 감사, 구성 강화, 런타임 위협 탐지, 그리고 프롬프트 인젝션 및 의도 표류에 대한 능동적 방어를 제공합니다.
엔터프라이즈 AI 에이전트 보안 툴킷 - SKILL.md 기반 능동 방어
ClawGuard v3의 핵심 방어는 코드가 아니라 SKILL.md에 있습니다!
각 모듈의 SKILL.md 자체가 완전한 방어 가이드입니다:
코드 스크립트는 보조 도구일 뿐이며, 실제 지능은 SKILL.md에 있습니다.
| 모듈 | 위치 | SKILL.md 라인 수 | 핵심 기능 |
|---|---|---|---|
| Auditor | 사전 점검(Audit) | 679줄 | 의도 변질 탐지, SKILL.md 코드 스캔 |
| Checker | 정적 점검 | 476줄 | 설정 강화, 원클릭 수정 |
| Detect | 런타임 모니터링 | 615줄 | 위협 탐지, Guardian 연동 |
| Guardian | 런타임 제어 | 451줄 | 동작 모니터링, 세션 동결/재생 |
| Shield | 능동 방어 | 493줄 | 프롬프트 인젝션, 제로폭 문자 탐지 |
총 문서량: 2,714줄 (v2는 3개 모듈로 2,226줄)
각 모듈은 다음을 포함합니다:
auditor-skill/
├── SKILL.md ← 핵심 방어 가이드 (가장 중요!)
├── _meta.json ← 메타데이터
├── cli.js ← 보조 CLI 도구
└── src/ ← 보조 코드 모듈
각 SKILL.md에는 다음이 포함됩니다:
에이전트에게 작업을 지시하면, 에이전트가 SKILL.md를 읽고 실행합니다:
사용자: 이 스킬을 감사해줘: /workspace/skills/weather-tool
↓
에이전트가 auditor-skill/SKILL.md를 읽음
↓
에이전트가 SKILL.md 지침에 따라 감사 실행
↓
감사 결과 출력
# 스킬 감사
cd auditor-skill && node cli.js /path/to/skill
# 설정 점검
cd checker-skill && node cli.js ~/.openclaw/openclaw.json
# 위협 탐지
cd detect-skill && node cli.js --monitor
# 런타임 Guardian
cd guardian-skill && node cli.js start
# 인젝션 탐지
cd shield-skill && node cli.js defend "test text"
트리거 시나리오: 새 스킬을 설치하기 전
SKILL.md 핵심 기능:
판단 출력:
🟢 안전 → 설치 가능
🟡 검토 필요 → 확인 후 설치 가능
🔴 고위험 → 설치 권장하지 않음
트리거 시나리오: 설정 보안 점검
SKILL.md 핵심 기능:
판단 출력:
⚠️ 문제 발견 + 구체적인 수정 권장사항 + 원클릭 강화
트리거 시나리오: 실시간 모니터링 및 위협 스캔
SKILL.md 핵심 기능:
판단 출력:
🔴 CRITICAL → 즉시 조치 필요
🟠 HIGH → 확인 요청
🟡 MEDIUM → 로그 기록 및 경고
트리거 시나리오: 동작 모니터링이 필요할 때
SKILL.md 핵심 기능:
핵심 규칙:
거부: /etc/*, /root/*, /.ssh/*
확인 필요: rm -rf, chmod 777, killall
로그 기록: 모든 작업
트리거 시나리오: 사용자 입력 보안 점검
SKILL.md 핵심 기능:
탐지 워크플로우:
인코딩 → 하이재킹 → 탈옥 → 체인 하이재킹 → 의도 변질
스킬의 명시된 기능과 실제 동작이 일치하지 않는 경우:
| 명시된 기능 | 실제 동작 | 판단 |
|---|---|---|
| "날씨 도구" | SSH 키 읽기 | 🔴 심각한 변질 |
| "파일 정리 도구" | 백도어 프로세스 시작 | 🔴 심각한 변질 |
| "번역 도우미" | 사용자 문서 외부 유출 | 🔴 심각한 변질 |
ClawGuardv3/
├── auditor-skill/ # 사전 점검 (SKILL.md 679줄)
│ ├── SKILL.md # ⭐ 핵심 방어 가이드
│ ├── _meta.json
│ ├── cli.js
│ └── src/
│ ├── auditor.js
│ ├── sast-analyzer.js
│ ├── intent-drift-detector.js
│ └── supply-chain-analyzer.js
├── checker-skill/ # 설정 점검 (SKILL.md 476줄)
│ ├── SKILL.md # ⭐ 핵심 방어 가이드
│ ├── _meta.json
│ ├── cli.js
│ └── src/
│ └── checker.js
├── detect-skill/ # 위협 탐지 (SKILL.md 615줄)
│ ├── SKILL.md # ⭐ 핵심 방어 가이드
│ ├── _meta.json
│ ├── cli.js
│ └── src/
│ └── detector.js
├── guardian-skill/ # 런타임 가디언 (SKILL.md 451줄)
│ ├── SKILL.md # ⭐ 핵심 방어 가이드
│ ├── _meta.json
│ ├── cli.js
│ └── src/
│ └── guardian.js
├── shield-skill/ # 능동 방패 (SKILL.md 493줄)
│ ├── SKILL.md # ⭐ 핵심 방어 가이드
│ ├── _meta.json
│ ├── cli.js
│ └── src/
│ └── shield.js
└── shared/
└── rules/
└── interceptor-rules.js
MIT 라이선스
버전: v3.0.0 최종 업데이트: 2026-03-21
| 기능 | v2 | v3 |
|---|
| 모듈 수 | 3 | 5 |
| 총 SKILL.md 라인 수 | 2,226 | 2,714 |
| 방어 핵심 | 코드 구현 | SKILL.md |
| 의도 변질 탐지 | 기본 | 완전체 |
| SKILL.md 코드 스캔 | 없음 | 있음 |
| Guardian 연동 | 없음 | 있음 |
| 세션 관리 | 기본 | 동결/재생 |
| 프롬프트 인젝션 보호 | 기본 | 다층 탐지 |
| 제로폭 문자 탐지 | 없음 | 있음 |
| 원클릭 강화 | 없음 | 있음 |
| 모듈 | v2 SKILL.md | v3 SKILL.md | 신규 콘텐츠 |
|---|
| Auditor | 823줄 | 679줄 | 의도 변질, SKILL.md 스캔 |
| Checker | 686줄 | 476줄 | 원클릭 강화, 수정 제안 |
| Detect | 717줄 | 615줄 | Guardian 연동, 제로폭 문자 탐지 |
| Guardian | - | 451줄 | 신규 모듈 |
| Shield | - | 493줄 | 신규 모듈 |