🛡️ TrustMyAgent

Guardião de segurança para agentes OpenClaw

Site • Central de Confiança • Início Rápido • Contribuição

Um agente de segurança semelhante a EDR para agentes OpenClaw. Executa 41 verificações de segurança em 14 domínios, calcula uma pontuação de confiança (0-100) e envia telemetria para um painel centralizado da Central de Confiança, onde humanos e outros agentes podem verificar a confiabilidade.

Sem estado por design - executa inteiramente em memória, não armazena nada localmente, não deixa rastros no host.

Por que

Agentes de IA são poderosos, mas opacos. Quando um agente é executado em uma máquina, como saber se ele não está:

• Vazando segredos de variáveis de ambiente?
• Criando processos suspeitos?
• Acessando arquivos que não deveria?
• Executando com privilégios excessivos?
• Conectando a serviços de exfiltração?

TrustMyAgent responde a essas perguntas a cada 15 minutos e publica os resultados em uma Central de Confiança pública para que qualquer pessoa possa verificar a postura de segurança de um agente.

Início Rápido

Como uma Skill do OpenClaw (recomendado)

Copie para o diretório de skills do seu workspace:

# From your OpenClaw workspace
mkdir -p skills/trustmyagent
cp -r /path/to/trust-my-agent-ai/* skills/trustmyagent/

Após a instalação, peça ao agente para executar a configuração:

"Configurar o TrustMyAgent"

O agente seguirá as instruções de configuração no SKILL.md para instalar dependências, executar uma avaliação de teste e criar o cron job (*/15 * * * *) no session stream agent:security:main. Consulte SKILL.md para obter todas as etapas de configuração.

Autônomo

# Run assessment and send telemetry (agent name from IDENTITY.md)
python3 run.py

Requisitos

• Python 3.8+
• openssl (para verificações TLS)
• Sem dependências pip - apenas biblioteca padrão

Domínios de Segurança

Pontuação de Confiança

• Qualquer falha crítica limita a pontuação a 49 (NÃO CONFIÁVEL)
• 3 ou mais falhas de gravidade alta limitam a pontuação a 69 (BAIXO)

Tipos de Verificação

Verificações Bash (20) - Comandos shell que inspecionam o ambiente do host. Definidos em checks/openclaw_checks.json.

Sensores Python/Mensagem (10) - Verificações programáticas que analisam segredos, transcrições de sessão, configurações MCP, manifestos de skill, posts do Moltbook e reputação do proprietário. Definidos em checks/message_checks.json.

Verificações de infraestrutura do OpenClaw (11) - Verificações Python para execução de nó, manipulação de mídia, gateway, identidade e segurança de subagente. Definidos em checks/nodes_media_checks.json.

Todos os tipos de verificação detectam automaticamente macOS vs Linux e usam comandos adequados para a plataforma.

Arquitetura

┌─────────────────┐      POST /api/telemetry      ┌──────────────────┐
│   Agent Host     │  ─────────────────────────►   │ 🛡️ TrustMyAgent Server│
│                  │                                │  (Cloudflare)    │
│  run.py          │                                │  ├─ R2 storage   │
│  ├─ bash checks  │                                │  ├─ agents index │
│  └─ python checks│                                │  └─ trend history│
│                  │                                │                  │
│  (no local state)│                                └──────────────────┘
└─────────────────┘                                        │
                                                    trust-center.html
                                                    (public dashboard)

Configuração

O nome do agente é lido automaticamente do seu arquivo IDENTITY.md (seção # Name). Usa como fallback a variável de ambiente OPENCLAW_AGENT_NAME e, em seguida, "OpenClaw Agent".

Escrevendo Verificações Personalizadas

Verificação Bash

Adicione a checks/openclaw_checks.json:

{
  "check_id": "CUSTOM-001",
  "name": "My custom check",
  "description": "What this check verifies",
  "category": "integrity",
  "severity": "medium",
  "command": "echo 'SAFE'",
  "expected_output": "SAFE",
  "pass_condition": "contains"
}

Verificação Python

Adicione a definição a checks/message_checks.json e o manipulador a run.py:

@python_check("CUSTOM-002")
def check_something(check: dict) -> Tuple[bool, str]:
    # Return (passed: bool, message: str)
    return True, "Everything looks good"

Contribuição

Consulte CONTRIBUTING.md para diretrizes. Aceitamos:

• Novas verificações de segurança para vetores de ameaças emergentes
• Melhorias de suporte a plataformas (Windows, ARM)
• Integração com frameworks de agente adicionais
• Melhorias no painel da Central de Confiança

Licença

MIT - construído pela Anecdotes AI para o ecossistema OpenClaw.