Skip to Content
ProdukteTicketpilot LokalInstallations-Guide

Ticketpilot aus Cuby in 5 Minuten

Schritt-für-Schritt-Anleitung für die erste Installation: vorbereitet, abhakbar, mit allen Feldern, Pfaden und typischen Fehlern.

Vor dem Start. Die Installation selbst dauert ca. 5 Minuten, wenn die Vorbereitung erledigt ist. Besorge vorher: Odoo-Kundendienst-Account, Odoo API-Key, Odoo Base URL, Odoo User-ID, Anthropic/Claude-Code-Account und ein lokales Git-Repository. Einstieg: ticket-pilot.de  herunterladen, ProcessCube Studio starten und Ticketpilot in Cuby auswählen.

Unterstützte Systeme

Ticket-Systeme

  • Heute: Odoo, Jira
  • Bald: Freshdesk, Twilio, weitere Systeme

KI-Implementierungen

  • Heute: Claude Code (Anthropic Account erforderlich)
  • Bald: weitere KI-Modelle

Referenzen: docs.processcube.io , ticket-pilot.de  und das Installationsvideo .

00 — Vorbereitung erledigen

  • ProcessCube Zugang bereithalten — Lizenz oder Trial aktivieren; im Studio ist der Marketplace sichtbar.
  • Cuby-Testaccount einplanen — bei der ersten Installation kannst du im Studio direkt einen Testaccount bekommen und loslegen.
  • ProcessCube Studio laden — über ticket-pilot.de  starten; Ticketpilot ist die Softwarelösung, die du anschließend im Cuby-Marketplace auswählst.
  • Odoo Kundendienst vorbereiten — Odoo-Account anlegen, Kundendienst-App installieren und ein Helpdesk/Projekt bereithalten.
  • Anthropic Account erstellen — Claude Code nutzt deinen Claude/Anthropic Login.
  • Git-Repository lokal klonen — das Repo, in dem Claude Code später Coding-Tasks ausführt.

Zeitplanung. Vorbereitung ist der eigentliche Zeitfresser. Wenn Accounts, Keys und Repo bereitliegen, ist die Installation im Studio ein kurzer geführter Lauf.

01 — API-Werte sammeln

  • ProcessCube API-Key — aus Rechnung oder Accountbereich; alternativ beim Testaccount in Cuby starten.
  • Odoo Base URL — Browser-URL deiner Odoo-Instanz, ohne angehängtes /odoo.
  • Odoo API-Key — Profilbild → Meine Präferenzen → Account-Sicherheit → neuen API-Key generieren; permanent speichern.
  • Odoo User-ID — Benutzer öffnen; die letzte Zahl in der URL ist die User-ID.

02 — Cuby-Startbildschirm

  • ProcessCube Studio öffnen — beim ersten Start landest du in Cuby bei Meine Apps.
  • Ticketpilot auswählen — im Startbildschirm steht die lokale Installation bereit.
  • Lokale Installation starten — das ist der Standardweg für die erste Einrichtung.

Ticketpilot <lokal> — Läuft auf deiner eigenen Hardware oder deinem eigenen Server. Du behältst volle Datensouveränität, brauchst aber ein:e:n DevOps-Zuständige:n für Updates.

Enthalten:

  • Alle Konnektoren (Odoo, Jira, GitHub)
  • BPMN-Prozesse & Templates
  • Geführte Installation via Cuby
  • E-Mail-Support (24h Reaktionszeit)

Betrieb & Verantwortung: Betrieb, Updates (1-Klick via Cuby), Backups bei dir; SLA: best effort. Passt zu regulierten Branchen, strenger IT-Policy, vorhandener Server-Infra.

Varianten kurz erklärt. Die lokale Installation läuft auf dem eigenen Rechner oder der eigenen Infrastruktur und wird direkt in Cuby geführt eingerichtet. Kubernetes ist nur relevant, wenn dein Team bereits eine K8s-Plattform betreibt.

