Systemannahme: Linux-Server mit x86_64-Architektur.
Bereitstellungsziel: ClawManager bereitstellen, die Konfiguration des Sicherheitsmodells auf der Weboberfläche abschließen und anschließend eine OpenClaw Desktop-Instanz erstellen und starten.
Geeignete Szenarien:
- Variante A: k3s-Einzelknoten-/Lightweight-Cluster-Bereitstellung
- Variante B: Standard-Kubernetes-Cluster-Bereitstellung (z. B. kubeadm-Cluster, Enterprise-K8s-Cluster, Kubernetes-Cluster in der Cloud)

II. Überblick über die Bereitstellungsarten

Sie können mit einer der folgenden zwei Methoden bereitstellen:

Variante A: k3s-Bereitstellung

Geeignet für Einzelknoten, Testumgebungen oder leichte Produktionsumgebungen.

Variante B: Standard-Kubernetes-Bereitstellung

Geeignet für Serverumgebungen, die bereits über einen Standard-Kubernetes-Cluster verfügen.

Unabhängig davon, welche Methode Sie verwenden, wird am Ende dasselbe ClawManager-Manifest angewendet:

kubectl apply -f deployments/k8s/cluster/clawmanager.yaml

III. Variante A: Bereitstellung mit k3s

3.1 k3s installieren

curl -sfL https://get.k3s.io | sh -

In Netzwerken auf dem chinesischen Festland kann die Installation über eine Mirror-Quelle erfolgen:

curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh |   INSTALL_K3S_MIRROR=cn sh -

3.2 Dienststatus prüfen

sudo systemctl status k3s --no-pager
sudo systemctl enable k3s

3.3 kubectl konfigurieren

Wenn der aktuelle Benutzer kubectl nicht direkt verwenden kann, führen Sie Folgendes aus:

mkdir -p ~/.kube
sudo cp /etc/rancher/k3s/k3s.yaml ~/.kube/config
sudo chown "$USER:$USER" ~/.kube/config

Oder geben Sie es temporär an:

export KUBECONFIG=/etc/rancher/k3s/k3s.yaml

3.4 Cluster überprüfen

kubectl get nodes

Normalerweise sollte der Node den Status Ready haben.

IV. Variante B: Bereitstellung mit Standard-Kubernetes

Gilt für x86-Serverumgebungen, in denen bereits ein nutzbarer Kubernetes-Cluster vorhanden ist.

4.1 Voraussetzungen prüfen

Vergewissern Sie sich, dass das aktuelle kubectl mit dem Ziel-Cluster verbunden ist:

kubectl get nodes
kubectl get ns

Normalerweise sollte mindestens ein Ready-Node angezeigt werden.

4.2 Standard-StorageClass prüfen

MySQL und MinIO in ClawManager benötigen persistente Speicherung. Es wird empfohlen, zunächst zu prüfen, ob im Cluster eine Standard-StorageClass vorhanden ist:

kubectl get storageclass

Wenn im Cluster bereits eine Standard-StorageClass vorhanden ist, können Sie mit der Bereitstellung direkt fortfahren.

Wenn keine Standard-StorageClass vorhanden ist, wird empfohlen, im Voraus nutzbare PV / PVC bereitzustellen oder eine lokale Pfad-Storage-Lösung zu verwenden. Andernfalls kann später Folgendes auftreten:

pod has unbound immediate PersistentVolumeClaims

V. Empfehlungen zum Ziehen von Images in Netzwerken auf dem chinesischen Festland (optional)

Wenn der Server Docker Hub oder andere öffentliche Registries nur langsam erreicht, können Sie Image-Beschleunigung konfigurieren.

5.1 k3s-Szenario: `/etc/rancher/k3s/registries.yaml` konfigurieren

mirrors:
  docker.io:
    endpoint:
      - "https://docker.m.daocloud.io"
      - "https://docker.nju.edu.cn"
      - "https://docker.1ms.run"
  quay.io:
    endpoint:
      - "https://quay.mirrors.ustc.edu.cn"
  gcr.io:
    endpoint:
      - "https://gcr.mirrors.ustc.edu.cn"
  k8s.gcr.io:
    endpoint:
      - "https://registry.aliyuncs.com/google_containers"

Führen Sie nach der Änderung Folgendes aus:

sudo systemctl restart k3s

5.2 Image-Pull verifizieren

sudo k3s crictl pull docker.io/rancher/mirrored-pause:3.6

VI. ClawManager bereitstellen

6.1 Projektcode abrufen

git clone https://github.com/Yuan-lab-LLM/ClawManager.git
cd ClawManager

6.2 Bereitstellungsmanifest anwenden

Führen Sie im Wurzelverzeichnis des Repositorys aus:

kubectl apply -f deployments/k8s/cluster/clawmanager.yaml

6.3 Basisressourcen prüfen

kubectl get ns
kubectl get pods -n clawmanager-system
kubectl get svc -n clawmanager-system

Unter normalen Umständen sehen Sie die folgenden Komponenten:

clawmanager-app
mysql
minio
skill-scanner

Wenn Sie den folgenden Fehler sehen:

0/1 nodes are available: pod has unbound immediate PersistentVolumeClaims

bedeutet dies, dass MySQL / MinIO im Cluster-Speicher nicht starten können, weil die PVC nicht gebunden ist. Springen Sie bitte direkt ans Ende des Dokuments:

