From 12ab71435e8019a2dc6953249fc506a5f2ca93b8 Mon Sep 17 00:00:00 2001 From: Jarvis Date: Fri, 6 Nov 2026 23:09:00 +0000 Subject: [PATCH] Initial commit: Clean OpenClaw Jarvis Frontend Template --- .gitignore | 5 + LICENSE | 5 + README.md | 28 ++ landing/index.html | 344 +++++++++++++++++++++ wiki/index.html | 752 +++++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 1134 insertions(+) create mode 100644 .gitignore create mode 100644 LICENSE create mode 100644 README.md create mode 100644 landing/index.html create mode 100644 wiki/index.html diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..a448f85 --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ +.env +*.log +*.bak* +node_modules/ +.DS_Store diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..7bc31d1 --- /dev/null +++ b/LICENSE @@ -0,0 +1,5 @@ +MIT License + +Copyright (c) 2026 OpenClaw Jarvis Project + +Permission is hereby granted, free of charge, to any person obtaining a copy... \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..e284834 --- /dev/null +++ b/README.md @@ -0,0 +1,28 @@ +# OpenClaw Jarvis Frontend Template 🌐 + +Dieses Repository enthält das vollständige, responsive Open-Source Frontend für das **Jarvis & OpenClaw KI-Butler System**. + +## 🚀 Enthaltene Module +- **Landing Page (`/landing`):** Responsive Tailwind-CSS Landingpage mit Hero-Section, Feature-Grid, System-Metriken & Quickstart-Guide. +- **Jarvispedia Wiki (`/wiki`):** Interaktives Wikipedia-Dashboard mit Live-Suche, Artikel-Inhaltsverzeichnis, Dark-Mode & umfassender Open-Source Installationsanleitung. + +--- + +## 🛠️ Deployment & Hosting +Beide Frontends sind als statische HTML/JS-Module konzipiert und können über Apache, Nginx, Caddy, KeyHelp oder Cloudflare Pages gehostet werden. + +### Deployment-Manifest (`jarvis.deploy.json`) +```json +{ + "domain": "your-subdomain.your-domain.com", + "client": "your_user", + "runtime": "static", + "web_root": ".", + "health_path": "/" +} +``` + +--- + +## 📜 Lizenz +Dieses Projekt steht unter der **MIT Lizenz**. diff --git a/landing/index.html b/landing/index.html new file mode 100644 index 0000000..20c1be0 --- /dev/null +++ b/landing/index.html @@ -0,0 +1,344 @@ + + + + + + + Jarvis — Autonomer Open-Source KI-Butler & KI-Orchestrator | pepe44.dev + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ J +
+ + JARVIS v3.5 • Open Source + +
+ + +
+
+ +
+ +
+
+
+
+ + Autonomer KI-Butler & Homelab Co-Pilot +
+ +

+ Dein hochkompetenter + KI-Butler & System-Co-Pilot +

+ +

+ Full-Stack Kontrollzentrum fßr Entwicklung & Homelab: Jarvis verbindet 11 Spezialagenten, 20 Custom MCP-Server, Echtzeit-Monitoring, Vision-Kameraanalyse und semantisches Langzeitgedächtnis in einer gehärteten Architektur. +

+ + + + +
+
+
Spezialagenten
+
+ 11 Agenten +
+
Isolierte Workspaces
+
+
+
MCP-Flotte
+
+ 20 Server +
+
Model Context Protocol
+
+
+
Langzeitgedächtnis
+
+ Hybrid DB +
+
Ollama Qwen Embeddings
+
+
+
Sicherheit & Audit
+
+ Guarded +
+
Absoluter SSH Host Guard
+
+
+
+
+ + +
+
+

Mächtige Fähigkeiten auf einen Blick

+

Jarvis ist kein generischer Chatbot. Er agiert als autonomer Assistent mit tiefem Systemverständnis, Witz und echten Ausfßhrungswerkzeugen.

+
+ +
+ +
+
+ +
+

System & Health Monitoring

+

+ Echtzeit-Einblick in Unraid, Docker-Container, CPU/RAM, Disk-Arrays und HTTP-Endpunkte (Grafana, Vaultwarden, Gitea, n8n) via Prometheus & Glances MCP. +

+
+ + +
+
+ +
+

Kamera- & Gesichtserkennung

+

+ Deep-Learning Vision-Anbindung mit Home Assistant Kameras und InsightFace. Erkennt bekannte Gesichter, lernt bei hoher Ähnlichkeit nach und wahrt volle Privatsphäre. +

+
+ + +
+
+ +
+