03 — Ticketpilot aus Cuby installieren (ca. 5 Min aktiv)

  • „Kostenlos starten” klicken — Cuby öffnet die geführte Installation für die gewählte Ticketpilot-Variante.
  • Testaccount nutzen — beim ersten Setup kannst du direkt in Cuby starten und später Produktivdaten ergänzen.
  • Installation abwarten — Cuby richtet die benötigten ProcessCube-Komponenten und den Ticketpilot ein.

Gut zu wissen. Bei lokalen Setups nennt die Dokumentation Default-Ports 56000, 56020 und 56030. Bei Konflikten weicht Cuby aus. Beim ersten Start wird Internet für Pakete benötigt; ca. 500 MB lokaler Platz sind sinnvoll.

04 — Ticketpilot konfigurieren

  • Ticketpilot im Marketplace bestätigen — Cuby öffnet den Ticketpilot-Wizard automatisch.
  • Lokale ProcessCube-Instanz auswählen — normalerweise ist die gerade installierte Instanz vorausgewählt.
  • Namen vergeben — aussagekräftig, z. B. ticketpilot-local oder kundenservice-demo.

05 — Odoo im Wizard verbinden

  • Git-Repository bestätigen — lokaler Pfad zum geklonten Repo ist vorhanden.
  • Odoo Base URL eintragen — ohne /odoo am Ende.
  • Odoo API-Key einfügen — permanenten Key verwenden und wie ein Passwort behandeln.
  • Odoo User-ID eintragen — letzte Zahl aus der Benutzer-URL.
  • Validierung abwarten — der Wizard prüft, ob Odoo erreichbar ist und die Daten stimmen.

Stage-Mapping. Ordne die Odoo-Helpdesk-Phasen dem Ticketpilot-Workflow zu. Wenn die Phasen fehlen, kann der Wizard sie neu erstellen. Für Jira ist der Ablauf analog, nur heißen die Felder Workspace URL, Account-E-Mail, API-Token, Projekt und Status-Mapping.

06 — Claude Code aktivieren

  • Terminal öffnen — Berechtigung erlauben, falls macOS oder Windows nachfragt.
  • Claude Code starten — Login-Befehl ausführen; der Browser öffnet sich automatisch.
  • Im Browser autorisieren — danach ist Claude Code für Ticketpilot verfügbar.

Coding-Agent-Runtime einrichten

Damit BPMN-Flows den Coding-Agent (Claude Code) ansteuern können, richtest du einmalig die lokale ProcessCube-Agents-Runtime (openclaw) ein und verbindest LowCode über Device-Pairing mit ihrem Gateway.

ProcessCube-Runtime einrichten

Richtet die lokale ProcessCube-Agents-Runtime (openclaw) auf deinem Host ein. Das ist die Brücke, über die BPMN-Flows den Coding-Agent (Claude Code) ansteuern.

pc-runtime setup

Folge den Prompts. Danach läuft die Runtime lokal und lauscht auf ihrem Gateway-Port.

An der CLI anmelden

Meldet die pc-CLI an der laufenden Runtime an. Die Adresse host.docker.internal sorgt dafür, dass der Login auch aus Container-Sicht funktioniert (die Container erreichen den Host darüber).

pc login http://host.docker.internal:56100

Erfolgreicher Login wird im Terminal bestätigt. Erst danach kann der Agent Tickets entgegennehmen.

GitHub-Authentifizierung

Der Coding-Agent braucht Schreibzugriff auf dein Repository (Branches, Commits, PRs). Melde die GitHub-CLI an:

gh auth login

Wähle GitHub.com → SSH → im Browser authentifizieren.

Device-Pairing im LowCode durchführen

Der openclaw-message-send-Node im LowCode nutzt Device-Pairing (useDevicePairing: true), damit LowCode sich beim Agent-Gateway autorisiert. Das muss einmalig manuell in der LowCode-UI bestätigt werden:

  1. LowCode im Detail-Dialog öffnen.
  2. Einen Flow mit einem openclaw-message-send-Node öffnen (z. B. ticket_umsetzen_odoo bzw. ticket_umsetzen_jira).
  3. Den Node doppelklicken → beim Gateway-Config processcube-agents den Button „Verbindung testen / Pairing prüfen” klicken.
  4. Den angezeigten Pairing-Code kopieren. Er wird im Terminal von processcube-agents eingefügt.
  5. „Aktualisieren” → „Fertig” → „Übernahme (deploy)” klicken.
  6. Die gepairte Konfiguration wird aktiviert.