XI.1 Spezielle Behandlung von Speicherproblemen (PV/PVC)

VII. Weboberfläche starten

7.1 Zugriff über NodePort

Der ClawManager-Frontend-Service verwendet standardmäßig einen HTTPS-NodePort. Prüfen Sie zunächst:

kubectl get svc -n clawmanager-system

Wenn der Frontend-Port wie folgt ist:

443:30443/TCP

können Sie ihn direkt im Browser aufrufen:

https://<Server-IP>:30443

7.2 Hinweis zum ersten HTTPS-Zugriff

Da in der Regel ein selbstsigniertes Zertifikat verwendet wird, zeigt der Browser möglicherweise „Unsicher“ oder eine Zertifikatswarnung an. Klicken Sie auf:

Erweitert → Trotzdem fortfahren

um die Seite zu öffnen.

Nachdem Sie die obige Bereitstellung abgeschlossen und die Verwaltungsseite erfolgreich geöffnet haben, müssen Sie noch die folgenden Initialisierungsschritte durchführen, bevor Sie tatsächlich eine OpenClaw-Instanz erstellen und starten können.

8.1 Im System anmelden

Öffnen Sie die Seite nach der Bereitstellung, z. B.: https://<Knoten-IP>:30443.
Melden Sie sich mit dem Standard-Administratorkonto an:
- Benutzername: admin
- Passwort: admin123
Nach der ersten Anmeldung wird empfohlen, das Standardpasswort nach Bedarf zu ändern.

8.2 Sicherheitsmodell konfigurieren (AI Gateway)

Nach dem Login müssen Sie zunächst ein verfügbares Sicherheitsmodell konfigurieren, das von der Plattform und von nachfolgenden Instanzen gemeinsam genutzt wird.

Klicken Sie im linken Menü auf AI Gateway → Modelle.
Fügen Sie ein neues Modell hinzu oder bearbeiten Sie ein bestehendes Modell und tragen Sie die folgenden Informationen entsprechend dem tatsächlich angebundenen Modelldienst ein:
- Anzeigename: Geben Sie einen leicht erkennbaren Namen ein.
- Anbietervorlage: Wählen Sie die passende Vorlage entsprechend dem Typ Ihres Modelldienstes; wenn Sie eine benutzerdefinierte oder kompatible Schnittstelle verwenden, können Sie Local / Internal auswählen.
- Protokoll: Wählen Sie das Protokoll entsprechend der Schnittstelle, z. B. OpenAI Compatible oder ein anderes tatsächlich verwendetes Protokoll.
- Base URL: Tragen Sie die vom Modelldienst bereitgestellte Schnittstellenadresse ein.
- API Key: Tragen Sie den gültigen Schlüssel des entsprechenden Modelldienstes ein.
- Provider Model: Tragen Sie den tatsächlichen Namen des aufzurufenden Modells ein.
- Währung: Tragen Sie die Angabe entsprechend Ihrer tatsächlichen Situation ein; wenn keine Kostendarstellung benötigt wird, können Sie den Standardwert beibehalten.
- Eingabepreis / Ausgabepreis: Wenn keine Kostenstatistik benötigt wird, können Sie zunächst 0 eintragen.
Aktivieren Sie vor dem Absenden unbedingt:
- Sicherheitsmodell
- Aktiviert
Klicken Sie auf Speichern.

Hinweis: Die Bilder auf der Seite dienen nur dazu, die Positionen der Eingabefelder und das Beispiel-Format zu zeigen. Die tatsächlichen Inhalte sollten sich nach der Konfiguration des von Ihnen verwendeten Modelldienstes richten.

8.3 OpenClaw-Instanz erstellen

Nach Abschluss der Modellkonfiguration erstellen Sie eine OpenClaw Desktop-Instanz.

Klicken Sie unten links auf ADMIN und wechseln Sie in den Workspace.
Klicken Sie auf Instanz erstellen.

Schritt 1: Grundinformationen

Geben Sie den Instanznamen ein (mindestens 3 Zeichen).
Die Beschreibung ist optional und kann leer bleiben.
Klicken Sie auf Weiter.

Schritt 2: Typ auswählen

Wählen Sie OpenClaw Desktop aus.
Klicken Sie auf Weiter.

Schritt 3: Konfiguration

Sie können direkt die Spezifikation Small auswählen:
- 2 CPU
- 4 GB RAM
- 20 GB Disk
Sie können die Einstellungen auch im darunterliegenden benutzerdefinierten Konfigurationsbereich nach Bedarf anpassen.
Im Bereich für OpenClaw-Ressourceneinbindung können Sie je nach Bedarf auswählen:
- Manuelle Ressourcen
- Ressourcenpaket
- Archivimport
Bei der ersten Verwendung können Sie die Standardwerte beibehalten oder Manuelle Ressourcen auswählen.
Klicken Sie abschließend auf Erstellen.

8.4 Hinweis zur ersten Erstellung

Wenn Sie zum ersten Mal eine OpenClaw-Instanz erstellen, müssen die erforderlichen Images heruntergeladen und die Umgebung initialisiert werden, daher dauert es deutlich länger.
Bei langsamen Netzwerken oder beim ersten Image-Pull kann der Instanzstatus lange als Erstellen angezeigt werden. Bitte warten Sie geduldig.
Wenn der Start auch nach längerer Zeit nicht erfolgreich ist, gehen Sie zurück zu den Kubernetes-/Docker-Logs und prüfen Sie Image-, PVC-, Gateway-Modell- und andere Probleme.

