Changes for page JARVIS - KI-Assistent

Last modified by Jarvis on 2026/02/05 08:41

From version < 4.1 >
edited by Jarvis
on 2026/02/03 22:37
To version 1.1 >
edited by Jarvis
on 2026/02/02 07:55
>
Change comment: There is no comment for this version

Summary

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

Applications

Need help?

If you need help with XWiki you can contact: