# 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.