IX. Konsole und weitere Funktionen des AI Gateway

Neben der Modellkonfiguration bieten die Konsole auf der Startseite der Plattform und das AI Gateway auch Funktionen für Auditierung, Kosten und Regelverwaltung. So können Administratoren den Clusterstatus, Modellaufrufe und die Ausführung von Sicherheitsrichtlinien zentral einsehen.

9.1 Konsolenübersicht

Die Startseite der Konsole dient dazu, den gesamten Betriebszustand des aktuellen Clusters und der Plattform anzuzeigen, damit Administratoren Ressourcennutzung und Systemzustand schnell erfassen können.

Sie umfasst hauptsächlich die folgenden Informationen:

Übersicht über grundlegende Clusterinformationen: Zeigt die Gesamtzahl der Benutzer, die Gesamtzahl der Instanzen, die Anzahl laufender Instanzen und die gesamte Speichernutzung der aktuellen Plattform an.
Knotenübersicht: Zeigt die aktuelle Anzahl verfügbarer Knoten sowie die wichtigsten Scheduling-Knoteninformationen im aktuellen Cluster an.
Ressourcenanforderungsstatus: Zeigt die Gesamtmenge der aktuell von der Plattform angeforderten CPU-, Speicher- und Plattenressourcen an.
Kapazitäts-Dashboard: Zeigt die Gesamtkapazität und aktuelle Auslastung von Knoten, CPU, Speicher, Festplatte und weiteren Dimensionen an, damit leicht beurteilt werden kann, ob im Cluster noch freie Kapazität vorhanden ist.
Infrastruktur-Tabelle: Dient zur Anzeige des Status aktueller Knoten, Ressourcen und der grundlegenden Laufzeitumgebung.

Hinweis: Die Konsole dient hauptsächlich dazu, die Gesamtressourcen der Plattform, die Knoten und den Betriebsüberblick über Instanzen anzuzeigen, und wird nicht direkt für konkrete OpenClaw-Operationen innerhalb einzelner Instanzen verwendet.

9.2 Sicherheitszentrum (skill-scanner)

Das Sicherheitszentrum in der Konsole dient dazu, den Scan-Status der Plattformressourcen, historische Berichte und Scanner-Konfigurationen zentral einzusehen. Es basiert auf dem Backend-Dienst skill-scanner und kann statische Scans, Deep Scans sowie ergänzende, LLM-basierte Analysen auf Ressourcen ausführen. Dadurch unterstützt es Administratoren dabei, potenziell riskante Inhalte, ungewöhnliche Ressourcen und verdächtige Skills zu identifizieren.

Das Sicherheitszentrum umfasst derzeit hauptsächlich die folgenden drei Module:

Laufzeitübersicht
Berichtshistorie
Scanner-Konfiguration

9.2.1 Laufzeitübersicht

Die Seite „Laufzeitübersicht“ dient dazu, den gesamten aktuellen Scan-Status und die Risikoverteilung der Plattform einzusehen, damit Administratoren die aktuelle Sicherheitslage schnell erfassen können.

Die Seite enthält hauptsächlich die folgenden Informationen:

Aktuell wirksamer Modus: Zeigt an, ob derzeit der Quick-Modus oder der Deep-Modus verwendet wird.
Schnellscan / Vollscan:
- Schnellscan: Geeignet für neu hinzugefügte oder geänderte Ressourcen. Der Scanumfang ist leichter und die Ausführung schneller.
- Vollscan: Geeignet für das regelmäßige erneute Scannen aller Ressourcen, um den aktuellen Zustand aller Plattformressourcen vollständig zu überprüfen.
Gesamtzahl der Assets: Anzahl der Ressourcen, die aktuell in den Scanbereich des Sicherheitszentrums aufgenommen sind.
Abgeschlossene Scans: Anzahl der Ressourcen, deren Scan bereits abgeschlossen ist.
Hohes Risiko / Mittleres Risiko: Statistik der in den aktuellen Scanergebnissen erkannten Risikostufen.
Scan-Abdeckung: Zeigt den Anteil der tatsächlich gescannten Assets an der Gesamtzahl der Plattform-Assets.
SAFE / Hohes Risiko / Wartend / Fehlgeschlagen:
- SAFE: Anzahl der Ressourcen, die den Scan bestanden haben und bei denen aktuell kein Risiko festgestellt wurde
- Hohes Risiko: Anzahl der Risiko-Assets, die sofort bearbeitet werden müssen
- Wartend: Anzahl der Ressourcen, die auf Beweissicherung oder auf die Einreihung in die Scan-Warteschlange warten
- Fehlgeschlagen: Anzahl der fehlgeschlagenen Scan-Ausführungen, die erneut ausgeführt werden müssen
Risikolage der Plattform-Assets: Zeigt die aktuelle Risikoverteilung der Plattform-Assets aggregiert nach Risikostufe.
Hot Assets: Zeigt die am häufigsten verwendeten Skills oder hochfrequent genutzten Ressourcen an, damit Administratoren wichtige Assets schnell identifizieren können.
Scanner-Status: Zeigt die Verfügbarkeit und den Verbindungsstatus des aktuellen skill-scanner an, zum Beispiel „Statischer Scan verfügbar“ oder „Verbunden“.
Risikohinweise und Handlungsempfehlungen: Gibt kurze Hinweise entsprechend der aktuellen Risikolage.
Letzte Scan-Aufgaben: Zeigt kürzlich ausgeführte Scan-Einträge an, damit aktuelle Scan-Aktivitäten nachvollzogen werden können.