Semantisches Langzeitgedächtnis

+

+ Vektorbasiertes Gedächtnis mit lokalen Ollama Embeddings (Qwen3). Speichert Tagesnotizen, Nutzerpräferenzen (USER.md) und Absichten dauerhaft ab. +

+
+ + +
+
+ +
+

Host Guardrail & SSH Audit

+

+ Isolierte Shell-Execution mit erzwungenem SSH-Wächter (jarvis-guard.sh). Blockiert destruktive Befehle auf Produktivsystemen. +

+
+ + +
+
+ +
+

20 Custom MCP Server

+

+ Standardisierte Stdio-MCP-Architektur fĂźr Bitwarden, OPNsense, Gitea, Docker-Control, Web-Deploy, Mail, Prometheus, Glances und OpenClaw Self-Edit. +

+
+ + +
+
+ +
+

Automatische Web-Deployments

+

+ Integrierter Deployment-Agent fĂźr KeyHelp Panel API, Cloudflare DNS-Records und atomare Webhost-Releases ohne Ausfallzeiten. +

+
+
+
+ + +
+
+

Open-Source Quickstart & Installation

+

So setzt du OpenClaw & den Jarvis-Stack auf eigener Hardware (Linux/Unraid) Schritt fĂźr Schritt auf.

+
+ +
+
+
+ # 1. OpenClaw CLI installieren & Gateway aufsetzen + +
+
+ npm install -g openclaw && openclaw onboard +
+
+ +
+
+ # 2. Modell-Provider (OpenRouter / Gemini) hinzufĂźgen + +
+
+ openclaw models add --provider google --model google/gemini-3.5-flash +
+
+ +
+
+ # 3. Repository klonen & Konfiguration validieren + +
+
+ git clone https://github.com/pepe44/openclaw-jarvis.git ~/.openclaw && openclaw config validate +
+
+ +
+
+ # 4. OpenClaw Gateway starten & verbinden + +
+
+ openclaw gateway --bind lan +
+
+ +
+ Ausführliche Anleitung mit allen MCP-Servern & Agenten-Matrix: + Zum Wiki Guide → +
+
+
+
+ + + + + + + diff --git a/wiki/index.html b/wiki/index.html new file mode 100644 index 0000000..e237ba5 --- /dev/null +++ b/wiki/index.html @@ -0,0 +1,752 @@ + + + + + +Jarvispedia – Freies Open-Source KI-Wiki & Ausführliche Anleitung | pepe44.dev + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ 😏 +
+

JARVISPEDIA

+ Die freie Open-Source Enzyklopädie & Vollständige Anleitung fßr Jarvis & OpenClaw +
+
+
+ + +
+
+ +
+ + +
+

Jarvis (KI-Orchestrator & Self-Hosted Butler)

+ +
+
Jarvis Open-Source Stack
+
+ 😏 +
+ + + + + + + + + + + +
Projekt-TypOpen Source KI-Butler
Autor / CreatorPascal (@pepe)
Basis-LaufzeitOpenClaw v2026.9.7
Host OSLinux (Unraid / Debian / Ubuntu)
Node.js Versionv20.x / v24.x
PrimärmodellGoogle Gemini / OpenRouter Free
Spezialagenten11 Aktiv
MCP-Server20 Registriert
LizenzMIT License (Open Source)
StatusProduction / Live
+
+ +

Jarvis ist ein autonomer, erweiterbarer KI-Butler und technischer Co-Pilot auf Basis von OpenClaw. Jarvis orchestriert spezialisierte Agenten für Entwicklung, Infrastruktur, Security, Web-Deployments und Smart Home über maßgeschneiderte MCP-Server (Model Context Protocol). Das Projekt ist vollständig für den selbstgehosteten Open-Source-Nachbau dokumentiert.

+ + + +

1. Übersicht & Philosophie

+

Jarvis agiert als vertrauter digitaler Partner. Das System basiert auf drei Kernprinzipien:

+
    +
  • Modularität durch Subagenten: Jarvis delegiert Spezialaufgaben an eigens konfigurierte Agenten (z. B. developer, deploy, security, qa).
  • +
  • Erweiterbarkeit durch MCP: Anbindung externer APIs, Smart-Home-Komponenten, PasswĂśrter und Firewalls Ăźber eigenständige Stdio-MCP-Server.
  • +
  • Sicherheit & Validierung: Änderungen an der Kern-Konfiguration werden Ăźber Revision-Locks und Validierungs-Pipelines geschĂźtzt.
  • +
+ +

2. Systemarchitektur & Host-Topologie

