Communitygithub.com

iamhitarth/secure-my-claw

Guia de endurecimento de segurança para agentes OpenClaw. Abrange gestão de segredos, bloqueio de rede, defesa contra injeção de prompt, verificação de habilidades e muito mais. Formato legível por agente.

O que é secure-my-claw?

Este guia fornece instruções práticas e detalhadas para reforçar a segurança de agentes de IA baseados no OpenClaw. Ele aborda áreas críticas como proteção de segredos e chaves de API, isolamento de rede para evitar acessos não autorizados, defesas contra ataques de injeção de prompt e um processo de verificação rigoroso para novas habilidades. O objetivo é ajudar desenvolvedores e operadores a configurar seus agentes de forma segura, reduzindo vulnerabilidades comuns em ambientes de IA autônomos. O formato é otimizado para ser compreendido diretamente por agentes, permitindo que eles próprios apliquem as recomendações de segurança sempre que necessário.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add iamhitarth/secure-my-claw

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que secure-my-claw faz?

Guia de endurecimento de segurança para agentes OpenClaw. Abrange gestão de segredos, bloqueio de rede, defesa contra injeção de prompt, verificação de habilidades e muito mais. Formato legível por agente.

Gestão de Segredos

  • Armazene chaves de API, tokens e senhas em um cofre de segredos (ex: HashiCorp Vault, AWS Secrets Manager).
  • Nunca codifique segredos em arquivos de configuração ou código fonte.
  • Use variáveis de ambiente referenciando segredos do cofre: MINHA_CHAVE_API=$(vault kv get -field=chave caminho/para/segredo).
  • Revogue e rotacione segredos regularmente, especialmente após incidentes.
  • Implemente controle de acesso mínimo (princípio do menor privilégio) para cada segredo.

Bloqueio de Rede

  • Configure firewalls para restringir tráfego de entrada e saída dos agentes apenas a endpoints confiáveis.
  • Use listas de permissão de IPs para APIs e serviços externos.
  • Para comunicação interna, utilize redes privadas virtuais (VPN) ou túneis seguros (ex: WireGuard).
  • Bloqueie portas não utilizadas e protocolos desnecessários no sistema do agente.
  • Monitore logs de rede para detectar atividades suspeitas.

Defesa contra Injeção de Prompt

  • Implemente validação rigorosa de entradas do usuário: escape ou rejeite caracteres especiais que possam quebrar prompts.
  • Use prompts estruturados (ex: Jinja2, Handlebars) para evitar injeção por formatação.
  • Aplique filtros de conteúdo em saídas para evitar que o agente execute comandos maliciosos.
  • Limite a capacidade do agente de ler ou modificar arquivos do sistema.
  • Considere usar modelos de linguagem com guardrails nativos ou wrappers de segurança.

Verificação de Habilidades

  • Sempre revise o código de novas habilidades antes de ativá-las.
  • Execute habilidades em sandbox ou contêiner isolado (ex: Docker com privilégios reduzidos).
  • Verifique assinaturas digitais ou hashes de habilidades de fontes externas.
  • Mantenha um inventário de todas as habilidades ativas com seus metadados (versão, autor, permissões).
  • Desabilite habilidades que não estão mais em uso.

Boas Práticas Gerais

  • Mantenha o sistema operacional e dependências do agente atualizados.
  • Use autenticação multifator (MFA) para acesso administrativo.
  • Realize auditorias de segurança periódicas.
  • Documente políticas de segurança e procedimentos de resposta a incidentes.
  • Eduque a equipe sobre riscos específicos de agentes autônomos.

Leitura Adicional

Habilidades Relacionadas