Photo-Webcam Snapshots

Goal: Fetch a current image from a saved favorites list (number -> webcam page) and send it to the user.

Data source (favorites)

Default file in the workspace:
- docs/webcams/favorites-muenchen.json

Format:
- items[].id (int)
- items[].name (string)
- items[].page (URL of the webcam page)
- optional items[].image (direct image URL)

Typical user commands

• webcam 1
• webcam 3+4+5
• liste
• liste webcams
• fuege <name> <url> hinzu

Workflow: webcam N -> send image

1) Load favorites list from docs/webcams/favorites-muenchen.json.
2) Find entry with id equal to N.
3) Fetch snapshot:
- If image is set: load that URL directly
- Otherwise: derive current 1200 jpg from page URL
4) Save image to /tmp/webcamN.jpg
5) Send image via openclaw CLI:
openclaw message send --channel telegram --target <CHAT_ID> --message “Webcam N Name” --media /tmp/webcamN.jpg

Workflow: webcam 3+4+5 -> multiple images

Maximum 6 images per request; ask first if more are requested.

Run a separate openclaw call for each ID — never bundle multiple images into a single command or response.

Example for “webcam 1+3”:

python3 ... --id 1 --out /tmp/webcam1.jpg
-> read name from script output
openclaw message send --channel telegram --target <CHAT_ID> --message “Webcam 1 <name>” --media /tmp/webcam1.jpg

python3 ... --id 3 --out /tmp/webcam3.jpg
-> read name from script output
openclaw message send --channel telegram --target <CHAT_ID> --message “Webcam 3 <name>” --media /tmp/webcam3.jpg

Each openclaw command runs separately. The caption for each image comes exclusively from the script output (field “name”) of the respective call.

Workflow: liste -> send favorites list

Send a plain text list:
Webcam 1 Name
Webcam 2 Name
etc.

No formatting, plain text only.

Resolving the image URL (foto-webcam.eu)

For a webcam page like:
- https://www.foto-webcam.eu/webcam/zugspitze/

there is usually a direct “current” image at:
- https://www.foto-webcam.eu/webcam/zugspitze/current/1200.jpg

In practice: fetch the HTML with a browser User-Agent and search for a link matching .../current/<digits>.jpg.

Script

Use the script:
- skills/public/foto-webcam/scripts/foto_webcam_snapshot.py

Examples:

• Snapshot via favorites ID:

• python3 skills/public/foto-webcam/scripts/foto_webcam_snapshot.py --favorites docs/webcams/favorites-muenchen.json --id 4 --out /tmp/webcam4.jpg

• Snapshot via URL:

• python3 skills/public/foto-webcam/scripts/foto_webcam_snapshot.py --url https://www.foto-webcam.eu/webcam/zugspitze/ --out /tmp/zugspitze.jpg

Maintenance / adding webcams

• Add a new webcam: append to favorites-muenchen.json (new id, name, page).
• If a source is unreliable, set image to a direct JPG link.

Important: chat responses must be plain text only (no Markdown). For audio, use clean speech only (no special characters or formatting).

> Eine deutsche Version dieser Skill-Beschreibung ist weiter unten zu finden.

Foto-Webcam Schnappschüsse (Deutsch)

Ziel: Ein aktuelles Bild aus einer gespeicherten Favoritenliste (Nummer → Webcam-Seite) abrufen und an den Benutzer senden.

Datenquelle (Favoriten)

Standarddatei im Workspace:
- docs/webcams/favorites-muenchen.json

Format:
- items[].id (int)
- items[].name (string)
- items[].page (URL der Webcam-Seite)
- optional items[].image (direkte Bild-URL)

Typische Benutzerbefehle

• webcam 1
• webcam 3+4+5
• liste
• liste webcams
• fuege <name> <url> hinzu

Ablauf: webcam N -> Bild senden

1) Favoritenliste aus docs/webcams/favorites-muenchen.json laden.
2) Eintrag mit der entsprechenden ID finden.
3) Schnappschuss abrufen:
- Falls image gesetzt ist: diese URL direkt laden
- Andernfalls: aktuelles 1200-JPG aus der Seiten-URL ableiten
4) Bild unter /tmp/webcamN.jpg speichern
5) Bild per openclaw CLI senden:
openclaw message send --channel telegram --target <CHAT_ID> --message "Webcam N Name" --media /tmp/webcamN.jpg

Ablauf: webcam 3+4+5 -> mehrere Bilder

Maximal 6 Bilder pro Anfrage; bei mehr zuerst nachfragen.

Für jede ID einen separaten openclaw-Aufruf ausführen — niemals mehrere Bilder in einem einzigen Befehl oder einer Antwort bündeln.

Beispiel für „webcam 1+3":

python3 ... --id 1 --out /tmp/webcam1.jpg
-> Name aus Script-Ausgabe lesen
openclaw message send --channel telegram --target <CHAT_ID> --message "Webcam 1 <name>" --media /tmp/webcam1.jpg

python3 ... --id 3 --out /tmp/webcam3.jpg
-> Name aus Script-Ausgabe lesen
openclaw message send --channel telegram --target <CHAT_ID> --message "Webcam 3 <name>" --media /tmp/webcam3.jpg

Jeder openclaw-Befehl läuft separat. Die Bildunterschrift kommt ausschließlich aus der Script-Ausgabe (Feld „name") des jeweiligen Aufrufs.

Ablauf: liste -> Favoritenliste senden

Einfache Textliste senden:
Webcam 1 Name
Webcam 2 Name
usw.

Keine Formatierung, nur reiner Text.

Bild-URL auflösen (foto-webcam.eu)

Für eine Webcam-Seite wie:
- https://www.foto-webcam.eu/webcam/zugspitze/

gibt es normalerweise ein aktuelles Bild unter:
- https://www.foto-webcam.eu/webcam/zugspitze/current/1200.jpg

In der Praxis: HTML mit Browser-User-Agent abrufen und nach einem Link suchen, der auf .../current/<Ziffern>.jpg passt.

Script

Das Script verwenden:
- skills/public/foto-webcam/scripts/foto_webcam_snapshot.py

Beispiele:

• Schnappschuss per Favoriten-ID:

• python3 skills/public/foto-webcam/scripts/foto_webcam_snapshot.py --favorites docs/webcams/favorites-muenchen.json --id 4 --out /tmp/webcam4.jpg

• Schnappschuss per URL:

• python3 skills/public/foto-webcam/scripts/foto_webcam_snapshot.py --url https://www.foto-webcam.eu/webcam/zugspitze/ --out /tmp/zugspitze.jpg

Pflege / Webcams hinzufügen

• Neue Webcam hinzufügen: Eintrag in favorites-muenchen.json ergänzen (neue id, name, page).
• Bei unzuverlässiger Quelle: image auf eine direkte JPG-URL setzen.

Wichtig: Chat-Antworten nur als reiner Text (kein Markdown). Für Sprachausgabe: sauberer Text ohne Sonderzeichen oder Formatierung.