Openclaw용 Skill Security Scanner

설치 전 모든 Skill의 악성 소프트웨어, 프롬프트 주입 및 공급망 취약점을 탐지하기 위해 설계된 전문 보안 감사 도구입니다.

mackding
v1.0.0
Apr 1, 2026
0
703
0

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install claws-security-scanner

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 claws-security-scanner 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Skill Security Scanner란 무엇인가요?

Skill Security Scanner는 악성 코드 및 손상된 종속성으로부터 사용자를 보호하기 위해 개발된 핵심 방어 유틸리티입니다. 이 도구는 AI 환경의 게이트키퍼 역할을 하며, Skill 파일을 정밀 검사하여 자격 증명 탈취, 숨겨진 데이터 유출 지시 및 난독화된 명령과 같은 고위험 패턴을 식별합니다. 이 도구를 사용하면 Openclaw Skills에 시스템 권한을 부여하기 전에 해당 Skill의 무결성을 확인할 수 있습니다.

이 스캐너는 무단 데이터 액세스로 이어질 수 있는 프롬프트 주입 및 명령 재정의를 포함하여 현대적인 AI 관련 위협에 대응하도록 특별히 설계되었습니다. 투명한 점수 시스템과 상세한 수정 조언을 제공하여 보안 개발 및 배포 수명 주기의 필수적인 부분으로 자리 잡고 있습니다.

Skill Security Scanner 활용 사례

  • 최초 설치 전 타사 Skill의 악성 코드 감사.
  • 보안 모범 사례 준수를 보장하기 위한 내부 Skill 디렉터리 스캔.
  • AI Agent 지침 내 숨겨진 프롬프트 주입 취약점 식별.
  • 의심스러운 아웃바운드 네트워크 호출 또는 환경 변수 덤프 탐지.
  • 새로운 Openclaw Skills를 개발하는 개발자를 위한 CI/CD 파이프라인의 자동 보안 게이팅.

Skill Security Scanner 작동 원리

  1. 사용자가 CLI를 통해 Skill 디렉터리 또는 매니페스트 파일의 경로를 제공합니다.
  2. 스캐너는 다중 범주 분석을 수행하며, 의심스러운 shell 명령 및 파괴적 작업에 대한 악성 소프트웨어 탐지로 시작합니다.
  3. 권한 우회 또는 숨겨진 지시사항을 찾아내기 위해 프롬프트 주입 시도에 대한 AI 지침을 평가합니다.
  4. 엔진은 악의적인 의도를 숨기기 위한 Base64 인코딩 또는 charcode 트릭과 같은 난독화 기법을 확인합니다.
  5. 설치 후 스크립트 및 종속성 고정을 확인하여 공급망 위험을 평가합니다.
  6. 100점 만점 시스템을 기준으로 보안 등급(A-F)을 계산하며, 식별된 문제에 대해 가중치 차감이 적용됩니다.

Skill Security Scanner 설정 가이드

npx를 사용하여 로컬 Skill 경로를 직접 스캔할 수 있습니다:

npx @claws-shield/cli scan <path-to-skill>

또는 스캐너를 Node.js 자동화 워크플로에 프로그래밍 방식으로 통합할 수 있습니다:

node scripts/run-scan.mjs <path-to-skill>

Skill Security Scanner 데이터 스키마 및 분류 체계

Skill Security Scanner는 사용자가 Openclaw Skills의 안전성을 평가하는 데 도움이 되는 구조화된 보고서를 생성합니다. 출력에는 다음 메타데이터가 포함됩니다:

속성 설명
보안 등급 전반적인 안전 수준을 나타내는 문자 등급 (A ~ F).
신뢰도 점수 스캔 결과의 확실성을 나타내는 지표.
심각도 분석 영향도별 문제 분류: 심각 (-30), 높음 (-15), 중간 (-7), 낮음 (-3).
권장 사항 Skill 설치 안전 여부에 대한 명확한 지침.
수정 제안 식별된 취약점을 수정하는 방법에 대한 상세 제안.

Skill Security Scanner 고급 기능

  • 여러 파일에 걸친 복잡한 공격 패턴을 식별하는 복합 상관 규칙.
  • 명확하게 악의적이지는 않지만 인간의 검토가 필요한 패턴에 대한 수동 검토 플래그.
  • 공급망 범주에서의 타이포스쿼팅 및 고정되지 않은 종속성 탐지.
  • 비밀 파일 액세스 및 env 덤프를 포함한 데이터 유출 패턴에 대한 포괄적인 스캔.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*