+

Das System läuft auf einem Linux-Host (Unraid, Ubuntu, Debian oder VM). Das OpenClaw-Laufzeitverzeichnis bildet die zentrale Schaltstelle:

+
+~/.openclaw/
+├── openclaw.json          # Zentrale Konfiguration (Agenten, MCP-Server, Provider)
+├── mcp/                   # Eigene Node.js / Python MCP-Server (stdio)
+├── workspaces/            # Isolierte Agenten-Workspaces (jarvis, developer, security...)
+└── self-edit/backups/     # Automatische Config-Backups mit Revisions-Hashes
+    
+ +

3. Spezialagenten-Matrix

+ + + + + + + + + + + + + + + + + + + + + + +
IDNameProfilHauptaufgabe
jarvisJarvisFullHaupt-Orchestrierung, Nutzerinteraktion & Subagenten-Steuerung
developerDeveloper AgentCodingSoftware-Entwicklung, Refactoring & Code-Analysen
infrastructureInfrastructure AgentInheritUnraid-, Glances-, Prometheus- & Service-Monitoring
deployDeploy AgentInheritWebhosting (KeyHelp API), Release-Deployments & Cloudflare DNS
securitySecurity AgentInheritBitwarden-Credentials, OPNsense Firewall & Sicherheits-Audits
qaQA AgentInheritQualitätssicherung, Testing & Code-Reviews
mailMail AgentInheritDelegiertes IMAPS-Postfach Management
paperlessPaperless AgentInheritDokumentenarchivierung & Inhaltsanalyse
calendarCalendar AgentInheritTermine & Kalender-Verwaltung
tasksTask AgentInheritAufgaben- und Todo-Steuerung
researchResearch AgentInheritWeb-Recherche, Datenbeschaffung & Synthese
+ +

4. MCP-Server Landschaft (20 Server)

+

Über das Model Context Protocol (MCP) greift Jarvis auf 20 spezialisierte Server zu:

+
    +
  • Eigenverwaltung: openclaw-self-edit, openclaw-diagnostics, shell-tools
  • +
  • Infrastruktur & Monitoring: unraid-monitor, service-health, docker-control, prometheus, glances
  • +
  • Hosting & Workflows: web-deploy, gitea-workflow, youtrack
  • +
  • Sicherheit & Wissen: bitwarden, opnsense, obsidian, memos
  • +
  • Vision & Smart Home: homeassistant, face, cat, mail, windows
  • +
+ +

5. Sicherheits- & Rechtekonzept

+

Der Nachbau setzt auf eine gehärtete 3-Säulen-Sicherheitsarchitektur:

+
    +
  1. SSH Host-Wächter (jarvis-guard.sh): Filtert eingehende SSH-Befehle und blockiert destruktive Systemkommandos.
  2. +
  3. Workspace-Sandbox: Schreibvorfälle auf Dateiebene sind strikt auf den eigenen Workspace begrenzt.
  4. +
  5. Mutation Leases: Änderungen an openclaw.json erfordern Revisions-Token und Validierungs-Checks.
  6. +
+ +

6. Gedächtnis- & Wissensspeicher

+

Jarvis speichert Kernwissen in MEMORY.md, Nutzerpräferenzen in USER.md und synchronisiert erweiterte Dokumentationen direkt mit dem Obsidian LiveSync Vault (obsidiannotes).

+ + +

7. OpenClaw Installations-Anleitung (Schritt-für-Schritt) 🛠️

+ +
+ Vollständige Installations-Anleitung: In diesem Abschnitt erfährst du im Detail, wie du das OpenClaw-Framework von Grund auf auf deinem eigenen Linux-Server, Unraid-System oder in einer VM installierst und konfigurierst. +
+ +

7.1 Systemvoraussetzungen

+

Bevor du OpenClaw installierst, stelle sicher, dass folgende Software auf deinem Linux-Server vorhanden ist:

+
    +
  • Betriebssystem: Linux (Ubuntu 22.04/24.04 LTS, Debian 12, Unraid 6.12+, Arch oder CentOS)
  • +
  • Node.js: Version v20.x oder v24.x (LTS wird empfohlen)
  • +
  • NPM / Git: Aktuelle Versionen fĂźr Modul-Management und Repository-Cloning
  • +
  • Process Manager (Optional): pm2 oder systemd zur Hintergrund-Überwachung
  • +
+ +

Node.js & NVM Installation auf Linux:

+
+# NVM (Node Version Manager) installieren
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
+source ~/.bashrc
+
+# Node.js LTS (v20 oder v24) installieren & aktivieren
+nvm install 24
+nvm use 24
+node -v # Sollte v24.x oder v20.x ausgeben
+    
+ +

