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 ===# Global installierennpm install -g clawdbot# Version pr��fenclawdbot --version
=== Onboarding ===# Interaktives Setupclawdbot onboard# Folgende Schritte:# 1. Anthropic API Key eingeben# 2. Workspace-Verzeichnis w��hlen# 3. Messaging-Kanal konfigurieren (Matrix)
== Konfiguration ===== Config-Datei ===Pfad: /root/.clawdbot/clawdbot.json=== Matrix-Kanal ==={ "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 } }}=== Audio/Whisper f��r Sprachnachrichten ==={ "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 } ] } } }}Whisper Installation:pip install openai-whisper# oderpip install git+https://github.com/openai/whisper.git== Gateway Service ===== Starten ===# Vordergrundclawdbot gateway start# Als systemd Service (empfohlen)clawdbot gateway installsystemctl enable clawdbot-gatewaysystemctl start clawdbot-gateway
=== Status pr��fen ===clawdbot statusclawdbot gateway status=== Logs ===journalctl -u clawdbot-gateway -f== Workspace-Struktur ==/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 ��������� ...== 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:# Jobs auflistenclawdbot cron list# Job hinzuf��genclawdbot cron add --schedule "*/15 * * * *" --text "Check website status"
== 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 ===# Chat startenclawdbot chat# Statusclawdbot status# Gateway steuernclawdbot gateway start|stop|restart|status# Configclawdbot config getclawdbot config set key value# Cronclawdbot cron list|add|remove
== Matrix Voice Messages Fix ==Problem: Voice Messages wurden nicht transkribiert.Ursache: Falscher Media-Download-Endpoint bei verschl��sselten R��umen.L��sung:# 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}"
== Troubleshooting ===== Gateway startet nicht ===# Logs pr��fenjournalctl -u clawdbot-gateway -n 50# Config validierenclawdbot config validate# Port belegt?lsof -i :18789
=== Keine Antworten in Matrix ===1. Gateway l��uft? clawdbot gateway status2. Matrix-Verbindung? Logs auf "matrix" Eintr��ge pr��fen3. User in allowlist?=== Whisper funktioniert nicht ===# Whisper installiert?which whisper# Testwhisper /tmp/test.ogg --language de --model base# ffmpeg vorhanden?ffmpeg -version
== Updates ==# Clawdbot aktualisierennpm update -g clawdbot# Gateway neu startenclawdbot gateway restart
== 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