Skip to content

Latest commit

 

History

History
148 lines (107 loc) · 4.43 KB

File metadata and controls

148 lines (107 loc) · 4.43 KB

Claw Guard

Claw Guard

English | 简体中文 | 日本語 | 한국어 | Français | Deutsch | Español | Русский

Claw Guard ist ein OpenClaw-Sicherheitsplugin, das vor riskanten Agent-Aktionen eine lokale Schutzschicht einzieht.

Warum Claw Guard?

  1. Geteilte Threat Intelligence: Claw Guard kann Erkennungen bösartiger Skills im gesamten OpenClaw-Oekosystem teilen, sodass eine bestaetigte Bedrohung auch andere Nutzer schuetzt.
  2. Verteilte KI-Pruefung: Verdaechtige Skills koennen sowohl vom lokalen OpenClaw-Modell des Nutzers als auch von der Cloud-Analysepipeline von Claw Guard geprueft werden.
  3. Doppelte Erkennungsschicht: Der Schutz verlaesst sich nicht auf nur einen Kontrollpunkt. Claw Guard kombiniert lokale Pruefung mit optionaler Cloud-Erkennung.
  4. Breite Abdeckung: Claw Guard ist darauf ausgelegt, riskante Skills, Dateien, Befehle und URLs zu untersuchen.
  5. Reaktion in Echtzeit: Bestaetigt boesartiges Verhalten kann sofort blockiert werden, waehrend riskantes Verhalten mit geringerer Sicherheit eine Warnung fuer den Nutzer ausloest.
  6. Datenschutzbewusste Uploads: Das Plugin soll keine Geheimnisse oder vollstaendigen privaten Inhalte hochladen. Die entfernte Seite erhaelt nur sicherheitsrelevante Metadaten wie Skills, Dateipfade, Befehlszeilen, URLs und OpenClaw-Tool-Call-Kontext. Die Server-Implementierung soll ebenfalls als Open Source veroeffentlicht werden.

Install

Wenn OpenClaw den Plugin-Install automatisch fuer dich erledigen soll, sende dem Agenten diesen Prompt:

Please install the OpenClaw plugin "@bitslabguard/claw-guard" for me.
Use the standard OpenClaw plugin install flow, enable the plugin after installation if needed, and then verify the install result by checking the plugin info for "claw-guard".

Install From npm

Direkte Installation ueber npm:

openclaw plugins install @bitslabguard/claw-guard

Eine bestimmte Version installieren:

openclaw plugins install @bitslabguard/claw-guard@0.0.3

Install From GitHub Release

Fuer die meisten Nutzer ist der einfachste Weg die Installation des neuesten Release-Zips von GitHub. OpenClaw kann .zip-Pluginarchive direkt installieren.

openclaw plugins install /path/to/claw-guard-v0.0.3.zip

Pruefen:

openclaw plugins info claw-guard

What It Does

  • Pruefung riskanter Tool-Aufrufe ueber OpenClaw-Hooks
  • Lokale Allow/Deny-Regeln fuer Befehle, Pfade und URLs
  • Lokalisierte Warn- und Blockmeldungen im Chat
  • Integriertes Dashboard fuer Status, Scans, Pause, Resume und Einstellungen
  • Notfall-Pause mit Snapshot-Wiederherstellung
  • Strukturierte Audit-Logs
  • Optionale Anbindung an Claw_Guard_Server

Hauptfunktionen

  • Pruefung riskanter Tool-Aufrufe ueber OpenClaw-Hooks
  • Lokale Allow/Deny-Regeln fuer Befehle, Pfade und URLs
  • Lokalisierte Warn- und Blockmeldungen im Chat
  • Integriertes Dashboard fuer Status, Scans, Pause, Resume und Einstellungen
  • Notfall-Pause mit Snapshot-Wiederherstellung
  • Strukturierte Audit-Logs
  • Optionale Anbindung an Claw_Guard_Server

Chat-Befehle

  • /sec_help
  • /uninstall
  • /uninstall confirm <token>
  • /sec_openclaw_upgrade
  • /sec_openclaw_upgrade confirm <token>
  • /sec_scan
  • /sec_language [auto|locale]
  • /sec_block_stats [count]

Dashboard

Claw Guard bringt ein eingebautes Dashboard auf Basis von Preact mit.

  • Laufzeitstatus
  • letzte Hook-Signale
  • Audit-Zusammenfassung
  • Sicherheitsscans
  • Pause- und Resume-Aktionen
  • Einstellungen fuer autoUpgrade, Sprache, Intercept, Intel und Pause-Defaults

Installation

Voraussetzungen

  • Node.js >=20
  • Eine funktionierende OpenClaw-Installation im PATH

Lokale Entwicklungsinstallation

npm install
npm run build
openclaw plugins install -l .

Bootstrap-Installer

npm run bootstrap:install -- --source local --path .
  • --skip-doctor
  • --no-restart
  • --dry-run

Entwicklung

npm install
npm run build
npm run typecheck
npm test
npm run check

Release

npm run release:version -- 0.0.3
npm run build
npm run release:pack

Dokumentation