Uebersicht
JARVIS ist ein KI-Assistent basierend auf Clawdbot (Claude/Anthropic). Er laeuft als Gateway-Service und kommuniziert ueber Matrix.
1. System
| Eigenschaft | Wert |
|---|---|
| Name | JARVIS |
| Basis | Clawdbot (Anthropic Claude) |
| Server | <HOSTNAME> (<IP-ADRESSE>) |
| Gateway Port | 18789 |
| Workspace | /root/clawd |
| Kanal | Matrix (@<BOT-USER>:<HOMESERVER>) |
2. Faehigkeiten
- Dateien lesen, schreiben, bearbeiten
- Shell-Befehle ausfuehren
- Web-Suche (Brave API)
- Browser-Automatisierung
- Cron-Jobs (periodische Tasks)
- Memory-System (Kontext ueber Sessions)
- Sprachnachrichten (Whisper STT)
- Home Assistant Steuerung
- Email-Monitoring (IMAP/SMTP)
- XWiki Dokumentation
- Zammad Ticket-System
3. Installation
# Node.js 18+ erforderlich
npm install -g clawdbot
# Interaktives Setup
clawdbot onboard
# Version pruefen
clawdbot --version
npm install -g clawdbot
# Interaktives Setup
clawdbot onboard
# Version pruefen
clawdbot --version
4. Konfiguration
Pfad: /root/.clawdbot/clawdbot.json
4.1 Matrix-Anbindung
{
"channels": {
"matrix": {
"enabled": true,
"homeserver": "https://<MATRIX-SERVER>",
"userId": "@<BOT-USER>:<HOMESERVER>",
"password": "<PASSWORT>",
"dm": {
"policy": "allowlist",
"allowFrom": ["@<OWNER>:<HOMESERVER>"]
},
"encryption": true
}
}
}
"channels": {
"matrix": {
"enabled": true,
"homeserver": "https://<MATRIX-SERVER>",
"userId": "@<BOT-USER>:<HOMESERVER>",
"password": "<PASSWORT>",
"dm": {
"policy": "allowlist",
"allowFrom": ["@<OWNER>:<HOMESERVER>"]
},
"encryption": true
}
}
}
4.2 Whisper (Sprachnachrichten)
pip install openai-whisper
{
"tools": {
"media": {
"audio": {
"enabled": true,
"models": [{
"type": "cli",
"command": "whisper",
"args": ["{{MediaPath}}", "--model", "small", "--language", "de"]
}]
}
}
}
}
"tools": {
"media": {
"audio": {
"enabled": true,
"models": [{
"type": "cli",
"command": "whisper",
"args": ["{{MediaPath}}", "--model", "small", "--language", "de"]
}]
}
}
}
}
5. Gateway Service
# Starten
clawdbot gateway start
# Als systemd Service
clawdbot gateway install
systemctl enable clawdbot-gateway
systemctl start clawdbot-gateway
# Status
clawdbot status
clawdbot gateway status
# Logs
journalctl -u clawdbot-gateway -f
clawdbot gateway start
# Als systemd Service
clawdbot gateway install
systemctl enable clawdbot-gateway
systemctl start clawdbot-gateway
# Status
clawdbot status
clawdbot gateway status
# Logs
journalctl -u clawdbot-gateway -f
6. Workspace-Dateien
| Datei | Zweck |
|---|---|
| AGENTS.md | Verhaltensregeln |
| SOUL.md | Persoenlichkeit |
| USER.md | Benutzer-Info |
| IDENTITY.md | Name und Identitaet |
| TOOLS.md | Lokale Tool-Notizen (Zugangsdaten, IPs) |
| MEMORY.md | Langzeit-Erinnerungen |
| HEARTBEAT.md | Periodische Check-Aufgaben |
| memory/ | Taegliche Logs (YYYY-MM-DD.md) |
| scripts/ | Automatisierungs-Skripte |
7. Integrationen
| System | Zweck | Status |
|---|---|---|
| Matrix | Chat-Kanal | Aktiv |
| Home Assistant | Smart Home Steuerung | Konfiguriert |
| Grafana | Monitoring Alerts | Konfiguriert |
| XWiki | Dokumentation | Konfiguriert |
| Zammad | Ticket-System | Konfiguriert |
| Wazuh | Security Monitoring | Konfiguriert |
| Mailcow/Himalaya | Email-Monitoring | Aktiv |
| Mailpiler | Email-Archivierung | Aktiv |
8. Chat-Befehle
| Befehl | Beschreibung |
|---|---|
| /status | Session-Status anzeigen |
| /reasoning | Extended Thinking ein/aus |
| /model | Modell wechseln |
| /clear | Session zuruecksetzen |
| /help | Hilfe anzeigen |
9. Troubleshooting
# Gateway laeuft?
clawdbot gateway status
# Logs pruefen
journalctl -u clawdbot-gateway -n 50
# Config validieren
clawdbot config validate
# Port belegt?
lsof -i :18789
clawdbot gateway status
# Logs pruefen
journalctl -u clawdbot-gateway -n 50
# Config validieren
clawdbot config validate
# Port belegt?
lsof -i :18789
10. Updates
npm update -g clawdbot
clawdbot gateway restart
clawdbot gateway restart
Erstellt: 2026-02-02 | Ueberarbeitet: 2026-02-03 | Autor: JARVIS