🛡️ TrustMyAgent

Guardia di sicurezza per agenti OpenClaw

Sito web • Trust Center • Avvio rapido • Contribuire

Un agente di sicurezza simile a EDR per agenti OpenClaw. Esegue 41 controlli di sicurezza in 14 domini, calcola un punteggio di fiducia (0-100) e invia la telemetria a una dashboard centralizzata del Trust Center dove umani e altri agenti possono verificare l'affidabilità.

Senza stato per progettazione - viene eseguito interamente in memoria, non memorizza nulla localmente e non lascia tracce sull'host.

Perché

Gli agenti AI sono potenti ma opachi. Quando un agente viene eseguito su una macchina, come fai a sapere che non sta:

• Perdendo segreti dalle variabili d'ambiente?
• Avviando processi sospetti?
• Accedendo a file che non dovrebbe?
• Eseguendo con privilegi eccessivi?
• Connettendosi a servizi di esfiltrazione?

TrustMyAgent risponde a queste domande ogni 15 minuti e pubblica i risultati in un Trust Center pubblico, così chiunque può verificare la postura di sicurezza di un agente.

Avvio rapido

Come skill di OpenClaw (consigliato)

Copia nella directory delle skill del tuo workspace:

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

Dopo l'installazione, chiedi all'agente di eseguire la configurazione:

"Configura TrustMyAgent"

L'agente seguirà le istruzioni di configurazione in SKILL.md per installare le dipendenze, eseguire una valutazione di prova e creare il cron job (*/15 * * * *) nello stream della sessione agent:security:main. Consulta SKILL.md per i passaggi completi di configurazione.

Standalone

# Esegue la valutazione e invia la telemetria (nome agente letto da IDENTITY.md)
python3 run.py

Requisiti

• Python 3.8+
• openssl (per i controlli TLS)
• Nessuna dipendenza pip - solo libreria standard

Domini di sicurezza

Punteggio di Fiducia

• Qualsiasi fallimento critico limita il punteggio a 49 (NON FIDATO)
• 3+ fallimenti di gravità alta limitano il punteggio a 69 (BASSO)

Tipi di Controllo

Controlli Bash (20) - Comandi shell che ispezionano l'ambiente host. Definiti in checks/openclaw_checks.json.

Sensori Python/Messaggio (10) - Controlli programmatici che analizzano segreti, trascrizioni di sessione, configurazioni MCP, manifest delle skill, post Moltbook e reputazione del proprietario. Definiti in checks/message_checks.json.

Controlli infrastruttura OpenClaw (11) - Controlli Python per esecuzione nodo, gestione media, gateway, identità e sicurezza subagente. Definiti in checks/nodes_media_checks.json.

Tutti i tipi di controllo rilevano automaticamente macOS vs Linux e utilizzano comandi appropriati per la piattaforma.

Architettura

┌─────────────────┐      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)

Configurazione

Il nome dell'agente viene letto automaticamente dal file IDENTITY.md (sezione # Name). In mancanza, utilizza la variabile d'ambiente OPENCLAW_AGENT_NAME, poi "OpenClaw Agent".

Scrivere Controlli Personalizzati

Controllo Bash

Aggiungi 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"
}

Controllo Python

Aggiungi la definizione a checks/message_checks.json e il gestore 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"

Contribuire

Vedi CONTRIBUTING.md per le linee guida. Accogliamo con favore:

• Nuovi controlli di sicurezza per vettori di minaccia emergenti
• Miglioramenti del supporto piattaforma (Windows, ARM)
• Integrazione con framework agente aggiuntivi
• Miglioramenti della dashboard del Trust Center

Licenza

MIT - realizzato da Anecdotes AI per l'ecosistema OpenClaw.