Wiki source code of JARVIS - Clawdbot KI-Assistent
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
4.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// |