Deskbird-Automator

Verwende diesen Skill, um Deskbird ueber das lokale CLI (scripts/deskbird_tool.py) sicher zu bedienen und optional als wiederkehrende Cron-Session laufen zu lassen.

Voraussetzungen

• - Arbeite im Projektordner <repo-root>.
• Nutze bevorzugt diese CLI-Kommandos:

• - Halte den Schonmodus aktiv (DESKBIRD_SAFE_MODE=true) und sende keine Request-Stuerme.
• Fuer Telegram-Reauth standardmaessig nur DevTools-Paste + auth-import verwenden.
• INLINECODE15 und auth-capture nicht als Standard im Chat vorschlagen.

Deterministischer Env-Pfad

• - Verwende fuer alle Skill-Aufrufe den Wrapper ./scripts/deskbird.sh.
• Der Wrapper setzt automatisch --env-file <skill-root>/.env und verhindert damit CWD-bedingte Auth-Fehler.
• Nur bei gezieltem Debugging darfst du --env-file explizit auf eine andere Datei setzen.

Empfohlene Dauer-Auth (Broker-Basis)

• - Hinterlege nach einmaliger Ermittlung in der Skill-.env:

• - Dann kann der Agent automatisch per auth-refresh einen neuen Bearer holen, ohne jeden Login-Flow.

Pflichtdialog Vor Automatisierung

Wenn noch keine passende Cron-Session existiert, frage den Nutzer in genau dieser Reihenfolge:

1. 1. INLINECODE24
2. Wenn ja: INLINECODE25
3. INLINECODE26

1. 4. Fasse Name, Rhythmus und Session-Aufgabe zusammen und hole eine letzte Bestaetigung ein.

Wenn der Nutzer keinen Rhythmus nennt, setze den Default: taeglich 00:30 (Europe/Berlin).

Reauth-Protokoll (immer vor Deskbird-Calls)

Fuehre vor Discovery/Status/Buchung immer zuerst aus:

CODEBLOCK0

Auswertung:

• - Wenn requires_reauth=false: normal fortfahren.
• Wenn requires_reauth=true:

• - Manueller Reauth-Standard ist Token/Header-Paste aus Chrome DevTools.

Office-Discovery Pflicht

• - Vor jeder Detailabfrage (parking-status, parking-check, parking-book-first) zuerst discovery ausfuehren.
• INLINECODE39 ist optional: Das CLI loest das Office automatisch ueber internalWorkspaces auf.
• Nur wenn mehrere Offices vorhanden und der Default unklar ist:

• - Der Agent soll den Nutzer nicht standardmaessig nach einer Office-ID fragen.

Reauth Via DevTools Paste

Wenn Reauth noetig ist, leite den Nutzer kurz an:

1. 1. app.deskbird.com im Browser oeffnen und normal per SSO einloggen.
2. DevTools (Network) oeffnen.
3. Einen api.deskbird.com Request anklicken.
4. Request-Header (Authorization, optional Cookie, X-CSRF-Token, X-XSRF-Token) kopieren.
5. Header-Block in Telegram an den Bot senden.

Importiere den vom Nutzer gepasteten Block dann intern so:

CODEBLOCK1

Danach immer nochmals pruefen:

CODEBLOCK2

Fallback:

• - Nur wenn DevTools-Paste unmoeglich ist, manuelles auth-capture anbieten.

Wenn Auth danach weiterhin ungueltig ist:

• - Keine Buchungen ausfuehren.
• Klar melden, dass ohne erfolgreiche Reauth abgebrochen wird.

Verhalten In Cron-Laeufen

Cron-Laeufe muessen fehlertolerant und vorsichtig sein:

• - Nie aggressive Retries oder enge Polling-Schleifen starten.
• Wenn Auth im Cron-Lauf nicht mehr gueltig ist, nicht blind weiterprobieren.
• Stattdessen eine Telegram-Nachricht senden mit klarer Handlungsaufforderung zur Reauth und den Lauf sauber beenden.

Cron-Session Erstellen/Aktualisieren

Nutze OpenClaw-Cron-Funktionen. Wenn Tooling verfuegbar ist, bevorzuge cron.add/cron.update; alternativ CLI:

CODEBLOCK3

Regeln:

• - Verwende lokale Zeit (Europe/Berlin) fuer den Standard.
• Lege pro Aufgabe genau eine Cron-Session an (keine Duplikate).
• Aktualisiere bestehende Sessions statt neue Kopien anzulegen.

Session-Prompt Bauen

Beim Erstellen des Cron-Prompts nutze die Vorlage aus references/cron-session-template.md und ersetze Platzhalter fuer Zone/Regeln.

Ausgabeformat Gegenueber Dem Nutzer

Bei jedem Lauf (manuell oder Cron) liefere kompakt:

1. 1. Auth-Status (ok oder reauth_noetig)
2. Was geprueft wurde (Datum/Zonen/Objekttypen)
3. Wichtige Treffer (frei/belegt/gesperrt, wer belegt)
4. Ob eine Buchung durchgefuehrt wurde oder warum nicht