junjie-lumen/openclaw-risk-scanner

O que openclaw-risk-scanner faz?

Pontuação de risco de segurança automatizada para pacotes de habilidades do agente de IA OpenClaw — detecta chamadas de sistema perigosas, avalia a facilidade de manutenção e sinaliza editores suspeitos.

Funcionalidades

• Detecção de Chamadas Perigosas: Identifica chamadas de sistema como exec, eval, open para arquivos sensíveis, e acesso à rede.
• Pontuação de Risco: Atribui uma pontuação numérica (0-100) com base na gravidade e frequência dos problemas encontrados.
• Avaliação de Facilidade de Manutenção: Verifica métricas como complexidade ciclomática, tamanho do código e presença de comentários.
• Verificação de Editor: Consulta uma base de dados de editores de pacotes conhecidos por comportamentos maliciosos.

Como Usar

Para usar esta skill, execute o seguinte comando no seu terminal OpenClaw:

openclaw risk-score <caminho-do-pacote>

Substitua <caminho-do-pacote> pelo caminho para o diretório do pacote de habilidade que deseja analisar.

Opções

• --output json: Gera relatório em formato JSON.
• --threshold <número>: Define um limite mínimo de pontuação para alertar (padrão: 50).

Exemplo de Relatório

{
  "package": "minha-habilidade",
  "riskScore": 75,
  "maintainabilityScore": 60,
  "publisherFlagged": false,
  "issues": [
    {
      "type": "chamada_perigosa",
      "severity": "alta",
      "file": "src/index.ts",
      "line": 42,
      "description": "Uso de `eval()` detectado."
    }
  ]
}

Integração CI/CD

Adicione ao seu fluxo de trabalho para verificar automaticamente novos pacotes:

- name: Verificar Risco do OpenClaw
  run: openclaw risk-score ${{ github.workspace }}/skill

Contribuição

Contribuições são bem-vindas! Consulte o arquivo CONTRIBUTING.md para mais detalhes.