🛡️ TrustMyAgent

Sicherheitsbodyguard für OpenClaw-Agenten

Website • Trust Center • Schnellstart • Mitwirken

Ein EDR-ähnlicher Sicherheitsagent für OpenClaw-Agenten. Führt 41 Sicherheitsprüfungen in 14 Bereichen durch, berechnet einen Vertrauenswert (0-100) und sendet Telemetrie an ein zentrales Trust Center-Dashboard, wo Menschen und andere Agenten die Vertrauenswürdigkeit überprüfen können.

Zustandslos konzipiert – läuft vollständig im Arbeitsspeicher, speichert nichts lokal, hinterlässt keine Spuren auf dem Host.

Warum

KI-Agenten sind leistungsstark, aber undurchsichtig. Wenn ein Agent auf einem Rechner läuft, wie wissen Sie, dass er nicht:

• Geheimnisse aus Umgebungsvariablen preisgibt?
• Verdächtige Prozesse erzeugt?
• Auf Dateien zugreift, die er nicht sollte?
• Mit übermäßigen Berechtigungen läuft?
• Sich mit Exfiltrationsdiensten verbindet?

TrustMyAgent beantwortet diese Fragen alle 15 Minuten und veröffentlicht die Ergebnisse in einem öffentlichen Trust Center, sodass jeder die Sicherheitslage eines Agenten überprüfen kann.

Schnellstart

Als OpenClaw-Skill (empfohlen)

Kopieren Sie es in das Skills-Verzeichnis Ihres Arbeitsbereichs:

# Von Ihrem OpenClaw-Arbeitsbereich aus
mkdir -p skills/trustmyagent
cp -r /path/to/trust-my-agent-ai/* skills/trustmyagent/

Nach der Installation bitten Sie den Agenten, die Einrichtung durchzuführen:

"TrustMyAgent einrichten"

Der Agent folgt den Einrichtungsanweisungen in SKILL.md, um Abhängigkeiten zu installieren, eine Testbewertung durchzuführen und den Cron-Job (*/15 * * * *) im Session-Stream agent:security:main zu erstellen. Die vollständigen Einrichtungsschritte finden Sie in SKILL.md.

Eigenständig

# Bewertung ausführen und Telemetrie senden (Agentenname aus IDENTITY.md)
python3 run.py

Voraussetzungen

• Python 3.8+
• openssl (für TLS-Prüfungen)
• Keine pip-Abhängigkeiten – nur stdlib

Sicherheitsbereiche

Vertrauensbewertung

• Jeder kritische Fehler begrenzt die Punktzahl auf 49 (NICHT VERTRAUENSWÜRDIG)
• 3+ hohe Schweregrad-Fehler begrenzen die Punktzahl auf 69 (NIEDRIG)

Prüfungsarten

Bash-Prüfungen (20) – Shell-Befehle, die die Host-Umgebung untersuchen. Definiert in checks/openclaw_checks.json.

Python/Nachrichten-Sensoren (10) – Programmatische Prüfungen, die Geheimnisse, Sitzungstranskripte, MCP-Konfigurationen, Skill-Manifeste, Moltbook-Beiträge und Besitzer-Reputation analysieren. Definiert in checks/message_checks.json.

OpenClaw-Infrastrukturprüfungen (11) – Python-Prüfungen für Knotenausführung, Medienverarbeitung, Gateway, Identität und SubAgent-Sicherheit. Definiert in checks/nodes_media_checks.json.

Alle Prüfungsarten erkennen automatisch macOS vs. Linux und verwenden plattformgerechte Befehle.

Architektur

┌─────────────────┐      POST /api/telemetry      ┌──────────────────┐
│   Agentenhost   │  ─────────────────────────►   │ 🛡️ TrustMyAgent-Server │
│                  │                                │  (Cloudflare)    │
│  run.py          │                                │  ├─ R2-Speicher  │
│  ├─ Bash-Checks  │                                │  ├─ Agentenindex │
│  └─ Python-Checks│                                │  └─ Trendverlauf │
│                  │                                │                  │
│  (kein lokaler   │                                └──────────────────┘
│   Zustand)       │                                        │
└─────────────────┘                                        │
                                                    trust-center.html
                                                    (öffentliches Dashboard)

Konfiguration

Der Agentenname wird automatisch aus Ihrer IDENTITY.md-Datei gelesen (Abschnitt # Name). Fallback auf die Umgebungsvariable OPENCLAW_AGENT_NAME, dann auf "OpenClaw Agent".

Benutzerdefinierte Prüfungen schreiben

Bash-Prüfung

Hinzufügen zu checks/openclaw_checks.json:

{
  "check_id": "CUSTOM-001",
  "name": "Meine benutzerdefinierte Prüfung",
  "description": "Was diese Prüfung überprüft",
  "category": "integrity",
  "severity": "medium",
  "command": "echo 'SAFE'",
  "expected_output": "SAFE",
  "pass_condition": "contains"
}

Python-Prüfung

Fügen Sie die Definition zu checks/message_checks.json und den Handler zu run.py hinzu:

@python_check("CUSTOM-002")
def check_something(check: dict) -> Tuple[bool, str]:
    # Return (bestanden: bool, Nachricht: str)
    return True, "Alles sieht gut aus"

Mitwirken

Siehe CONTRIBUTING.md für Richtlinien. Wir begrüßen:

• Neue Sicherheitsprüfungen für aufkommende Bedrohungsvektoren
• Verbesserungen der Plattformunterstützung (Windows, ARM)
• Integration mit weiteren Agenten-Frameworks
• Verbesserungen des Trust Center-Dashboards

Lizenz

MIT – erstellt von Anecdotes AI für das OpenClaw-Ökosystem.