O que openclaw-skill-security-scanner faz?
🔐 OpenClaw Skill Security Scanner — Scanner de segurança de Skills baseado na metodologia Snyk Agent Scan. Detecta segredos, comandos perigosos e problemas estruturais em Skills OpenClaw.
Visão Geral
Este scanner analisa Skills de agentes de IA em busca de vulnerabilidades de segurança comuns, incluindo:
- Vazamento de Segredos: Chaves de API, tokens, senhas e outras informações sensíveis incorporadas no código da Skill.
- Comandos Perigosos: Comandos shell destrutivos (
rm -rf,:(){ :|:& };:,curl | bash) que podem danificar sistemas. - Problemas Estruturais: SKILL.md mal formatado, dependências ausentes ou não declaradas, metadados incorretos.
Como Funciona
O scanner opera em três etapas:
- Análise Estática: Varre todos os arquivos no diretório da Skill usando expressões regulares e heurísticas.
- Classificação de Risco: Atribui níveis de severidade (baixo, médio, alto, crítico) para cada descoberta.
- Geração de Relatório: Produz um relatório legível por humanos e uma saída JSON para integração com pipelines CI/CD.
Uso
# Escanear um diretório de Skill
openclaw-scan scan ./meu-diretorio-skill
# Escanear com saída JSON
openclaw-scan scan ./meu-diretorio-skill --format json
# Verificar apenas segredos
openclaw-scan scan ./meu-diretorio-skill --check secrets
Configuração
O scanner pode ser configurado através do arquivo .openclaw-scan.yaml no diretório da Skill:
severity: medium # Limiar mínimo de severidade (low, medium, high, critical)
exclude_patterns:
- "*.test.js"
- "node_modules/**"
secrets:
enabled: true
entropy_threshold: 4.5 # Limiar de entropia de Shannon para detecção de segredos
Suporte a Plataformas
- ✅ Claude Code
- ✅ Cursor
- ✅ Codex
- ✅ OpenClaw
- ⏳ Windsurf (em breve)
Exemplos
Segredo Detectado
Arquivo: ./minha-skill/skill.py
Linha: 12
Tipo: Chave de API
Severidade: Crítico
Comando Perigoso
Arquivo: ./minha-skill/deploy.sh
Linha: 5
Comando: rm -rf /
Severidade: Alto
Problema Estrutural
Arquivo: ./minha-skill/SKILL.md
Problema: Seção 'Description' ausente
Severidade: Médio
Licença
MIT