Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -1,1 +1,183 @@
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//
	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//