Hinweis:

Wenn auf der Seite „Derzeit gibt es keine Assets mit hohem oder mittlerem Risiko“ angezeigt wird, bedeutet dies, dass in den aktuellen Scan-Ergebnissen keine signifikanten Risiken gefunden wurden.

Wenn auf der Seite „Es gibt noch keine Scan-Aufzeichnungen“ angezeigt wird, bedeutet dies, dass bisher noch kein Scan ausgeführt wurde oder noch keine gültigen Scan-Ergebnisse erzeugt wurden.

9.2.2 Berichtshistorie

Die Seite „Berichtshistorie“ dient dazu, historische Scan-Berichte und zugehörige Ergebnisdatensätze einzusehen, damit Administratoren vergangene Scan-Ausführungen nachvollziehen können.

Dieses Modul dient hauptsächlich dazu:

Ergebnisse bereits ausgeführter Scan-Aufgaben einzusehen
Scan-Ausgaben zu verschiedenen Zeitpunkten zu vergleichen
Änderungen des Sicherheitszustands einer bestimmten Ressource über verschiedene Phasen hinweg nachzuverfolgen
Eine historische Grundlage für spätere Prüfungen, erneute Scans und Fehleranalysen bereitzustellen

Hinweis:

Die „Berichtshistorie“ ist stärker auf die Archivierung und Rückverfolgung historischer Ergebnisse ausgerichtet；

Die „Laufzeitübersicht“ ist stärker auf den aktuellen Zustand und den Gesamtüberblick ausgerichtet。

9.2.3 Scanner-Konfiguration

Die Seite „Scanner-Konfiguration“ dient zur Verwaltung der Betriebsweise von skill-scanner, der LLM-bezogenen Einstellungen sowie der beiden Scan-Strategien quick und deep. Nach dem Speichern wird ein Deployment-Rollout ausgelöst und auf das Wirksamwerden der neuen Konfiguration gewartet.

Die Seite enthält hauptsächlich die folgenden Inhalte:

(1) skill-scanner Servicestatus

Zeigt Namespace, Deployment-Namen und Verbindungsstatus des aktuellen Backend-Scandienstes an.
Wenn auf der Seite Verbunden und Statischer Scan verfügbar angezeigt wird, bedeutet dies, dass die grundlegende statische Scan-Funktion verfügbar ist.

(2) LLM-Konfiguration

Dieser Bereich dient zur Konfiguration des primären LLM, damit der Scanner bei Bedarf modellbasierte Analysen ausführen kann.

Die wichtigsten Felder sind:

Primäre LLM-Integration: Die Konfiguration des primären LLM kann direkt aus einem bereits in AI Gateway konfigurierten Modell importiert werden.
LLM API Key: Entspricht SKILL_SCANNER_LLM_API_KEY und wird zur Authentifizierung des primären LLM analyzers verwendet.
LLM Model: Entspricht SKILL_SCANNER_LLM_MODEL, zum Beispiel ein konkreter Modellname.
LLM Base URL: Entspricht SKILL_SCANNER_LLM_BASE_URL und dient zur Konfiguration der Serviceadresse des primären LLM.

(3) Meta-LLM-Integration

Dieser Bereich dient zur Konfiguration des Modells, das vom Meta Analyzer verwendet wird. Es wird typischerweise für die weitere Zusammenfassung, Konsolidierung oder sekundäre Verarbeitung von Findings verwendet.

Die wichtigsten Felder sind:

Meta-LLM-Integration: Die Konfiguration des Meta Analyzers kann direkt aus einem bereits in AI Gateway konfigurierten Modell importiert werden.
Meta LLM API Key: Entspricht SKILL_SCANNER_META_LLM_API_KEY.
Meta LLM Model: Entspricht SKILL_SCANNER_META_LLM_MODEL.
Meta LLM Base URL: Entspricht SKILL_SCANNER_META_LLM_BASE_URL.

Hinweis:

Wenn derzeit kein LLM konfiguriert ist, zeigt die Seite in der Regel an, dass aktuell nur statisches Scannen unterstützt wird；

Erst nach der Konfiguration des primären LLM und des Meta LLM kann der Scanner vollständigere semantische Analysen und Zusammenfassungen aktivieren。

(4) Aktueller Scan-Modus

Die Seite unterstützt die Auswahl des aktuell von der Plattform verwendeten Scan-Modus:

Quick-Modus: Verwendet quick analyzers für den Scan und eignet sich für tägliche Schnellprüfungen.
Deep-Modus: Verwendet deep analyzers für den Scan und eignet sich für vollständigere und tiefere Analysen.

Wichtig ist:

Sowohl „Schnellscan“ als auch „Vollscan“ im Dashboard verwenden die hier ausgewählte Scan-Stärke；
Der Unterschied liegt hauptsächlich im Scan-Umfang und nicht in der Tiefe der Analyzer selbst。

