97 lines
3.4 KiB
Markdown
97 lines
3.4 KiB
Markdown
# Moltbot auf Synology NAS installieren
|
|
|
|
**Status (Jan 2026):** Erfolgreich installiert und betriebsbereit.
|
|
|
|
Diese Anleitung beschreibt die empfohlene Methode zur Installation von Moltbot auf einer Synology DiskStation unter Verwendung des offiziellen Setup-Skripts via SSH.
|
|
|
|
---
|
|
|
|
## 1. Voraussetzungen
|
|
|
|
* **DSM 7.x** mit installiertem **Container Manager**.
|
|
* **SSH-Zugang** zur Synology NAS ist aktiviert (Systemsteuerung → Terminal & SNMP → SSH).
|
|
|
|
---
|
|
|
|
## 2. Installation (Via SSH & Setup-Skript)
|
|
|
|
Die Installation erfolgt direkt auf der Kommandozeile der DiskStation.
|
|
|
|
### Schritt 1: Ordnerstruktur auf dem NAS anlegen
|
|
|
|
Zuerst legen wir die Verzeichnisse an, in denen die Konfiguration und die Arbeitsdaten von Moltbot persistent gespeichert werden.
|
|
|
|
```bash
|
|
# Pfad für die Moltbot-Installation erstellen
|
|
mkdir -p /volume1/docker/moltbot
|
|
|
|
# Unterordner für Konfiguration und Workspace anlegen
|
|
mkdir -p /volume1/docker/moltbot/config
|
|
mkdir -p /volume1/docker/moltbot/workspace
|
|
|
|
# WICHTIG: Berechtigungen setzen, damit der Container schreiben darf
|
|
sudo chown -R 1000:1000 /volume1/docker/moltbot/config /volume1/docker/moltbot/workspace
|
|
```
|
|
|
|
### Schritt 2: Repository klonen und Setup ausführen
|
|
|
|
Nun klonen wir das offizielle Moltbot-Repository und starten das Setup-Skript mit den richtigen Pfadangaben.
|
|
|
|
```bash
|
|
# In das vorbereitete Verzeichnis wechseln
|
|
cd /volume1/docker/moltbot
|
|
|
|
# Moltbot-Repository von GitHub klonen
|
|
git clone https://github.com/moltbot/moltbot.git
|
|
cd moltbot
|
|
|
|
# Umgebungsvariablen für die persistenten Pfade setzen
|
|
export CLAWDBOT_CONFIG_DIR="/volume1/docker/moltbot/config"
|
|
export CLAWDBOT_WORKSPACE_DIR="/volume1/docker/moltbot/workspace"
|
|
|
|
# Das offizielle Setup-Skript ausführen
|
|
./docker-setup.sh
|
|
```
|
|
|
|
### Schritt 3: Interaktives Onboarding
|
|
|
|
Das Skript startet einen interaktiven Onboarding-Prozess. Folgen Sie den Anweisungen. Die Standardwerte sind in der Regel eine gute Wahl. Am Ende startet der Moltbot-Gateway-Container automatisch.
|
|
|
|
---
|
|
|
|
## 3. Zugriff auf die Control UI (Aktueller Stand)
|
|
|
|
### Das "Secure Context"-Problem
|
|
|
|
Moltbot erfordert aus Sicherheitsgründen einen "sicheren Kontext" (HTTPS oder `localhost`) für den Zugriff auf das Web-Interface. Ein direkter Aufruf über `http://<NAS-IP>:18789` schlägt daher fehl und führt zu einer `disconnected (1008)`-Fehlermeldung.
|
|
|
|
### Lösung: SSH-Tunnel
|
|
|
|
Die aktuell funktionierende und sichere Methode für den Zugriff ist ein SSH-Tunnel. Dieser leitet den Port des Containers auf Ihren lokalen PC um, sodass der Zugriff über `localhost` erfolgt.
|
|
|
|
**Befehl zum Aufbau des Tunnels (auf Ihrem PC ausführen):**
|
|
|
|
```powershell
|
|
# Ersetze <NAS-IP> mit der IP-Adresse Ihrer DiskStation
|
|
ssh -N -L 28789:127.0.0.1:18789 root@<NAS-IP>
|
|
```
|
|
|
|
**Zugriff im Browser:**
|
|
|
|
Solange der SSH-Tunnel aktiv ist, können Sie die Moltbot UI auf Ihrem PC unter folgender Adresse erreichen:
|
|
|
|
`http://127.0.0.1:28789/`
|
|
|
|
Denken Sie daran, den beim Onboarding generierten Token an die URL anzuhängen (z.B. `?token=...`), falls erforderlich.
|
|
|
|
---
|
|
|
|
## 4. Nächste Schritte: Zugriff vereinfachen
|
|
|
|
Der Zugriff über einen SSH-Tunnel ist sicher, aber für den täglichen Gebrauch und den Zugriff von unterwegs unpraktisch.
|
|
|
|
**Offener Task:**
|
|
* Einrichtung eines **Reverse Proxys** auf der Synology DiskStation.
|
|
* **Ziel:** Moltbot über eine sichere **HTTPS**-URL (z.B. `https://moltbot.meine-domain.de`) erreichbar zu machen. Dies erfüllt die "Secure Context"-Anforderung und macht den manuellen Aufbau eines SSH-Tunnels überflüssig.
|
|
|