Jarvis (KI-Orchestrator & Self-Hosted Butler)
| Projekt-Typ | Open Source KI-Butler |
|---|---|
| Autor / Creator | Pascal (@pepe) |
| Basis-Laufzeit | OpenClaw v2026.9.7 |
| Host OS | Linux (Unraid / Debian / Ubuntu) |
| Node.js Version | v20.x / v24.x |
| Primärmodell | Google Gemini / OpenRouter Free |
| Spezialagenten | 11 Aktiv |
| MCP-Server | 20 Registriert |
| Lizenz | MIT License (Open Source) |
| Status | Production / 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
- 2 Systemarchitektur & Host-Topologie
- 3 Spezialagenten-Matrix (11 Agenten)
- 4 MCP-Server Landschaft (20 Server)
- 5 Sicherheits- & Rechtekonzept
- 6 Gedächtnis- & Wissensspeicher
- 7 OpenClaw Installations-Anleitung (Schritt-für-Schritt) 🛠️
- 8 Open-Source Nachbau- & Self-Hosting Guide 🚀
- 9 Repository-Struktur & Contributions
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
| ID | Name | Profil | Hauptaufgabe |
|---|---|---|---|
jarvis | Jarvis | Full | Haupt-Orchestrierung, Nutzerinteraktion & Subagenten-Steuerung |
developer | Developer Agent | Coding | Software-Entwicklung, Refactoring & Code-Analysen |
infrastructure | Infrastructure Agent | Inherit | Unraid-, Glances-, Prometheus- & Service-Monitoring |
deploy | Deploy Agent | Inherit | Webhosting (KeyHelp API), Release-Deployments & Cloudflare DNS |
security | Security Agent | Inherit | Bitwarden-Credentials, OPNsense Firewall & Sicherheits-Audits |
qa | QA Agent | Inherit | Qualitätssicherung, Testing & Code-Reviews |
mail | Mail Agent | Inherit | Delegiertes IMAPS-Postfach Management |
paperless | Paperless Agent | Inherit | Dokumentenarchivierung & Inhaltsanalyse |
calendar | Calendar Agent | Inherit | Termine & Kalender-Verwaltung |
tasks | Task Agent | Inherit | Aufgaben- und Todo-Steuerung |
research | Research Agent | Inherit | Web-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:
- SSH Host-Wächter (
jarvis-guard.sh): Filtert eingehende SSH-Befehle und blockiert destruktive Systemkommandos. - Workspace-Sandbox: Schreibvorfälle auf Dateiebene sind strikt auf den eigenen Workspace begrenzt.
- Mutation Leases: Änderungen an
openclaw.jsonerfordern Revisions-Token und Validierungs-Checks.
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) 🛠️
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.xoderv24.x(LTS wird empfohlen) - NPM / Git: Aktuelle Versionen für Modul-Management und Repository-Cloning
- Process Manager (Optional):
pm2odersystemdzur 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
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) ⚙️
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-Parameter | Beispiel im Repo | Anpassung für deine eigene Umgebung |
|---|---|---|
PROM_URL |
http://10.0.1.10:9090 |
IP/URL deines eigenen Prometheus-Servers (z. B. http://192.168.1.50:9090) |
GLANCES_URL |
http://10.0.1.10:61208 |
IP/URL deines Glances-Monitoring-Dienstes (z. B. http://localhost:61208) |
GITEA_URL |
http://10.0.1.10:30005/api/v1 |
URL deiner Gitea- oder GitHub-API (z. B. http://gitea.local:3000/api/v1) |
OPNSENSE_URL |
https://10.0.1.1 |
IP/URL deiner eigenen Firewall (OPNsense / PfSense / Router) |
DOMAIN_NAME |
pepe44.dev |
Deine eigene Domain (z. B. deine-domain.de) in jarvis.deploy.json & Cloudflare |
OPENCLAW_STATE_DIR |
/home/node/.openclaw |
Dein 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