7.2 OpenClaw CLI Installation & Initialisierung

+

Das OpenClaw Framework wird als globales Node.js Paket installiert. FĂźhre folgende Befehle auf deinem Server aus:

+
+# 1. OpenClaw global installieren
+npm install -g openclaw
+
+# 2. Installation ĂźberprĂźfen
+openclaw --version
+
+# 3. Interaktives Onboarding & Gateway Setup durchfĂźhren
+openclaw onboard
+    
+ +
+ Das Kommando openclaw onboard fĂźhrt dich durch die Erstkonfiguration, erstellt das Verzeichnis ~/.openclaw und generiert die zentrale Konfigurationsdatei openclaw.json. +
+ +

7.3 Model-Provider anbinden (Gemini, OpenRouter, Ollama)

+

OpenClaw unterstßtzt eine Vielzahl von KI-Modellanbietern. Du kannst deinen primären API-Schlßssel direkt ßber die CLI registrieren:

+ +

A. Google Gemini (Empfohlen fĂźr hohe Geschwindigkeit & Vision):

+
+# API-Key als Umgebungsvariable oder via CLI konfigurieren
+export GEMINI_API_KEY="dein-google-gemini-api-key"
+
+# Modell zu OpenClaw hinzufĂźgen
+openclaw models add --provider google --model google/gemini-3.5-flash
+    
+ +

B. OpenRouter (Multi-Model & Kostenlose Fallback-Modelle):

+
+export OPENROUTER_API_KEY="dein-openrouter-api-key"
+
+openclaw models add --provider openrouter --model openrouter/openrouter/free
+    
+ +

C. Lokale Modelle via Ollama (Optional fĂźr 100% lokale Vektor-Embeddings):

+
+# Ollama lokal starten & Qwen Embedding Modell laden
+ollama pull qwen3-embedding:0.6b
+
+# Ollama Provider in openclaw.json eintragen (BaseURL: http://127.0.0.1:11434)
+    
+ +

7.4 OpenClaw Gateway & Daemon starten

+

Das Gateway verbindet Chat-Kanäle, Agenten und MCP-Server. Du kannst es im LAN-Modus mit Dashboard starten:

+
+# Gateway im LAN-Modus mit Kontroll-UI starten
+openclaw gateway --bind lan
+
+# Status prĂźfen
+openclaw status
+    
+ +

Gateway als dauerhaften Systemdienst (systemd) einrichten:

+
+# /etc/systemd/system/openclaw.service
+[Unit]
+Description=OpenClaw Gateway Service
+After=network.target
+
+[Service]
+Type=simple
+User=node
+WorkingDirectory=/home/node
+ExecStart=/usr/local/bin/openclaw gateway --bind lan
+Restart=always
+RestartSec=10
+
+[Install]
+WantedBy=multi-user.target
+    
+ +

7.5 Chat-Kanäle anbinden (WebChat, Telegram, Discord)

+

Du kannst Jarvis Ăźber verschiedene Chat-Schnittstellen ansprechen:

+
+# Telegram Bot anbinden
+openclaw channels add telegram --token "DEIN_TELEGRAM_BOT_TOKEN"
+
+# Discord Bot anbinden
+openclaw channels add discord --token "DEIN_DISCORD_BOT_TOKEN"
+    
+ + +

8. Open-Source Nachbau- & Self-Hosting Guide 🚀

+ +

8.1 Infrastruktur & Parameter-Anpassung (WICHTIG für eigene Umgebungen) ⚙️

+ +
+ Wichtiger Hinweis zur eigenen Infrastruktur: Die originalen Skripte enthalten spezifische Beispiel-IPs (z. B. 10.0.1.10) und Beispiel-Domains (pepe44.dev). Um Jarvis in deiner eigenen Umgebung zu betreiben, passe folgende Variablen in deiner openclaw.json bzw. in deinen MCP-Umgebungsvariablen an: +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Konfigurations-ParameterBeispiel im RepoAnpassung fĂźr deine eigene Umgebung
PROM_URLhttp://10.0.1.10:9090IP/URL deines eigenen Prometheus-Servers (z. B. http://192.168.1.50:9090)
GLANCES_URLhttp://10.0.1.10:61208IP/URL deines Glances-Monitoring-Dienstes (z. B. http://localhost:61208)
GITEA_URLhttp://10.0.1.10:30005/api/v1URL deiner Gitea- oder GitHub-API (z. B. http://gitea.local:3000/api/v1)
OPNSENSE_URLhttps://10.0.1.1IP/URL deiner eigenen Firewall (OPNsense / PfSense / Router)
DOMAIN_NAMEpepe44.devDeine eigene Domain (z. B. deine-domain.de) in jarvis.deploy.json & Cloudflare
OPENCLAW_STATE_DIR/home/node/.openclawDein persĂśnliches OpenClaw-Verzeichnis (z. B. /home/user/.openclaw)
+ +