(5) Quick / Deep Scan-Strategie

Im unteren Bereich der Seite werden die beiden Scan-Strategie-Konfigurationen Quick und Deep separat gepflegt, damit Administratoren je nach Szenario unterschiedliche Analyzer-Kombinationen auswählen können.

Jede Strategie umfasst die folgenden Konfigurationseinträge:

Timeout (Sekunden): Legt die Timeout-Zeit für Scan-Aufgaben im aktuellen Modus fest.
Aufrufmethoden: Verschiedene Analyzer können je nach Bedarf aktiviert oder deaktiviert werden.

Die derzeit sichtbaren Analyzer-Typen umfassen:

Static: YAML + YARA statisches Regel-Scannen
Bytecode: Integritätsprüfung von Python-Bytecode
Pipeline: Befehlsketten- und Taint-Analyse
Behavioral: AST-basierte Verhaltens- und Datenflussanalyse
LLM: Semantische Analyse auf Basis externer LLMs
Meta: Sekundäre Zusammenfassungsanalyse von Findings

Dies kann in der Regel wie folgt verstanden werden:

Quick-Modus: Legt den Schwerpunkt auf schnellere Ausführung und wird häufig für tägliche inkrementelle Prüfungen verwendet
Deep-Modus: Kann mehr Analyzer aktivieren und eignet sich für tiefere Prüfungen und Sicherheits-Audits

(6) Speichern und anwenden

Die Schaltfläche Speichern und anwenden oben rechts dient dazu, alle aktuellen scanner-bezogenen Konfigurationen zu übernehmen. Nach dem Speichern werden folgende Aktionen ausgeführt:

Aktualisierung der quick / deep Scan-Strategien in ClawManager
Aktualisierung der relevanten Umgebungsvariablen des skill-scanner Deployment
Warten auf den Abschluss des Rollouts, bevor die neue Konfiguration offiziell wirksam wird

Hinweis:

Nach Änderungen an der Scanner-Konfiguration wird empfohlen, vor dem Start neuer Scan-Aufgaben zu warten, bis die Konfiguration vollständig wirksam ist；

Falls der Verbindungsstatus nach der Konfiguration ungewöhnlich ist, sollten zuerst das AI Gateway-Modell, die LLM-Adresse, der Key und der Deployment-Rollout-Status geprüft werden。

9.3 Überblick über die AI-Gateway-Funktionen

Zusätzlich zur Konfiguration von „Modellen“ enthält AI Gateway auch die folgenden Module:

AI Audit: Zeigt Modellaufruf-Traces, Request- und Response-Payloads, erkannte Risiken, Routing-Entscheidungen und Aufrufdetails an.
Kosten: Zeigt Token-Nutzung, geschätzte Kosten, interne Kosten und Trendstatistiken an.
Risikokontrollregeln: Konfiguriert Regeln zur Erkennung sensibler Inhalte und steuert, ob Treffer freigegeben oder an das Sicherheitsmodell weitergeleitet werden.

9.4 Kostenmodul

Die Kostenseite dient dazu, die Kosten und die Token-Nutzung von Modellaufrufen auf der Plattform zu erfassen und Administratoren beim Verständnis des Gesamtverbrauchs zu unterstützen.

Die Seite enthält hauptsächlich die folgenden Inhalte:

Input Token: Statistik über die Gesamtmenge der Eingabe-Prompts
Output Token: Statistik über die Gesamtmenge der vom Modell generierten Inhalte
Geschätzte Kosten: Auf Basis der Provider-Stückpreise geschätzte Kosten
Interne Kosten: Interne Verrechnungskosten im Zusammenhang mit dem Sicherheitsmodell
Täglicher Kostentrend: Zeigt die Veränderungen von geschätzten Kosten und Token im aktuellen Fenster über die letzten 7 Tage an
Benutzerübersicht: Aggregierte Nutzung und Kosten nach Benutzer
Instanzübersicht: Aggregierte Nutzung und Kosten nach Instanz
Neueste Kostenaufzeichnungen: Unterstützt Suche und Paginierung von Kostenaufzeichnungen nach Trace, Benutzer, Modell und weiteren Bedingungen und ermöglicht den Sprung zu Audit-Details

Hinweis: Falls noch keine Modellaufruf-Datensätze erzeugt wurden, können Input Token, Output Token, Kosten und Trenddiagramme alle 0 sein. Das ist normal.

9.5 AI-Audit-Modul

Die AI-Audit-Seite dient dazu, kürzliche Aufrufdatensätze verwalteter Modelle einzusehen und Administratoren bei der Untersuchung von Modellaufrufen, Token-Nutzung und Routing-Ergebnissen zu unterstützen.

Die Hauptfunktionen umfassen:

Letzte AI Trace: Zeigt aktuelle Modellaufruf-Ketten an
Trace-Liste: Zeigt aktuelle verwaltete Traces in einer einheitlichen Tabelle an
Suche und Filterung: Unterstützt Suche nach Trace, Request-Inhalt, Benutzer, Modell und weiteren Bedingungen
Statusfilterung: Unterstützt die Anzeige verschiedener Aufrufergebnisse nach Status
Modellfilterung: Unterstützt die Filterung zugehöriger Aufrufdatensätze nach Modell
Paginierung und Aktualisierung: Unterstützt paginierte Anzeige und manuelles Aktualisieren der neuesten Audit-Ergebnisse

