OpenClaw · Skill
Synology Surveillance Skill
Steuere deine Überwachungskameras über die Synology Surveillance Station API.
Install
Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.
Primary command
clawhub install photonixlaser-ux/synology-surveillance-skillClawHub installer
npx clawhub@latest install photonixlaser-ux/synology-surveillance-skillOpenClaw CLI
openclaw skills install photonixlaser-ux/synology-surveillance-skillDirect OpenClaw install
openclaw install photonixlaser-ux/synology-surveillance-skillWhat this skill does
Steuere deine Überwachungskameras über die Synology Surveillance Station API.
Why it matters
Replaces the need to log into the Surveillance Station web UI or mobile app for routine operations, enabling scripted automation and agent-driven control.
Typical use cases
- Taking a snapshot of the front door camera when motion is detected
- Starting a manual recording on the garage camera
- Moving a PTZ camera to check a specific area
- Pulling the last 50 camera events for a security review
- Generating a live-stream URL for a monitoring dashboard
Source instructions
Synology Surveillance Station Skill
Steuere deine Überwachungskameras über die Synology Surveillance Station API.
Voraussetzungen
- Synology NAS mit installierter Surveillance Station
- Benutzer mit Surveillance Station-Rechten
- 2FA deaktiviert für den API-Benutzer
- jq installiert (
apt install jq)
Schnellstart
1. Konfiguration in TOOLS.md
Füge die Verbindungsdaten zu TOOLS.md hinzu:
### Synology Surveillance
- **Host:** 192.168.1.100 (deine NAS IP)
- **Port:** 5000 (HTTP) oder 5001 (HTTPS)
- **User:** surveillance_user
- **Pass:** dein_passwort
- **HTTPS:** false (true falls HTTPS aktiviert)
2. Login testen
./scripts/syno-surveillance.sh login
3. Kameras anzeigen
./scripts/syno-surveillance.sh cameras
Output:
ID: 1, Name: Eingang, Status: 1
ID: 2, Name: Garten, Status: 1
ID: 3, Name: Garage, Status: 0
4. Snapshot erstellen
./scripts/syno-surveillance.sh snapshot 1
Speichert: syno_snapshot_1_1738972800.jpg
5. Ereignisse anzeigen
# Letzte 10 Ereignisse
./scripts/syno-surveillance.sh events
# Letzte 50 Ereignisse
./scripts/syno-surveillance.sh events 50
Verfügbare Befehle
| Befehl | Beschreibung |
|---|---|
login | Session erstellen (wird automatisch bei anderen Befehlen ausgeführt) |
logout | Session beenden |
cameras | Alle Kameras mit ID und Status auflisten |
snapshot <id> | Snapshot einer Kamera erstellen |
record <id> start|stop | Aufnahme starten/stoppen |
events [limit] | Ereignis-Log anzeigen |
stream <id> | Live-Stream URL generieren |
ptz <id> <direction> | PTZ-Kamera bewegen (left/right/up/down/zoomin/zoomout) |
preset <id> <num> | PTZ-Voreinstellung anfahren |
Umgebungsvariablen
| Variable | Standard | Beschreibung |
|---|---|---|
SYNOLOGY_HOST | 192.168.1.100 | NAS IP/Hostname |
SYNOLOGY_PORT | 5000 | NAS Port |
SYNOLOGY_USER | admin | Username |
SYNOLOGY_PASS | (leer) | Passwort |
SYNOLOGY_HTTPS | false | HTTPS verwenden |
Direkte API-Calls
Falls das Script nicht passt, direkt mit curl:
# Login
curl -c cookies.txt "http://192.168.1.100:5000/webapi/auth.cgi?api=SYNO.API.Auth&method=login&version=3&account=USER&passwd=PASS&session=SurveillanceStation&format=cookie"
# Snapshot
curl -b cookies.txt "http://192.168.1.100:5000/webapi/entry.cgi?api=SYNO.SurveillanceStation.Camera&method=GetSnapshot&version=1&cameraId=1" -o snapshot.jpg
API Details
Für komplexere Operationen: references/api.md
Home Assistant Integration
Für Home Assistant Nutzer: Der Skill kann auch für HA Automatisierungen genutzt werden:
shell_command:
syno_snapshot: "/pfad/zu/syno-surveillance.sh snapshot {{ camera_id }}"
Troubleshooting
- Login failed: Passwort prüfen, 2FA deaktivieren
- Permission denied: Benutzer braucht Surveillance Station-Rechte
- Camera not found: Kamera-ID prüfen mit
camerasBefehl - Empty snapshot: Kamera offline oder keine Lizenz verfügbar
Lizenz-Hinweis
Surveillance Station benötigt pro Kamera eine Lizenz (2 kostenlose inklusive bei den meisten NAS-Modellen).