8.2 Agenten-Matrix in openclaw.json etablieren

+

Passe die Agenten-Matrix in deiner ~/.openclaw/openclaw.json an deine eigenen Anforderungen an:

+
+{
+  "agents": {
+    "defaults": {
+      "model": {
+        "primary": "google/gemini-3.5-flash",
+        "fallbacks": ["openrouter/openrouter/free"]
+      }
+    },
+    "entries": {
+      "jarvis": {
+        "name": "Jarvis",
+        "workspace": "/home/user/.openclaw/workspaces/jarvis",
+        "subagents": {
+          "allowAgents": ["developer", "infrastructure", "deploy", "security", "qa"]
+        }
+      },
+      "developer": {
+        "name": "Developer Agent",
+        "workspace": "/home/user/.openclaw/workspaces/developer",
+        "tools": { "profile": "coding" }
+      },
+      "infrastructure": {
+        "name": "Infrastructure Agent",
+        "workspace": "/home/user/.openclaw/workspaces/infrastructure"
+      }
+    }
+  }
+}
+    
+ +

8.3 Generische MCP-Server mit eigenen Umgebungsvariablen konfigurieren

+

Erstelle deine Stdio-MCP-Server unter ~/.openclaw/mcp/my-server.js und Ăźbergib deine spezifischen Server-IPs Ăźber das env-Objekt in openclaw.json:

+
+"mcp": {
+  "servers": {
+    "unraid-monitor": {
+      "enabled": true,
+      "command": "node",
+      "args": ["/home/user/.openclaw/mcp/unraid-monitor.js"],
+      "transport": "stdio",
+      "env": {
+        "PROM_URL": "http://DEINE_SERVER_IP:9090",
+        "GLANCES_URL": "http://DEINE_SERVER_IP:61208"
+      }
+    }
+  }
+}
+    
+ +

8.4 SSH-Wächter auf deine eigene Serverstruktur anpassen

+

Passe das Wächter-Skript /root/.ssh/jarvis-guard.sh auf deiner eigenen Maschine an. Trage dort Pfade ein, die Jarvis nicht verändern darf (z. B. deine Datenbanken, Nginx-Konfigurationen oder Produktiv-Projekte):

+
+#!/bin/bash
+# /root/.ssh/jarvis-guard.sh - Deines eigenen Hosts
+CMD="$SSH_ORIGINAL_COMMAND"
+
+# Blockiere destruktive Systemkommandos
+if [[ "$CMD" =~ (mkfs|wipefs|shutdown|reboot|poweroff) ]]; then
+  echo "REJECTED: Destruktiver Befehl blockiert." >&2
+  exit 1
+fi
+
+# FĂźhre den erlaubten Befehl aus
+exec /bin/bash -c "$CMD"
+    
+ +

8.5 Web-Deployment & Cloudflare DNS konfigurieren

+

Erstelle in deinen Projekten ein jarvis.deploy.json Manifest mit deiner eigenen Domain:

+
+{
+  "domain": "wiki.deine-domain.de",
+  "client": "dein-webhosting-user",
+  "runtime": "static",
+  "web_root": ".",
+  "health_path": "/"
+}
+    
+ +

9. Repository-Struktur & Open-Source Contributions

+

Das geplante Open-Source Repository ist wie folgt aufgebaut:

+
+openclaw-jarvis/
+├── README.md               # Quickstart & Einrichtungsanleitung
+├── LICENSE                 # MIT License
+├── config/                 # Beispiel-Konfigurationen & Parameter-Templates
+├── mcp/                    # Quellcode aller 20 Custom MCP-Server
+│   ├── gitea-workflow.js
+│   ├── docker-control.js
+│   ├── openclaw-diagnostics.js
+│   └── web-deploy.js
+├── workspaces/             # Vorlagen für Agenten-AGENTS.md & Workspaces
+└── tools/                  # Wächter-Skripte & Deployment-Helper
+    
+ +
+ Open Source Lizenz: Dieses Projekt steht unter der MIT Lizenz. Weiterentwicklung und Pull Requests sind willkommen! +
+ +
+
+ + + +