Changes for page JARVIS - KI-Assistent
Last modified by Jarvis on 2026/02/05 08:41
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,183 +1,1 @@ 1 -{{box title="Uebersicht" image="icon:robot"}}JARVIS ist ein KI-Assistent basierend auf Clawdbot (Claude/Anthropic). Er laeuft als Gateway-Service und kommuniziert ueber Matrix.{{/box}} 2 - 3 -= 1. System = 4 - 5 -|=Eigenschaft|=Wert 6 -|Name|JARVIS 7 -|Basis|Clawdbot (Anthropic Claude) 8 -|Server|<HOSTNAME> (<IP-ADRESSE>) 9 -|Gateway Port|18789 10 -|Workspace|/root/clawd 11 -|Kanal|Matrix (@<BOT-USER>:<HOMESERVER>) 12 - 13 ----- 14 - 15 -= 2. Faehigkeiten = 16 - 17 -* Dateien lesen, schreiben, bearbeiten 18 -* Shell-Befehle ausfuehren 19 -* Web-Suche (Brave API) 20 -* Browser-Automatisierung 21 -* Cron-Jobs (periodische Tasks) 22 -* Memory-System (Kontext ueber Sessions) 23 -* Sprachnachrichten (Whisper STT) 24 -* Home Assistant Steuerung 25 -* Email-Monitoring (IMAP/SMTP) 26 -* XWiki Dokumentation 27 -* Zammad Ticket-System 28 - 29 ----- 30 - 31 -= 3. Installation = 32 - 33 -{{code language="bash"}} 34 -# Node.js 18+ erforderlich 35 -npm install -g clawdbot 36 - 37 -# Interaktives Setup 38 -clawdbot onboard 39 - 40 -# Version pruefen 41 -clawdbot --version 42 -{{/code}} 43 - 44 ----- 45 - 46 -= 4. Konfiguration = 47 - 48 -Pfad: {{code language="none"}}/root/.clawdbot/clawdbot.json{{/code}} 49 - 50 -== 4.1 Matrix-Anbindung == 51 - 52 -{{code language="json"}} 53 -{ 54 - "channels": { 55 - "matrix": { 56 - "enabled": true, 57 - "homeserver": "https://<MATRIX-SERVER>", 58 - "userId": "@<BOT-USER>:<HOMESERVER>", 59 - "password": "<PASSWORT>", 60 - "dm": { 61 - "policy": "allowlist", 62 - "allowFrom": ["@<OWNER>:<HOMESERVER>"] 63 - }, 64 - "encryption": true 65 - } 66 - } 67 -} 68 -{{/code}} 69 - 70 -== 4.2 Whisper (Sprachnachrichten) == 71 - 72 -{{code language="bash"}} 73 -pip install openai-whisper 74 -{{/code}} 75 - 76 -{{code language="json"}} 77 -{ 78 - "tools": { 79 - "media": { 80 - "audio": { 81 - "enabled": true, 82 - "models": [{ 83 - "type": "cli", 84 - "command": "whisper", 85 - "args": ["{{MediaPath}}", "--model", "small", "--language", "de"] 86 - }] 87 - } 88 - } 89 - } 90 -} 91 -{{/code}} 92 - 93 ----- 94 - 95 -= 5. Gateway Service = 96 - 97 -{{code language="bash"}} 98 -# Starten 99 -clawdbot gateway start 100 - 101 -# Als systemd Service 102 -clawdbot gateway install 103 -systemctl enable clawdbot-gateway 104 -systemctl start clawdbot-gateway 105 - 106 -# Status 107 -clawdbot status 108 -clawdbot gateway status 109 - 110 -# Logs 111 -journalctl -u clawdbot-gateway -f 112 -{{/code}} 113 - 114 ----- 115 - 116 -= 6. Workspace-Dateien = 117 - 118 -|=Datei|=Zweck 119 -|AGENTS.md|Verhaltensregeln 120 -|SOUL.md|Persoenlichkeit 121 -|USER.md|Benutzer-Info 122 -|IDENTITY.md|Name und Identitaet 123 -|TOOLS.md|Lokale Tool-Notizen (Zugangsdaten, IPs) 124 -|MEMORY.md|Langzeit-Erinnerungen 125 -|HEARTBEAT.md|Periodische Check-Aufgaben 126 -|memory/|Taegliche Logs (YYYY-MM-DD.md) 127 -|scripts/|Automatisierungs-Skripte 128 - 129 ----- 130 - 131 -= 7. Integrationen = 132 - 133 -|=System|=Zweck|=Status 134 -|Matrix|Chat-Kanal|Aktiv 135 -|Home Assistant|Smart Home Steuerung|Konfiguriert 136 -|Grafana|Monitoring Alerts|Konfiguriert 137 -|XWiki|Dokumentation|Konfiguriert 138 -|Zammad|Ticket-System|Konfiguriert 139 -|Wazuh|Security Monitoring|Konfiguriert 140 -|Mailcow/Himalaya|Email-Monitoring|Aktiv 141 -|Mailpiler|Email-Archivierung|Aktiv 142 - 143 ----- 144 - 145 -= 8. Chat-Befehle = 146 - 147 -|=Befehl|=Beschreibung 148 -|/status|Session-Status anzeigen 149 -|/reasoning|Extended Thinking ein/aus 150 -|/model|Modell wechseln 151 -|/clear|Session zuruecksetzen 152 -|/help|Hilfe anzeigen 153 - 154 ----- 155 - 156 -= 9. Troubleshooting = 157 - 158 -{{code language="bash"}} 159 -# Gateway laeuft? 160 -clawdbot gateway status 161 - 162 -# Logs pruefen 163 -journalctl -u clawdbot-gateway -n 50 164 - 165 -# Config validieren 166 -clawdbot config validate 167 - 168 -# Port belegt? 169 -lsof -i :18789 170 -{{/code}} 171 - 172 ----- 173 - 174 -= 10. Updates = 175 - 176 -{{code language="bash"}} 177 -npm update -g clawdbot 178 -clawdbot gateway restart 179 -{{/code}} 180 - 181 ----- 182 - 183 -//Erstellt: 2026-02-02 | Ueberarbeitet: 2026-02-03 | Autor: JARVIS// 1 += JARVIS - Clawdbot KI-Assistent =Dokumentation der Installation und Konfiguration von JARVIS, dem KI-Assistenten basierend auf Clawdbot.== ��bersicht ==|=Eigenschaft|=Wert|Name|JARVIS|Basis|Clawdbot (Claude-basiert)|Server|clawd (192.168.10.75)|Gateway Port|18789|Workspace|/root/clawd|Kanal|Matrix (@jarvis:matrix.rs-servertech.com)== Was ist Clawdbot? ==Clawdbot ist ein CLI-basierter KI-Assistent, der Claude (Anthropic) nutzt und ��ber verschiedene Messaging-Kan��le erreichbar ist. Er kann:* **Dateien lesen/schreiben/bearbeiten*** **Shell-Befehle ausf��hren*** **Web-Suche** durchf��hren* **Browser automatisieren*** **Cron-Jobs** f��r periodische Aufgaben* **Memory-System** f��r Kontext ��ber Sessions hinweg* **Multi-Channel Support** (Matrix, Telegram, Discord, etc.)== Installation ===== Voraussetzungen ===* Node.js 18+ (empfohlen: v22)* npm* Anthropic API Key=== Installation via npm ==={{code language="bash"}}# Global installierennpm install -g clawdbot# Version pr��fenclawdbot --version{{/code}}=== Onboarding ==={{code language="bash"}}# Interaktives Setupclawdbot onboard# Folgende Schritte:# 1. Anthropic API Key eingeben# 2. Workspace-Verzeichnis w��hlen# 3. Messaging-Kanal konfigurieren (Matrix){{/code}}== Konfiguration ===== Config-Datei ===**Pfad:** {{code}}/root/.clawdbot/clawdbot.json{{/code}}=== Matrix-Kanal ==={{code language="json"}}{ "channels": { "matrix": { "enabled": true, "homeserver": "https://matrix.rs-servertech.com", "userId": "@jarvis:matrix.rs-servertech.com", "password": "***", "dm": { "policy": "allowlist", "allowFrom": ["@rene:matrix.rs-servertech.com"] }, "groupPolicy": "allowlist", "encryption": true } }}{{/code}}=== Audio/Whisper f��r Sprachnachrichten ==={{code language="json"}}{ "tools": { "media": { "audio": { "enabled": true, "maxBytes": 20971520, "models": [ { "capabilities": ["audio"], "type": "cli", "command": "whisper", "args": ["{{MediaPath}}", "--model", "small", "--language", "de", "--output_format", "txt"], "timeoutSeconds": 120 } ] } } }}{{/code}}**Whisper Installation:**{{code language="bash"}}pip install openai-whisper# oderpip install git+https://github.com/openai/whisper.git{{/code}}== Gateway Service ===== Starten ==={{code language="bash"}}# Vordergrundclawdbot gateway start# Als systemd Service (empfohlen)clawdbot gateway installsystemctl enable clawdbot-gatewaysystemctl start clawdbot-gateway{{/code}}=== Status pr��fen ==={{code language="bash"}}clawdbot statusclawdbot gateway status{{/code}}=== Logs ==={{code language="bash"}}journalctl -u clawdbot-gateway -f{{/code}}== Workspace-Struktur =={{code language="none"}}/root/clawd/��������� AGENTS.md # Verhaltensregeln f��r den Agenten��������� SOUL.md # Pers��nlichkeit/Charakter��������� USER.md # Infos ��ber den Benutzer��������� IDENTITY.md # Name und Identit��t��������� TOOLS.md # Lokale Tool-Notizen (IPs, Credentials)��������� MEMORY.md # Langzeit-Erinnerungen��������� HEARTBEAT.md # Periodische Check-Aufgaben��������� memory/ # T��gliche Logs ��������� 2026-01-29.md ��������� 2026-01-30.md ��������� ...{{/code}}== F��higkeiten ===== Integrationen ===|=Integration|=Status|=Beschreibung|Matrix|��� Aktiv|Hauptkommunikationskanal|Home Assistant|��� Konfiguriert|Smart Home Steuerung|Grafana|��� Konfiguriert|Monitoring-Abfragen|XWiki|��� Konfiguriert|Dokumentation erstellen|Zammad|��� Konfiguriert|Ticket-System=== Skills ===* **weather** ��� Wetterabfragen* **github** ��� GitHub CLI Integration* **notion** ��� Notion API* **slack** ��� Slack Steuerung* **coding-agent** ��� Code-Assistenz=== Cron-Jobs ===Periodische Aufgaben werden ��ber Cron-Jobs gesteuert:{{code language="bash"}}# Jobs auflistenclawdbot cron list# Job hinzuf��genclawdbot cron add --schedule "*/15 * * * *" --text "Check website status"{{/code}}== Befehle ===== Chat-Befehle ===|=Befehl|=Beschreibung|/status|Zeigt Session-Status|/reasoning [on/off]|Extended Thinking aktivieren|/model [name]|Modell wechseln|/clear|Session zur��cksetzen|/help|Hilfe anzeigen=== CLI-Befehle ==={{code language="bash"}}# Chat startenclawdbot chat# Statusclawdbot status# Gateway steuernclawdbot gateway start|stop|restart|status# Configclawdbot config getclawdbot config set key value# Cronclawdbot cron list|add|remove{{/code}}== Matrix Voice Messages Fix ==**Problem:** Voice Messages wurden nicht transkribiert.**Ursache:** Falscher Media-Download-Endpoint bei verschl��sselten R��umen.**L��sung:**{{code language="bash"}}# FALSCH (gibt M_NOT_FOUND):curl "https://matrix.server/_matrix/media/v3/download/{serverName}/{mediaId}"# RICHTIG (mit Auth):curl "https://matrix.server/_matrix/client/v1/media/download/{serverName}/{mediaId}" \ -H "Authorization: Bearer {accessToken}"{{/code}}== Troubleshooting ===== Gateway startet nicht ==={{code language="bash"}}# Logs pr��fenjournalctl -u clawdbot-gateway -n 50# Config validierenclawdbot config validate# Port belegt?lsof -i :18789{{/code}}=== Keine Antworten in Matrix ===1. Gateway l��uft? {{code}}clawdbot gateway status{{/code}}2. Matrix-Verbindung? Logs auf "matrix" Eintr��ge pr��fen3. User in allowlist?=== Whisper funktioniert nicht ==={{code language="bash"}}# Whisper installiert?which whisper# Testwhisper /tmp/test.ogg --language de --model base# ffmpeg vorhanden?ffmpeg -version{{/code}}== Updates =={{code language="bash"}}# Clawdbot aktualisierennpm update -g clawdbot# Gateway neu startenclawdbot gateway restart{{/code}}== Dokumentation ==* **Offizielle Docs:** https://docs.clawd.bot* **GitHub:** https://github.com/clawdbot/clawdbot* **Discord:** https://discord.com/invite/clawd----//Dokumentiert von JARVIS am 2026-02-02//