Nach erfolgreichem Pairing bleibt die Autorisierung bestehen; der Schritt muss nicht bei jedem Start wiederholt werden.

Authority-Login. Zum Einloggen in die Authority (Studio/LowCode) wird der lokale Standardzugang admin / admin verlangt.

Nach der Installation — Engine in Studio öffnen

Nach der Installation wechselst du in ProcessCube Studio links auf ProcessCubes, öffnest deine Ticketpilot-Installation und meldest dich in der Engine an.

  1. ProcessCubes öffnen — Links auf ProcessCubes wechseln. In Cuby siehst du die installierten Ticketpilot-Bausteine, hier z. B. ticketpilot-lokal-v2.
  2. Engine wählen — In ticketpilot-lokal-v2 die Engine öffnen und auf Process Models gehen. Process Instances liegt direkt darunter.
  3. Anmelden — Oben rechts Not logged in öffnen, Sign in … wählen und den lokalen Standardzugang admin / admin verwenden.

Modelle und Instanzen

Nach dem Login zeigt Studio die Ticketpilot-Prozessmodelle. Das ist der Kontrollpunkt, bevor du das erste Test-Ticket in Odoo anlegst. Sichtbare Modelle (Beispiel):

  • Support_Ticket_verarbeiten
  • Support_Ticket_verteilen
  • Ticket_umsetzen

Für laufende Tickets wechselst du auf Process Instances.

07 — Vor dem Testlauf prüfen

  • Process Models geöffnet — drei Ticket-Support-Prozesse sollten sichtbar sein.
  • Process Instances erreichbar — dort beobachtest du später laufende Ticketpilot-Läufe.
  • Auto Refresh nutzen — bei längeren Läufen aktivieren oder manuell aktualisieren.

08 — Erstes Test-Ticket

  • Odoo Test-Ticket erstellen — Kundendienst → neues Ticket, z. B. einfacher Feature-Wunsch.
  • Ticket auf New verschieben — damit startet der automatische Lauf.
  • Process Instances öffnen — dort siehst du, ob Ticketpilot den Lauf gestartet hat.
  • Auto Refresh aktivieren — alternativ manuell aktualisieren, bis die Instanz erscheint.

09 — Workflow beobachten & Abschluss

  • Kategorisierung prüfen — Ticketpilot klassifiziert und taggt das Ticket.
  • Status in Odoo prüfen — Ticket wandert z. B. zu Feature requested.
  • Manuell approve setzen — Human-in-the-loop bleibt bewusst erhalten.
  • Coding Task nachvollziehen — der Coding-Agent (Claude Code) setzt das Ticket über die processcube-agents-Runtime um; den Fortschritt im Runtime-Terminal bzw. unter Process Instances verfolgen.
  • Review durchführen — Entwickler prüft Ergebnis und setzt den Status weiter.
  • Auftraggeber-Freigabe einholen — Ticket in Review / Awaiting Approval prüfen und abschließen.

Setup abgeschlossen. Wenn das erste Ticket den Prozess vollständig durchläuft, ist Ticketpilot startklar. Ab jetzt orchestriert Ticketpilot den Weg vom Kunden-Ticket bis zur kontrollierten Entwicklerfreigabe.

Troubleshooting

ProblemLösung
Keine Apps sichtbarProcessCube API-Key/Testaccount prüfen und Marketplace neu öffnen.
Odoo validiert nichtBase URL ohne /odoo, API-Key permanent, User-ID korrekt?
Agent setzt Tickets nicht umLäuft die processcube-agents-Runtime und ist das Device-Pairing im LowCode bestätigt? (siehe Coding-Agent-Runtime einrichten)
Claude startet nichtTerminal-Login wiederholen und Browser-Autorisierung abschließen.
Keine Prozessinstanz sichtbarTicket wirklich auf New verschoben und Studio Refresh aktiviert?

Weiterführend

InstallationÜbersicht