Hinweis: Wenn auf der Seite „Es liegen noch keine AI-Audit-Aufzeichnungen vor“ angezeigt wird, bedeutet dies, dass noch keine tatsächlichen Modellaufruf-Anfragen erzeugt wurden.

9.6 Modul für Risikokontrollregeln

Die Seite für Risikokontrollregeln dient dazu, Erkennungsregeln für sensible Inhalte zu konfigurieren und festzulegen, welche Aktion nach einem Regeltreffer ausgeführt werden soll.

Dieses Modul unterstützt hauptsächlich:

Verwaltung der Regelliste: Anzeige aller Regeln und ihres Aktivierungsstatus
Ansicht nach Regelkategorie: Unterstützt die Anzeige nach Kategorien wie personenbezogene Informationen, Unternehmensinformationen, Kundengeschäft, Sicherheitszugangsdaten, Finanzen und Recht, politisch sensible Inhalte und benutzerdefiniert
Konfiguration der Regelfelder: Es können Regel-ID, Anzeigename, Schweregrad, Aktion, Reihenfolge, Regex-Pattern und Beschreibung festgelegt werden
Steuerung der Regelaktion: Bei einem Treffer kann gewählt werden, ob Inhalte freigegeben oder an das Sicherheitsmodell weitergeleitet werden
Stapelweises Aktivieren / Deaktivieren: Unterstützt die stapelweise Anpassung des Regelstatus
Regel-Testkonsole: Ermöglicht das Einfügen von Beispieltexten, um zu testen, welche aktiven oder Entwurfsregeln ausgelöst werden

Die aktuell integrierten Regelbeispiele umfassen unter anderem:

Personenbezogene Informationen: E-Mail-Adresse, Mobiltelefonnummer, Ausweisnummer, Reisepassnummer, Bankkartenkontext, Adresse, Lebenslaufinhalte usw.
Unternehmensinformationen: interne IP, interne Domain, Host-Benennung, Kubernetes Service DNS, Projekt-Codename, Organisationsstruktur, Gehalts- / HR-Informationen usw.
Kundengeschäft: Kundenlisten, Verträge / Angebote, Steuer-IDs auf Rechnungen, CRM- / Ticket-Daten usw.
Sicherheitszugangsdaten: Private Keys, API Keys, Tokens, JWT, Cookie / Session, Datenbank-Verbindungsstrings, Kubeconfig, geheime Umgebungsvariablen usw.
Finanzen und Recht: Budget, Gewinn, Umsatz, Rechtsgutachten, Rechtsstreitigkeiten, NDA usw.
Politisch sensible Inhalte: politische Institutionen, Militär / nationale Sicherheit, extremistische und gewaltbezogene Ausdrücke usw.

Hinweis: Die Standardregeln decken bereits viele gängige Szenarien zur Erkennung sensibler Informationen ab. In der Praxis können Regeln je nach Geschäftsanforderung weiter ergänzt, angepasst oder deaktiviert werden.

X. Beschreibung des Workspace-Moduls

Der Workspace ist der wichtigste Arbeitsbereich, nachdem sich ein normaler Benutzer bei der Plattform angemeldet hat. Er wird verwendet, um persönliche Ressourcenquoten einzusehen, Instanzen zu erstellen, Instanzen zu verwalten und OpenClaw-bezogene Ressourcen zu pflegen. Dieses Modul ist stärker auf tägliche Nutzung und Betriebsaufgaben ausgerichtet als die administratorseitige „Konsolenübersicht“.

10.1 Workspace-Startseite

Die Workspace-Startseite dient dazu, die Übersicht über Instanzen und Ressourcennutzung des aktuellen Kontos anzuzeigen und umfasst hauptsächlich die folgenden Inhalte:

Meine Instanzen: Zeigt die Anzahl der unter dem aktuellen Konto erstellten Instanzen an.
Laufend: Zeigt die Anzahl der aktuell laufenden Instanzen an.
Verwendeter Speicher: Zeigt den derzeit vom Konto belegten Speicherplatz an.
Meine Ressourcenquoten: Zeigt die für das aktuelle Konto verfügbaren Quoten an, darunter Anzahl der Instanzen, maximale CPU-Kerne, maximaler Speicher, maximaler Storage und maximale GPU-Anzahl.
Schnellaktionen: Bietet zwei Einstiege: Neue Instanz erstellen und Alle Instanzen anzeigen, damit Sie schnell mit der Plattform starten können.

Hinweis: Wenn auf der Seite „Noch keine Instanzen“ angezeigt wird, können Sie direkt auf Neue Instanz erstellen klicken, um mit der Erstellung der ersten OpenClaw Desktop-Instanz zu beginnen.

10.2 Meine Instanzen

Die Seite Meine Instanzen dient dazu, die unter dem aktuellen Konto erstellten Instanzen zentral anzuzeigen und zu verwalten. Diese Seite übernimmt hauptsächlich die Instanzverwaltungsfunktionen. Zu den üblichen unterstützten Aktionen gehören:

