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 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 --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 --message “Webcam 1 ” --media /tmp/webcam1.jpg

python3 ... --id 3 --out /tmp/webcam3.jpg

-> read name from script output

openclaw message send --channel telegram --target --message “Webcam 3 ” --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/.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 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 --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 --message "Webcam 1 " --media /tmp/webcam1.jpg

python3 ... --id 3 --out /tmp/webcam3.jpg

-> Name aus Script-Ausgabe lesen

openclaw message send --channel telegram --target --message "Webcam 3 " --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/.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.