openclaw-risk-scanner은(는) 무엇을 하나요?
OpenClaw AI 에이전트 스킬 패키지를 위한 자동화된 보안 위험 점수 — 위험한 시스템 호출 탐지, 유지보수성 평가, 의심스러운 게시자 플래그 지정 기능 제공.
개요
이 스킬은 OpenClaw 에코시스템에서 AI 에이전트 스킬 패키지의 보안 위험을 자동으로 평가합니다. 다음을 포함한 여러 요소를 기반으로 위험 점수를 계산합니다:
- 위험한 시스템 호출 탐지:
exec,spawn,fs.writeFile,net.connect등 잠재적으로 위험한 API 사용 감지 - 유지보수성 평가: 코드 복잡도, 문서화 수준, 의존성 관리 상태 분석
- 게시자 평판 확인: 게시자 ID, 과거 활동, 커뮤니티 피드백 기반 신뢰도 평가
사용 방법
CLI
# 스킬 패키지 스캔
openclaw-scan scan ./path/to/skill-package
# 특정 패키지 URL 스캔
openclaw-scan scan openclaw:example/[email protected]
API
from openclaw_risk_scanner import scan_package
result = scan_package("openclaw:example/[email protected]")
print(result.risk_score) # 0-100, 높을수록 위험
print(result.details)
지원 플랫폼
- Cursor
- Codex
- Claude Code
- 기타 OpenClaw 호환 AI 에이전트
작동 방식
- 패키지 매니페스트(예:
skill.json)에서 메타데이터 추출 - 코드베이스 정적 분석 수행 (AST 기반)
- 위험 점수 계산 알고리즘 적용
- 사람이 읽을 수 있는 위험 보고서 생성
- 선택적으로 게시자 평판 조회
환경 변수
| 변수명 | 설명 | 필수 |
|---|---|---|
OPENCLAW_API_KEY | OpenClaw API 키 | 아니오 |
SCANNER_LOG_LEVEL | 로그 레벨 (기본값: INFO) | 아니오 |
출력 예시
{
"risk_score": 85,
"risk_level": "높음",
"details": {
"dangerous_calls": ["exec", "spawn"],
"maintainability_score": 42,
"publisher_reputation": "의심스러움"
}
}
참고 사항
- 이 스킬은 OpenClaw 커뮤니티 가이드라인을 준수합니다.
- 위험 점수는 정적 분석에 기반하며, 100% 정확하지 않을 수 있습니다.
- 항상 스캔 결과를 검토하고 추가적인 수동 검증을 권장합니다.