Instanzstatus anzeigen: Prüfen, ob sich die Instanz im Status Erstellung, Laufend, Gestoppt oder Fehler befindet.
Instanzdetails öffnen: Grundinformationen, Ressourcenkonfiguration und Laufzeitstatus der Instanz anzeigen.
Instanz stoppen: Wenn die Instanz fehlerhaft läuft oder die Umgebung neu geladen werden muss, kann eine Stop-Aktion ausgeführt werden.
Instanz löschen: Wenn die Instanz nicht mehr benötigt wird, kann sie direkt gelöscht werden, um CPU-, Speicher- und Storage-Ressourcen freizugeben.

Hinweis: Nach dem Löschen einer Instanz werden die zugehörigen Ressourcen ebenfalls bereinigt. Stellen Sie vor der Ausführung sicher, dass die enthaltenen Daten und Konfigurationen gesichert wurden.

10.3 Ressourcenverwaltung

Die Seite Ressourcenverwaltung dient dazu, verfügbare OpenClaw-Ressourceninhalte zu pflegen, sodass sie nach dem Start einer Instanz eingebunden und verwendet werden können. Die Seite umfasst hauptsächlich die folgenden Bereiche:

Ressourcen: Verfügbare Ressourceneinträge anzeigen und pflegen.
Ressourcenpakete: Mehrere Ressourcen zu wiederverwendbaren Paketen kombinieren, um eine gebündelte Einbindung zu erleichtern.
Einbindungsprotokolle: Verlauf und Ausführungsstatus von Ressourceneinbindungen anzeigen.

Auf der linken Seite der Ressourcenverwaltungsseite können Ressourcen außerdem nach Typ getrennt verwaltet werden. Die derzeit auf der Seite sichtbaren Typen sind:

Kanäle
Skills
Agenten (demnächst verfügbar)
Geplante Aufgaben (demnächst verfügbar)

Rechts oben auf der Seite werden unterstützt:

Aktualisieren: Die aktuelle Ressourcenliste neu laden.
Neu: Einen neuen Ressourceneintrag erstellen.

Hinweis: Die Ressourcenverwaltung dient hauptsächlich dazu, OpenClaw-Ressourcen vorzubereiten, die nach dem Start einer Instanz verwendet werden können, und ersetzt nicht direkt den Prozess der Instanzerstellung. Bei der Erstellung einer Instanz können Ressourcen über Manuelle Ressourcen, Ressourcenpakete und Archivimport eingebunden werden.

10.3.1 Kanal erstellen

„Kanäle“ werden verwendet, um die Verbindungsweise zwischen OpenClaw und externen Nachrichtenplattformen oder Zugriffsendpunkten zu konfigurieren, z. B. Telegram, Slack und Feishu / Lark.

Gehe beim Erstellen eines Kanals wie folgt vor:

Öffne die Seite Ressourcenverwaltung und bleibe im Reiter Ressourcen.
Wähle links unter den Ressourcentypen Kanal aus.
Klicke rechts auf der Seite auf Neu, um das Dialogfenster „Neue Ressource“ zu öffnen.
Fülle im Dialog die Basisinformationen aus:
- Typ: Kanal auswählen
- Ressourcen-Key: Trage die eindeutige Kennung dieses Kanals ein. Es wird empfohlen, einen leicht erkennbaren und nicht doppelt verwendeten englischen Namen oder eine entsprechende Kombination zu verwenden
- Name: Trage den Anzeigenamen des Kanals ein
- Tags: optional, für Klassifizierung und Suche
- Beschreibung: optional, zur ergänzenden Beschreibung des Kanalzwecks
- Aktiviert: Es wird empfohlen, diese Option aktiviert zu lassen
Wähle im Bereich Channel Template eine Startvorlage aus. Derzeit werden folgende Vorlagen unterstützt:
- Telegram
- DingTalk
- Slack
- Feishu / Lark
Nachdem du eine Vorlage ausgewählt hast, klicke auf Vorlage laden. Das System schreibt die Grundkonfiguration der entsprechenden Vorlage automatisch in den darunterliegenden Bereich Content JSON.
Ergänze oder ändere anschließend die Feldinhalte in Content JSON entsprechend deinen tatsächlichen Anbindungsinformationen.
Wenn die Konfiguration korrekt ist, klicke auf Speichern, um die Erstellung des Kanals abzuschließen.

Hinweis:

Channel Template dient dazu, schnell eine Grundkonfiguration zu erzeugen；

Content JSON ist der tatsächlich wirksame Konfigurationsinhalt des Kanals；

Wenn keine Vorlage vollständig passt, kannst du die Konfiguration auch direkt manuell in Content JSON eintragen。

10.3.2 Skills hochladen

Skills werden verwendet, um OpenClaw wiederverwendbare Funktionsfähigkeiten bereitzustellen. Die Plattform unterstützt den Batch-Import von Skills durch das Hochladen von Archivdateien.

Gehe beim Hochladen von Skills wie folgt vor:

Öffne die Seite Ressourcenverwaltung und bleibe im Reiter Ressourcen.
Wähle links unter den Ressourcentypen Skills aus.
Klicke auf Datei auswählen und wähle ein lokales Skill-Archiv aus.
Die aktuelle Seite unterstützt nur das Hochladen von .zip-Dateien.
Nachdem die Datei ausgewählt wurde, klicke rechts auf Skill-Archiv hochladen.
Das System analysiert den hochgeladenen Inhalt automatisch und importiert jedes Verzeichnis der ersten Ebene als einen Skill.
Nach Abschluss des Uploads kannst du die importierten Skills in der Skill-Liste anzeigen.

