Files
openclaw-frontend/wiki/index.html
T

753 lines
28 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Jarvispedia – Freies Open-Source KI-Wiki & Ausführliche Anleitung | pepe44.dev</title>
<meta name="description" content="Ausführliche Open-Source Dokumentation & Schritt-für-Schritt Nachbau-Anleitung für OpenClaw & Jarvis. Inklusive OpenClaw Installation, Model-Provider, MCP-Server, Agenten-Matrix & Security Guardrails.">
<meta name="keywords" content="OpenClaw Installation, OpenClaw Setup Guide, Jarvis, OpenClaw Wiki, Self-Hosted AI Guide, MCP Server Dokumentation, KI Butler Nachbau, Open Source AI, OpenClaw CLI">
<meta name="author" content="Pascal (@pepe)">
<meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1">
<link rel="canonical" href="https://jarvis-wiki.pepe44.dev/">
<!-- Open Graph / Facebook -->
<meta property="og:type" content="article">
<meta property="og:url" content="https://jarvis-wiki.pepe44.dev/">
<meta property="og:title" content="Jarvispedia – Freies Open-Source KI-Wiki & Ausführliche Anleitung">
<meta property="og:description" content="Umfassende Dokumentation & Schritt-für-Schritt OpenClaw Installations-Anleitung für Jarvis & Self-Hosted AI Systems.">
<meta property="og:site_name" content="Jarvispedia Wiki">
<meta property="og:locale" content="de_DE">
<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:url" content="https://jarvis-wiki.pepe44.dev/">
<meta name="twitter:title" content="Jarvispedia – Freies Open-Source KI-Wiki & Ausführliche Anleitung">
<meta name="twitter:description" content="Umfassende Dokumentation & Schritt-für-Schritt OpenClaw Installations-Anleitung für Jarvis & Self-Hosted AI Systems.">
<!-- Schema.org JSON-LD Structured Data -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "TechArticle",
"headline": "OpenClaw & Jarvis Vollständige Installations- & Nachbauanleitung",
"description": "Umfassende Dokumentation und detaillierte Schritt-für-Schritt Anleitung zur Installation von OpenClaw, Konfiguration von Modell-Providern, Spezialagenten und Custom MCP-Servern.",
"author": {
"@type": "Person",
"name": "Pascal (@pepe)"
},
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://jarvis-wiki.pepe44.dev/"
}
}
</script>
<style>
:root {
--bg: #ffffff;
--text: #202122;
--header-bg: #f8f9fa;
--border: #a2a9b1;
--link: #3366cc;
--infobox-bg: #f8f9fa;
--code-bg: #f8f9fa;
--note-bg: #eaf3ff;
--note-border: #3366cc;
--alert-bg: #fff8e6;
--alert-border: #f59e0b;
--success-bg: #eefbe7;
--success-border: #2e7d32;
}
[data-theme="dark"] {
--bg: #1a1a1a;
--text: #e0e0e0;
--header-bg: #2d2d2d;
--border: #444444;
--link: #66b2ff;
--infobox-bg: #252525;
--code-bg: #2b2b2b;
--note-bg: #1e2d42;
--note-border: #66b2ff;
--alert-bg: #322611;
--alert-border: #f59e0b;
--success-bg: #182e18;
--success-border: #4caf50;
}
body {
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
background-color: var(--bg);
color: var(--text);
margin: 0;
padding: 0;
line-height: 1.6;
font-size: 14.5px;
}
header {
background-color: var(--header-bg);
border-bottom: 1px solid var(--border);
padding: 12px 24px;
display: flex;
justify-content: space-between;
align-items: center;
position: sticky;
top: 0;
z-index: 100;
}
.logo-title {
display: flex;
align-items: center;
gap: 14px;
}
.site-name {
font-family: 'Linux Libertine', 'Georgia', 'Times', serif;
font-size: 24px;
font-weight: normal;
margin: 0;
letter-spacing: 0.5px;
}
.search-box input {
padding: 7px 14px;
border: 1px solid var(--border);
border-radius: 4px;
background: var(--bg);
color: var(--text);
width: 260px;
}
.main-container {
max-width: 1240px;
margin: 25px auto;
padding: 0 24px;
display: grid;
grid-template-columns: 240px 1fr;
gap: 30px;
}
.sidebar {
border-right: 1px solid var(--border);
padding-right: 18px;
}
.sidebar h3 {
font-size: 12px;
text-transform: uppercase;
color: #72777d;
margin-top: 18px;
border-bottom: 1px solid var(--border);
padding-bottom: 4px;
letter-spacing: 0.5px;
}
.sidebar ul {
list-style: none;
padding: 0;
margin: 0;
}
.sidebar li {
margin: 8px 0;
}
.sidebar a {
color: var(--link);
text-decoration: none;
font-size: 13.5px;
}
.sidebar a:hover {
text-decoration: underline;
}
.content {
min-width: 0;
}
h1.page-title {
font-family: 'Linux Libertine', 'Georgia', 'Times', serif;
font-size: 32px;
border-bottom: 1px solid var(--border);
margin-top: 0;
padding-bottom: 8px;
font-weight: normal;
}
.infobox {
float: right;
width: 310px;
background-color: var(--infobox-bg);
border: 1px solid var(--border);
margin: 0 0 20px 24px;
padding: 12px;
font-size: 13px;
box-shadow: 0 2px 6px rgba(0,0,0,0.05);
}
.infobox-title {
text-align: center;
font-weight: bold;
font-size: 16px;
background: #eaecf0;
color: #000;
padding: 8px;
margin: -12px -12px 12px -12px;
}
[data-theme="dark"] .infobox-title {
background: #333333;
color: #fff;
}
.infobox table {
width: 100%;
border-collapse: collapse;
}
.infobox td, .infobox th {
padding: 5px 6px;
vertical-align: top;
text-align: left;
}
.infobox th {
width: 42%;
}
.toc {
background-color: var(--infobox-bg);
border: 1px solid var(--border);
display: inline-block;
padding: 14px 24px;
margin: 20px 0;
font-size: 13.5px;
border-radius: 3px;
}
.toc-title {
font-weight: bold;
text-align: center;
margin-bottom: 10px;
}
.toc ol {
margin: 0;
padding-left: 22px;
}
.toc li {
margin: 5px 0;
}
.toc a {
color: var(--link);
text-decoration: none;
}
table.wikitable {
width: 100%;
border-collapse: collapse;
margin: 18px 0;
font-size: 13.5px;
}
table.wikitable th, table.wikitable td {
border: 1px solid var(--border);
padding: 9px 13px;
}
table.wikitable th {
background-color: var(--header-bg);
text-align: left;
}
.badge {
display: inline-block;
padding: 2px 8px;
border-radius: 12px;
font-size: 11px;
font-weight: bold;
color: #fff;
}
.badge-success { background-color: #2e7d32; }
.badge-info { background-color: #0288d1; }
.badge-warn { background-color: #ed6c02; }
code {
background: var(--code-bg);
border: 1px solid var(--border);
padding: 2px 6px;
border-radius: 3px;
font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;
font-size: 12.5px;
}
pre {
background: var(--code-bg);
border: 1px solid var(--border);
padding: 14px;
border-radius: 4px;
overflow-x: auto;
font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;
font-size: 13px;
}
.note-box {
background-color: var(--note-bg);
border-left: 4px solid var(--note-border);
padding: 12px 18px;
margin: 18px 0;
border-radius: 0 4px 4px 0;
}
.alert-box {
background-color: var(--alert-bg);
border-left: 4px solid var(--alert-border);
padding: 12px 18px;
margin: 18px 0;
border-radius: 0 4px 4px 0;
}
.success-box {
background-color: var(--success-bg);
border-left: 4px solid var(--success-border);
padding: 12px 18px;
margin: 18px 0;
border-radius: 0 4px 4px 0;
}
.theme-toggle {
cursor: pointer;
background: none;
border: 1px solid var(--border);
padding: 6px 12px;
border-radius: 4px;
color: var(--text);
}
</style>
</head>
<body>
<header>
<div class="logo-title">
<span style="font-size:32px">😏</span>
<div>
<h1 class="site-name">JARVISPEDIA</h1>
<small style="color:#72777d">Die freie Open-Source Enzyklopädie & Vollständige Anleitung für Jarvis & OpenClaw</small>
</div>
</div>
<div style="display:flex; gap:12px; align-items:center;">
<div class="search-box">
<input type="text" id="searchInput" placeholder="Jarvispedia durchsuchen..." onkeyup="filterContent()">
</div>
<button class="theme-toggle" onclick="toggleTheme()">🌗 Dark/Light Mode</button>
</div>
</header>
<div class="main-container">
<div class="sidebar">
<h3>Open-Source Sites</h3>
<ul>
<li><a href="https://jarvis-landing.pepe44.dev/" target="_blank">🌐 Landing Page</a></li>
</ul>
<h3>Navigation</h3>
<ul>
<li><a href="#uebersicht">1. Übersicht</a></li>
<li><a href="#architektur">2. Architektur</a></li>
<li><a href="#agenten">3. Spezialagenten</a></li>
<li><a href="#mcp">4. MCP-Flotte</a></li>
<li><a href="#sicherheit">5. Sicherheit</a></li>
<li><a href="#speicher">6. Gedächtnis</a></li>
<li><a href="#openclaw-install">7. OpenClaw Installation 🛠️</a></li>
<li><a href="#setup-guide">8. Nachbau-Anleitung 🚀</a></li>
<li><a href="#customization">8.1 Parameter-Anpassung ⚙️</a></li>
<li><a href="#opensource">9. Open Source Repo</a></li>
</ul>
<h3>Schnellzugriff</h3>
<ul>
<li><a href="#install-prereqs">Voraussetzungen</a></li>
<li><a href="#install-cli">CLI Installation</a></li>
<li><a href="#install-provider">Model-Provider</a></li>
<li><a href="#customization">Eigene IPs & Domains</a></li>
<li><a href="#guide-step3">Custom MCPs</a></li>
<li><a href="#guide-step4">Host-Wächter</a></li>
</ul>
</div>
<div class="content">
<h1 class="page-title">Jarvis (KI-Orchestrator & Self-Hosted Butler)</h1>
<div class="infobox">
<div class="infobox-title">Jarvis Open-Source Stack</div>
<div style="text-align:center; padding:12px;">
<span style="font-size:64px">😏</span>
</div>
<table>
<tr><th>Projekt-Typ</th><td>Open Source KI-Butler</td></tr>
<tr><th>Autor / Creator</th><td>Pascal (@pepe)</td></tr>
<tr><th>Basis-Laufzeit</th><td>OpenClaw v2026.9.7</td></tr>
<tr><th>Host OS</th><td>Linux (Unraid / Debian / Ubuntu)</td></tr>
<tr><th>Node.js Version</th><td>v20.x / v24.x</td></tr>
<tr><th>Primärmodell</th><td>Google Gemini / OpenRouter Free</td></tr>
<tr><th>Spezialagenten</th><td><span class="badge badge-success">11 Aktiv</span></td></tr>
<tr><th>MCP-Server</th><td><span class="badge badge-info">20 Registriert</span></td></tr>
<tr><th>Lizenz</th><td>MIT License (Open Source)</td></tr>
<tr><th>Status</th><td><span class="badge badge-success">Production / Live</span></td></tr>
</table>
</div>
<p><b>Jarvis</b> 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.</p>
<div class="toc">
<div class="toc-title">Inhaltsverzeichnis</div>
<ol>
<li><a href="#uebersicht">1 Übersicht & Philosophie</a></li>
<li><a href="#architektur">2 Systemarchitektur & Host-Topologie</a></li>
<li><a href="#agenten">3 Spezialagenten-Matrix (11 Agenten)</a></li>
<li><a href="#mcp">4 MCP-Server Landschaft (20 Server)</a></li>
<li><a href="#sicherheit">5 Sicherheits- & Rechtekonzept</a></li>
<li><a href="#speicher">6 Gedächtnis- & Wissensspeicher</a></li>
<li><a href="#openclaw-install">7 OpenClaw Installations-Anleitung (Schritt-für-Schritt) 🛠️</a>
<ol>
<li><a href="#install-prereqs">7.1 Systemvoraussetzungen (Node.js, Git, PM2)</a></li>
<li><a href="#install-cli">7.2 OpenClaw CLI Installation & Initialisierung</a></li>
<li><a href="#install-provider">7.3 Model-Provider anbinden (Gemini, OpenRouter, Ollama)</a></li>
<li><a href="#install-gateway">7.4 OpenClaw Gateway & Daemon starten</a></li>
<li><a href="#install-channels">7.5 Chat-Kanäle anbinden (WebChat, Telegram, Discord)</a></li>
</ol>
</li>
<li><a href="#setup-guide">8 Open-Source Nachbau- & Self-Hosting Guide 🚀</a>
<ol>
<li><a href="#customization">8.1 Infrastruktur & Parameter-Anpassung ⚙️</a></li>
<li><a href="#guide-step2">8.2 Agenten-Matrix anpassen</a></li>
<li><a href="#guide-step3">8.3 Generische MCP-Server konfigurieren</a></li>
<li><a href="#guide-step4">8.4 Host-Wächter & SSH-Schutz</a></li>
<li><a href="#guide-step5">8.5 Web-Deployment & Cloudflare DNS</a></li>
</ol>
</li>
<li><a href="#opensource">9 Repository-Struktur & Contributions</a></li>
</ol>
</div>
<h2 id="uebersicht">1. Übersicht & Philosophie</h2>
<p>Jarvis agiert als vertrauter digitaler Partner. Das System basiert auf drei Kernprinzipien:</p>
<ul>
<li><b>Modularität durch Subagenten:</b> Jarvis delegiert Spezialaufgaben an eigens konfigurierte Agenten (z. B. <code>developer</code>, <code>deploy</code>, <code>security</code>, <code>qa</code>).</li>
<li><b>Erweiterbarkeit durch MCP:</b> Anbindung externer APIs, Smart-Home-Komponenten, Passwörter und Firewalls über eigenständige Stdio-MCP-Server.</li>
<li><b>Sicherheit & Validierung:</b> Änderungen an der Kern-Konfiguration werden über Revision-Locks und Validierungs-Pipelines geschützt.</li>
</ul>
<h2 id="architektur">2. Systemarchitektur & Host-Topologie</h2>
<p>Das System läuft auf einem Linux-Host (Unraid, Ubuntu, Debian oder VM). Das OpenClaw-Laufzeitverzeichnis bildet die zentrale Schaltstelle:</p>
<pre>
~/.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
</pre>
<h2 id="agenten">3. Spezialagenten-Matrix</h2>
<table class="wikitable">
<thead>
<tr>
<th>ID</th>
<th>Name</th>
<th>Profil</th>
<th>Hauptaufgabe</th>
</tr>
</thead>
<tbody>
<tr><td><code>jarvis</code></td><td>Jarvis</td><td>Full</td><td>Haupt-Orchestrierung, Nutzerinteraktion & Subagenten-Steuerung</td></tr>
<tr><td><code>developer</code></td><td>Developer Agent</td><td>Coding</td><td>Software-Entwicklung, Refactoring & Code-Analysen</td></tr>
<tr><td><code>infrastructure</code></td><td>Infrastructure Agent</td><td>Inherit</td><td>Unraid-, Glances-, Prometheus- & Service-Monitoring</td></tr>
<tr><td><code>deploy</code></td><td>Deploy Agent</td><td>Inherit</td><td>Webhosting (KeyHelp API), Release-Deployments & Cloudflare DNS</td></tr>
<tr><td><code>security</code></td><td>Security Agent</td><td>Inherit</td><td>Bitwarden-Credentials, OPNsense Firewall & Sicherheits-Audits</td></tr>
<tr><td><code>qa</code></td><td>QA Agent</td><td>Inherit</td><td>Qualitätssicherung, Testing & Code-Reviews</td></tr>
<tr><td><code>mail</code></td><td>Mail Agent</td><td>Inherit</td><td>Delegiertes IMAPS-Postfach Management</td></tr>
<tr><td><code>paperless</code></td><td>Paperless Agent</td><td>Inherit</td><td>Dokumentenarchivierung & Inhaltsanalyse</td></tr>
<tr><td><code>calendar</code></td><td>Calendar Agent</td><td>Inherit</td><td>Termine & Kalender-Verwaltung</td></tr>
<tr><td><code>tasks</code></td><td>Task Agent</td><td>Inherit</td><td>Aufgaben- und Todo-Steuerung</td></tr>
<tr><td><code>research</code></td><td>Research Agent</td><td>Inherit</td><td>Web-Recherche, Datenbeschaffung & Synthese</td></tr>
</tbody>
</table>
<h2 id="mcp">4. MCP-Server Landschaft (20 Server)</h2>
<p>Über das Model Context Protocol (MCP) greift Jarvis auf 20 spezialisierte Server zu:</p>
<ul>
<li><b>Eigenverwaltung:</b> <code>openclaw-self-edit</code>, <code>openclaw-diagnostics</code>, <code>shell-tools</code></li>
<li><b>Infrastruktur & Monitoring:</b> <code>unraid-monitor</code>, <code>service-health</code>, <code>docker-control</code>, <code>prometheus</code>, <code>glances</code></li>
<li><b>Hosting & Workflows:</b> <code>web-deploy</code>, <code>gitea-workflow</code>, <code>youtrack</code></li>
<li><b>Sicherheit & Wissen:</b> <code>bitwarden</code>, <code>opnsense</code>, <code>obsidian</code>, <code>memos</code></li>
<li><b>Vision & Smart Home:</b> <code>homeassistant</code>, <code>face</code>, <code>cat</code>, <code>mail</code>, <code>windows</code></li>
</ul>
<h2 id="sicherheit">5. Sicherheits- & Rechtekonzept</h2>
<p>Der Nachbau setzt auf eine gehärtete 3-Säulen-Sicherheitsarchitektur:</p>
<ol>
<li><b>SSH Host-Wächter (<code>jarvis-guard.sh</code>):</b> Filtert eingehende SSH-Befehle und blockiert destruktive Systemkommandos.</li>
<li><b>Workspace-Sandbox:</b> Schreibvorfälle auf Dateiebene sind strikt auf den eigenen Workspace begrenzt.</li>
<li><b>Mutation Leases:</b> Änderungen an <code>openclaw.json</code> erfordern Revisions-Token und Validierungs-Checks.</li>
</ol>
<h2 id="speicher">6. Gedächtnis- & Wissensspeicher</h2>
<p>Jarvis speichert Kernwissen in <code>MEMORY.md</code>, Nutzerpräferenzen in <code>USER.md</code> und synchronisiert erweiterte Dokumentationen direkt mit dem Obsidian LiveSync Vault (<code>obsidiannotes</code>).</p>
<!-- AUSFÜHRLICHER OPENCLAW INSTALLATIONS-GUIDE -->
<h2 id="openclaw-install">7. OpenClaw Installations-Anleitung (Schritt-für-Schritt) 🛠️</h2>
<div class="success-box">
<b>Vollständige Installations-Anleitung:</b> 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.
</div>
<h3 id="install-prereqs">7.1 Systemvoraussetzungen</h3>
<p>Bevor du OpenClaw installierst, stelle sicher, dass folgende Software auf deinem Linux-Server vorhanden ist:</p>
<ul>
<li><b>Betriebssystem:</b> Linux (Ubuntu 22.04/24.04 LTS, Debian 12, Unraid 6.12+, Arch oder CentOS)</li>
<li><b>Node.js:</b> Version <code>v20.x</code> oder <code>v24.x</code> (LTS wird empfohlen)</li>
<li><b>NPM / Git:</b> Aktuelle Versionen für Modul-Management und Repository-Cloning</li>
<li><b>Process Manager (Optional):</b> <code>pm2</code> oder <code>systemd</code> zur Hintergrund-Überwachung</li>
</ul>
<p><b>Node.js & NVM Installation auf Linux:</b></p>
<pre>
# 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
</pre>
<h3 id="install-cli">7.2 OpenClaw CLI Installation & Initialisierung</h3>
<p>Das OpenClaw Framework wird als globales Node.js Paket installiert. Führe folgende Befehle auf deinem Server aus:</p>
<pre>
# 1. OpenClaw global installieren
npm install -g openclaw
# 2. Installation überprüfen
openclaw --version
# 3. Interaktives Onboarding & Gateway Setup durchführen
openclaw onboard
</pre>
<div class="note-box">
Das Kommando <code>openclaw onboard</code> führt dich durch die Erstkonfiguration, erstellt das Verzeichnis <code>~/.openclaw</code> und generiert die zentrale Konfigurationsdatei <code>openclaw.json</code>.
</div>
<h3 id="install-provider">7.3 Model-Provider anbinden (Gemini, OpenRouter, Ollama)</h3>
<p>OpenClaw unterstützt eine Vielzahl von KI-Modellanbietern. Du kannst deinen primären API-Schlüssel direkt über die CLI registrieren:</p>
<p><b>A. Google Gemini (Empfohlen für hohe Geschwindigkeit & Vision):</b></p>
<pre>
# 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
</pre>
<p><b>B. OpenRouter (Multi-Model & Kostenlose Fallback-Modelle):</b></p>
<pre>
export OPENROUTER_API_KEY="dein-openrouter-api-key"
openclaw models add --provider openrouter --model openrouter/openrouter/free
</pre>
<p><b>C. Lokale Modelle via Ollama (Optional für 100% lokale Vektor-Embeddings):</b></p>
<pre>
# 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)
</pre>
<h3 id="install-gateway">7.4 OpenClaw Gateway & Daemon starten</h3>
<p>Das Gateway verbindet Chat-Kanäle, Agenten und MCP-Server. Du kannst es im LAN-Modus mit Dashboard starten:</p>
<pre>
# Gateway im LAN-Modus mit Kontroll-UI starten
openclaw gateway --bind lan
# Status prüfen
openclaw status
</pre>
<p><b>Gateway als dauerhaften Systemdienst (systemd) einrichten:</b></p>
<pre>
# /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
</pre>
<h3 id="install-channels">7.5 Chat-Kanäle anbinden (WebChat, Telegram, Discord)</h3>
<p>Du kannst Jarvis über verschiedene Chat-Schnittstellen ansprechen:</p>
<pre>
# Telegram Bot anbinden
openclaw channels add telegram --token "DEIN_TELEGRAM_BOT_TOKEN"
# Discord Bot anbinden
openclaw channels add discord --token "DEIN_DISCORD_BOT_TOKEN"
</pre>
<!-- ANPASSUNGS-GUIDE FÜR OPEN-SOURCE USERS -->
<h2 id="setup-guide">8. Open-Source Nachbau- & Self-Hosting Guide 🚀</h2>
<h3 id="customization">8.1 Infrastruktur & Parameter-Anpassung (WICHTIG für eigene Umgebungen) ⚙️</h3>
<div class="alert-box">
<b>Wichtiger Hinweis zur eigenen Infrastruktur:</b> Die originalen Skripte enthalten spezifische Beispiel-IPs (z. B. <code>10.0.1.10</code>) und Beispiel-Domains (<code>pepe44.dev</code>). Um Jarvis in deiner eigenen Umgebung zu betreiben, passe folgende Variablen in deiner <code>openclaw.json</code> bzw. in deinen MCP-Umgebungsvariablen an:
</div>
<table class="wikitable">
<thead>
<tr>
<th>Konfigurations-Parameter</th>
<th>Beispiel im Repo</th>
<th>Anpassung für deine eigene Umgebung</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>PROM_URL</code></td>
<td><code>http://10.0.1.10:9090</code></td>
<td>IP/URL deines eigenen Prometheus-Servers (z. B. <code>http://192.168.1.50:9090</code>)</td>
</tr>
<tr>
<td><code>GLANCES_URL</code></td>
<td><code>http://10.0.1.10:61208</code></td>
<td>IP/URL deines Glances-Monitoring-Dienstes (z. B. <code>http://localhost:61208</code>)</td>
</tr>
<tr>
<td><code>GITEA_URL</code></td>
<td><code>http://10.0.1.10:30005/api/v1</code></td>
<td>URL deiner Gitea- oder GitHub-API (z. B. <code>http://gitea.local:3000/api/v1</code>)</td>
</tr>
<tr>
<td><code>OPNSENSE_URL</code></td>
<td><code>https://10.0.1.1</code></td>
<td>IP/URL deiner eigenen Firewall (OPNsense / PfSense / Router)</td>
</tr>
<tr>
<td><code>DOMAIN_NAME</code></td>
<td><code>pepe44.dev</code></td>
<td>Deine eigene Domain (z. B. <code>deine-domain.de</code>) in <code>jarvis.deploy.json</code> & Cloudflare</td>
</tr>
<tr>
<td><code>OPENCLAW_STATE_DIR</code></td>
<td><code>/home/node/.openclaw</code></td>
<td>Dein persönliches OpenClaw-Verzeichnis (z. B. <code>/home/user/.openclaw</code>)</td>
</tr>
</tbody>
</table>
<h3 id="guide-step2">8.2 Agenten-Matrix in openclaw.json etablieren</h3>
<p>Passe die Agenten-Matrix in deiner <code>~/.openclaw/openclaw.json</code> an deine eigenen Anforderungen an:</p>
<pre>
{
"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"
}
}
}
}
</pre>
<h3 id="guide-step3">8.3 Generische MCP-Server mit eigenen Umgebungsvariablen konfigurieren</h3>
<p>Erstelle deine Stdio-MCP-Server unter <code>~/.openclaw/mcp/my-server.js</code> und übergib deine spezifischen Server-IPs über das <code>env</code>-Objekt in <code>openclaw.json</code>:</p>
<pre>
"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"
}
}
}
}
</pre>
<h3 id="guide-step4">8.4 SSH-Wächter auf deine eigene Serverstruktur anpassen</h3>
<p>Passe das Wächter-Skript <code>/root/.ssh/jarvis-guard.sh</code> auf deiner eigenen Maschine an. Trage dort Pfade ein, die Jarvis <b>nicht</b> verändern darf (z. B. deine Datenbanken, Nginx-Konfigurationen oder Produktiv-Projekte):</p>
<pre>
#!/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"
</pre>
<h3 id="guide-step5">8.5 Web-Deployment & Cloudflare DNS konfigurieren</h3>
<p>Erstelle in deinen Projekten ein <code>jarvis.deploy.json</code> Manifest mit deiner eigenen Domain:</p>
<pre>
{
"domain": "wiki.deine-domain.de",
"client": "dein-webhosting-user",
"runtime": "static",
"web_root": ".",
"health_path": "/"
}
</pre>
<h2 id="opensource">9. Repository-Struktur & Open-Source Contributions</h2>
<p>Das geplante Open-Source Repository ist wie folgt aufgebaut:</p>
<pre>
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
</pre>
<div class="note-box" style="margin-top:25px;">
<b>Open Source Lizenz:</b> Dieses Projekt steht unter der <b>MIT Lizenz</b>. Weiterentwicklung und Pull Requests sind willkommen!
</div>
</div>
</div>
<script>
function toggleTheme() {
const current = document.body.getAttribute('data-theme');
if (current === 'dark') {
document.body.removeAttribute('data-theme');
} else {
document.body.setAttribute('data-theme', 'dark');
}
}
function filterContent() {
const query = document.getElementById('searchInput').value.toLowerCase();
const rows = document.querySelectorAll('table.wikitable tbody tr');
rows.forEach(row => {
const text = row.innerText.toLowerCase();
row.style.display = text.includes(query) ? '' : 'none';
});
}
</script>
</body>
</html>