😏

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:

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
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:

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. Workspace-Sandbox: Schreibvorfälle auf Dateiebene sind strikt auf den eigenen Workspace begrenzt.
  3. Mutation Leases: Änderungen an openclaw.json erfordern 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) 🛠️

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:

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-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:

Open-Source Gitea Repositories:
├── Frontend Repo: http://10.0.1.10:30005/Pepe44DEV/openclaw-frontend
└── Backend Repo:  http://10.0.1.10:30005/Pepe44DEV/openclaw-backend
Open Source Lizenz: Dieses Projekt steht unter der MIT Lizenz. Weiterentwicklung und Pull Requests sind willkommen!