Hinweis:

Es wird empfohlen, das Skill-Archiv im Voraus sauber nach Verzeichnissen zu strukturieren；

Jedes Verzeichnis der ersten Ebene wird als eigenständiger Skill erkannt；

Falls die Liste nach dem Upload nicht sofort aktualisiert wird, kannst du oben rechts auf der Seite manuell auf Aktualisieren klicken, um neu zu laden。

10.4 Team-Zusammenarbeit

Teams lassen mehrere OpenClaw-Lite-Mitglieder an einem gemeinsamen Ziel arbeiten. Oeffne Teams, waehle eine Mitgliedervorlage, gib einen Teamnamen ein und erstelle das Team; Runtime- und Ressourcenprofile je Mitglied sind nicht erforderlich.

Beschreibe nach der Erstellung das Ziel im Team-Chat fuer den Leader. Der Leader koordiniert Planung, Ausfuehrung, Review und finale Zusammenfassung. Mit Execution Kanban siehst du die aktuelle Phase und abgeschlossene Lieferungen; unter Files findest du gemeinsame Artefakte.

Siehe Team Workspace Quick Guide.

XI. Schnelle Referenz für Probleme und Gegenmaßnahmen

11.1 Spezielle Behandlung von Speicherproblemen (PV/PVC)

Wenn der folgende Fehler angezeigt wird:

0/1 nodes are available: pod has unbound immediate PersistentVolumeClaims

bedeutet dies, dass der Cluster-Speicher nicht automatisch gebunden wurde. In diesem Fall können Sie lokale hostPath-PV/PVC im Stil eines x86-Einzelknotenservers manuell erstellen.

Diese Lösung eignet sich für Einzelknoten-Servertests oder leichte Umgebungen. Für Produktionsumgebungen wird empfohlen, formelle Speicherlösungen wie NFS, Ceph oder Cloud-Disks zu verwenden.

11.1.1 PV erstellen

kubectl apply -f - <<EOF
apiVersion: v1
kind: PersistentVolume
metadata:
  name: mysql-pv-local
spec:
  capacity:
    storage: 5Gi
  accessModes:
    - ReadWriteOnce
  persistentVolumeReclaimPolicy: Delete
  hostPath:
    path: /tmp/mysql-data
EOF

kubectl apply -f - <<EOF
apiVersion: v1
kind: PersistentVolume
metadata:
  name: minio-pv-local
spec:
  capacity:
    storage: 10Gi
  accessModes:
    - ReadWriteOnce
  persistentVolumeReclaimPolicy: Delete
  hostPath:
    path: /tmp/minio-data
EOF

11.1.2 PVC erstellen

kubectl apply -f - <<EOF
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: mysql-data
  namespace: clawmanager-system
spec:
  storageClassName: ""
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 5Gi
  volumeName: mysql-pv-local
EOF

kubectl apply -f - <<EOF
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: minio-data
  namespace: clawmanager-system
spec:
  storageClassName: ""
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi
  volumeName: minio-pv-local
EOF

11.1.3 Pod neu erstellen

kubectl delete pod --all -n clawmanager-system

11.1.4 Status erneut beobachten

kubectl get pvc -n clawmanager-system
kubectl get pods -n clawmanager-system -w

Erwartetes Ergebnis:

mysql-data / minio-data sind Bound
mysql / minio / skill-scanner / clawmanager-app sind schließlich Running

Symptom	Ursache	Behebung
Verbindung von `kubectl` zu `localhost:8080` wird abgelehnt	kubeconfig ist nicht konfiguriert	`KUBECONFIG` setzen oder in `~/.kube/config` kopieren
Timeout beim Ziehen von Pod-Images	Netzwerk zu Docker Hub / GHCR ist instabil	Image-Beschleunigung oder Proxy konfigurieren
MySQL / MinIO bleiben `Pending`	PVC ist nicht gebunden	`StorageClass` prüfen oder PV/PVC manuell erstellen
Die Seite lässt sich im Browser nicht öffnen	NodePort ist nicht freigegeben / der `port-forward`-Prozess wurde nicht aufrechterhalten	Port freigeben oder das Weiterleitungs-Terminal geöffnet lassen
Die Seite öffnet sich, aber eine OpenClaw-Instanz kann nicht erstellt werden	Sicherheitsmodell ist nicht konfiguriert	Zuerst unter AI Gateway → Modelle das Sicherheitsmodell konfigurieren und aktivieren
Die Instanz bleibt lange im Status „Erstellen“	Das erste Image-Pulling dauert lange / Speicher- oder Netzwerkproblem	Geduldig warten und bei Bedarf Pods und Events prüfen

XII. Empfohlene abschließende Prüfreihenfolge (zur Selbstprüfung)

kubectl get nodes
kubectl get storageclass
kubectl get pods -n clawmanager-system
kubectl get pvc -n clawmanager-system
kubectl get svc -n clawmanager-system
Im Browser https://<IP>:30443 öffnen
Im Backend anmelden und die Konfiguration des Sicherheitsmodells abschließen
Im Workspace eine OpenClaw Desktop-Instanz erstellen

38 KiB Raw Permalink Blame History Unescape Escape

ClawManager Bereitstellungs- und Schnellstartanleitung

Inhaltsverzeichnis

I. Umgebung und Ziel