Harald Hoyer
bc6091f63f
- Added configuration for Nextcloud Claude Bot, including NixOS module, secrets management, and example setup files. - Introduced a Python-based HTTP server for handling webhook events and interacting with Nextcloud Talk. - Integrated necessary dependencies and systemd service for seamless operation.
146 lines
3.1 KiB
Markdown
146 lines
3.1 KiB
Markdown
# Nextcloud Claude Bot Setup
|
||
|
||
## Voraussetzungen
|
||
|
||
- NixOS Server mit Nextcloud (Talk App aktiviert)
|
||
- Claude Code CLI installiert und authentifiziert
|
||
- Nextcloud Talk Version 17+ (Nextcloud 26+)
|
||
|
||
## 1. Bot Secret generieren
|
||
|
||
```bash
|
||
openssl rand -hex 32 > /var/secrets/nextcloud-claude-bot
|
||
chmod 600 /var/secrets/nextcloud-claude-bot
|
||
```
|
||
|
||
## 2. NixOS Konfiguration
|
||
|
||
Kopiere die Dateien nach `/etc/nixos/nextcloud-claude-bot/` oder in dein Flake:
|
||
|
||
```
|
||
/etc/nixos/
|
||
├── configuration.nix
|
||
└── nextcloud-claude-bot/
|
||
├── module.nix
|
||
└── bot.py
|
||
```
|
||
|
||
Füge das Modul zu deiner `configuration.nix` hinzu (siehe `example-config.nix`).
|
||
|
||
## 3. System rebuilden
|
||
|
||
```bash
|
||
nixos-rebuild switch
|
||
```
|
||
|
||
## 4. Bot bei Nextcloud registrieren
|
||
|
||
```bash
|
||
# Als root oder mit sudo
|
||
cd /var/www/nextcloud # oder wo dein Nextcloud liegt
|
||
|
||
# Bot secret auslesen
|
||
BOT_SECRET=$(cat /var/secrets/nextcloud-claude-bot)
|
||
|
||
# Bot installieren
|
||
sudo -u nextcloud php occ talk:bot:install \
|
||
"Claude" \
|
||
"Claude AI Assistant" \
|
||
"http://127.0.0.1:8085/webhook" \
|
||
"$BOT_SECRET"
|
||
```
|
||
|
||
Falls der Bot extern erreichbar sein muss:
|
||
```bash
|
||
sudo -u nextcloud php occ talk:bot:install \
|
||
"Claude" \
|
||
"Claude AI Assistant" \
|
||
"https://cloud.example.com/_claude-bot/webhook" \
|
||
"$BOT_SECRET"
|
||
```
|
||
|
||
## 5. Bot aktivieren
|
||
|
||
Nach der Installation musst du den Bot für Konversationen aktivieren:
|
||
|
||
```bash
|
||
# Liste alle Bots
|
||
sudo -u nextcloud php occ talk:bot:list
|
||
|
||
# Bot für alle User verfügbar machen (optional)
|
||
sudo -u nextcloud php occ talk:bot:state <bot-id> 1
|
||
```
|
||
|
||
## 6. Testen
|
||
|
||
1. Öffne Nextcloud Talk
|
||
2. Starte einen neuen Chat mit dem Bot (suche nach "Claude")
|
||
3. Schreibe eine Nachricht
|
||
|
||
### Health Check
|
||
|
||
```bash
|
||
curl http://127.0.0.1:8085/health
|
||
```
|
||
|
||
### Logs prüfen
|
||
|
||
```bash
|
||
journalctl -u nextcloud-claude-bot -f
|
||
```
|
||
|
||
## Troubleshooting
|
||
|
||
### Bot antwortet nicht
|
||
|
||
1. Prüfe ob der Service läuft:
|
||
```bash
|
||
systemctl status nextcloud-claude-bot
|
||
```
|
||
|
||
2. Prüfe die Logs:
|
||
```bash
|
||
journalctl -u nextcloud-claude-bot -n 50
|
||
```
|
||
|
||
3. Teste den Webhook manuell:
|
||
```bash
|
||
curl -X POST http://127.0.0.1:8085/webhook \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"actor":{"type":"users","id":"harald"},"message":{"message":"test","id":1},"conversation":{"token":"abc123","type":1}}'
|
||
```
|
||
|
||
### Claude CLI Fehler
|
||
|
||
Stelle sicher, dass Claude CLI als der Service-User funktioniert:
|
||
|
||
```bash
|
||
# Teste als der User
|
||
sudo -u nextcloud-claude-bot claude --print "Hello"
|
||
```
|
||
|
||
Die Claude CLI Config liegt in `/var/lib/nextcloud-claude-bot/.config/claude/`.
|
||
|
||
### Signature Fehler
|
||
|
||
Prüfe ob das Bot Secret in Nextcloud und im Service übereinstimmt:
|
||
|
||
```bash
|
||
# Secret im Service
|
||
cat /var/secrets/nextcloud-claude-bot
|
||
|
||
# Secret in Nextcloud (verschlüsselt gespeichert)
|
||
sudo -u nextcloud php occ talk:bot:list
|
||
```
|
||
|
||
## Befehle im Chat
|
||
|
||
- `/help` oder `/hilfe` – Hilfe anzeigen
|
||
- `/clear` oder `/reset` – Konversation zurücksetzen
|
||
|
||
## Sicherheitshinweise
|
||
|
||
- Der Bot läuft nur auf localhost und ist nicht direkt erreichbar
|
||
- Nur in `allowedUsers` gelistete Nutzer können den Bot verwenden
|
||
- Webhook-Signaturen werden verifiziert
|
||
- DynamicUser isoliert den Service
|