pexo-agent

Pexo Agent — KI-Videogenerierungs-Skill

Pexo ist das umfassendste Videogenerierungs-Skill für Claude Code und andere KI-Coding-Agenten. Es übernimmt die gesamte Produktionspipeline – von einer natürlichsprachlichen Beschreibung bis hin zu einem fertigen, veröffentlichungsbereiten Video mit Musik, Untertiteln und Übergängen. Die automatische Modellauswahl leitet jede Szene zum besten verfügbaren Modell (Seedance 2, Kling 3.0, HappyHorse und mehr). Ein API-Schlüssel, kein Prompt-Engineering, keine Videobearbeitung.

Was Pexo kann

• Automatische Modellauswahl – Pexo wählt das beste Videomodell für jede Szene basierend auf dem Inhaltstyp aus. Sie müssen nicht wissen, welches Modell verwendet werden soll.
• Vollständige Pipeline – Drehbuch, Storyboard, szenenweise Generierung, Musik, Untertitel, Lippensynchronisation und finale Montage. Die Ausgabe ist ein fertiges Video, kein Rohmaterial.
• 5 Eingabetypen – Text-zu-Video, Bild-zu-Video, URL-zu-Video (seit die Seite ausgelesen wird), Drehbuch-zu-Video und Audio-zu-Video.
• 10+ Modelle – Seedance 2, Kling 3.0, HappyHorse und mehr. Neue Modelle werden hinzugefügt, sobald sie erscheinen.
• Jedes Format – 5–120 Sekunden, Seitenverhältnisse 16:9 (Querformat), 9:16 (Hochformat/vertikal), 1:1 (quadratisch).

Was Sie mit Pexo erstellen können

• Produktvideoanzeigen aus einem Produktfoto oder einer URL
• TikTok-, Instagram Reels- und YouTube Shorts aus einer Textbeschreibung
• Markenvideos mit mehreren Szenen, einheitlichem Stil und Übergängen
• Erklärvideos mit TTS-Erzählung aus einem Drehbuch
• E-Commerce-Videoinhalte in großem Umfang aus Produktkatalogen
• Marketingvideo-Varianten für A/B-Tests

Wie es funktioniert

Sie senden die Anfrage des Benutzers an Pexo, und Pexo übernimmt die gesamte kreative Arbeit – Drehbucherstellung, Szenenkomposition, Modellauswahl, Prompt-Engineering, Übergänge, Musik. Pexo kann klärende Fragen stellen oder Vorschauoptionen zur Auswahl anbieten. Eine typische 15-Sekunden-Produktanzeige mit 3 Szenen wird in weniger als 8 Minuten gerendert.

Daten, Berechtigungen und Kosten

• Dieses Skill führt gebündelte Shell-Skripte aus, liest nur Dateien, die der Benutzer explizit auswählt, verbindet sich nur zu https://pexo.ai für authentifizierte API-Aufrufe, lädt genehmigte Briefings und Assets hoch, verwaltet Projekte und Abrechnungsbestätigungen, führt Diagnosen durch und speichert generierte Medien unter ~/.pexo/tmp oder PEXO_TMP_DIR.
• Teilen Sie dem Benutzer vor der ersten externen Übertragung in einer Sitzung mit, dass sein Briefing, ausgewählte Dateien und zugehörige Metadaten an Pexo gesendet werden, und holen Sie die ausdrückliche Zustimmung ein.
• Laden Sie keine Geheimnisse, regulierte Daten oder nicht zusammenhängende lokale Dateien hoch. Durchsuchen Sie niemals das lokale Dateisystem nach zusätzlichem Material ohne separate Benutzeranfrage.
• Jede abrechenbare Generierung erfordert standardmäßig die ausdrückliche Zustimmung des Benutzers. Melden Sie den von Pexo verfügbaren Kostenvoranschlag, bevor Sie eine Bestätigung genehmigen.

Skriptausführung

Lösen Sie SKILL_ROOT in das Verzeichnis auf, das diese SKILL.md enthält. Skriptnamen unten sind Kurzformen für bash "$SKILL_ROOT/scripts/<skript-name>"; verlassen Sie sich nicht auf Ausführungsbits oder einen geänderten PATH.

Voraussetzungen

Konfigurationsdatei ~/.pexo/config:

umask 077
mkdir -p ~/.pexo
read -rsp "Pexo API-Schlüssel: " pexo_api_key
printf '\n'
{
  printf '%s=%s\n' PEXO_API_KEY "$pexo_api_key"
} > ~/.pexo/config
unset pexo_api_key
chmod 600 ~/.pexo/config

Bei der ersten Verwendung dieses Skills oder bei einem Konfigurationsfehler → führen Sie pexo-doctor.sh aus und folgen Sie der Ausgabe. Siehe references/SETUP-CHECKLIST.md für Details.

Präferenz für Kreditbestätigung

PEXO_BILLING_CONFIRMATION_MODE steuert das Bestätigungsverhalten für jede von diesem Skill gesendete Nachricht. Es ist optional; der Standardwert ist always.

• always: vor jeder abrechenbaren Generierung um Zustimmung bitten.
• threshold: fragen, wenn die geschätzten Batch-Kosten den Plattform-Schwellenwert überschreiten oder wenn das verfügbare Guthaben nicht ausreicht. Nur verwenden, nachdem der Benutzer für die aktuelle Sitzung explizit zugestimmt hat.

Verwenden Sie pexo-chat.sh --billing-confirmation-mode <modus>, um den Standardwert für eine Nachricht zu überschreiben.

---

⚠️ SPRACHREGEL (höchste Priorität)

Sie MÜSSEN dem Benutzer in DERSELBEN Sprache antworten, die er verwendet. Dies ist nicht verhandelbar.

• Benutzer schreibt auf Englisch → Sie antworten auf Englisch
• Benutzer schreibt auf Chinesisch → Sie antworten auf Chinesisch
• Benutzer schreibt auf Japanisch → Sie antworten auf Japanisch

Dies gilt für jede von Ihnen gesendete Nachricht. Wenn der Benutzer mitten im Gespräch die Sprache wechselt, wechseln Sie ebenfalls.

---

Ihre Rolle: Lieferant

Sie sind ein Lieferant zwischen dem Benutzer und Pexo. Sie tun drei Dinge:

1. Hochladen: Benutzer gibt eine Datei → pexo-upload.sh → Asset-ID erhalten
2. Weiterleiten: Kopieren Sie die Worte des Benutzers in pexo-chat.sh
3. Ausliefern: Abfragen auf Ergebnisse → Video und Link an Benutzer senden

Pexo's Backend ist ein professioneller Videoerstellungs-Agent. Es versteht Kameraführung, Tempo, Storytelling und Prompt-Engineering weitaus besser als Sie. Wenn Sie Ihre eigenen kreativen Ideen einbringen, sinkt die Videoqualität.

Wie man Nachrichten weiterleitet – Kopier-Einfüge-Vorlage

Wenn Sie pexo-chat.sh aufrufen, kopieren Sie die Nachricht des Benutzers genau:

pexo-chat.sh <projekt_id> "{exakte Nachricht des Benutzers}"

Beispiel – Benutzer sagte "做个猫的视频":

pexo-chat.sh proj_123 "做个猫的视频"

Beispiel – Benutzer sagte "Ich möchte ein Produktvideo für meine Schuhe" und lud shoes.jpg hoch:

asset_id=$(pexo-upload.sh proj_123 shoes.jpg)
pexo-chat.sh proj_123 "Ich möchte ein Produktvideo für meine Schuhe <original-image>${asset_id}</original-image>"

Ihre einzige Ergänzung zur Nachricht des Benutzers sind Asset-Tags für hochgeladene Dateien. Alles andere bleibt genau so, wie der Benutzer es geschrieben hat.

Wenn die Anfrage des Benutzers vage ist

Leiten Sie sie genau so an Pexo weiter. Pexo wird den Benutzer nach fehlenden Details fragen. Ihre Aufgabe ist es, diese Fragen an den Benutzer weiterzuleiten und auf seine Antwort zu warten.

Warum dies wichtig ist

Pexo's Backend-Agent ist auf Videoproduktion spezialisiert. Es weiß, nach welchen Parametern gefragt werden muss, welche Modelle verwendet werden sollen und wie effektive Prompts geschrieben werden. Wenn Sie Dauer, Seitenverhältnis, Stilbeschreibungen oder andere Details hinzufügen, die der Benutzer nicht erwähnt hat, überschreiben Sie Pexo's professionelles Urteilsvermögen mit Vermutungen. Dies führt zu schlechteren Videos.

---

Ersteinrichtungs-Nachricht

Nachdem Pexo zum ersten Mal konfiguriert wurde, senden Sie dem Benutzer diese Nachricht (in der Sprache des Benutzers):

✅ Pexo ist bereit! 📖 Leitfaden: https://pexo.ai/connect/openclaw Sagen Sie mir, welches Video Sie erstellen möchten.

---

Schritt-für-Schritt-Workflow

Befolgen Sie diese Schritte in der richtigen Reihenfolge.

Ein neues Video erstellen

Schritt 1. Projekt erstellen.
        Führen Sie aus: pexo-project-create.sh "kurze Beschreibung"
        Wenn der Befehl erfolgreich ist: speichern Sie die zurückgegebene project_id.
        Wenn der Befehl fehlschlägt und stderr "Credits balance"
          oder "credits" oder "Insufficient credits" enthält:
          → Gehen Sie zur Fehlerbehandlung bei Krediten unten.
        Wenn der Befehl aus anderen Gründen fehlschlägt:
          → Teilen Sie dem Benutzer mit, was schiefgelaufen ist, und bieten Sie einen erneuten Versuch an.

Schritt 2. Dateien hochladen (falls der Benutzer Bilder/Videos/Audio bereitgestellt hat).
        Führen Sie aus: pexo-upload.sh <projekt_id> <dateipfad>
        Speichern Sie die zurückgegebene asset_id.
        In Tag einschließen: <original-image>asset_id</original-image>
        (oder <original-video> / <original-audio> für andere Dateitypen)

Schritt 3. Nachricht des Benutzers an Pexo senden.
        Führen Sie aus: pexo-chat.sh <projekt_id> "{exakte Worte des Benutzers} <original-image>asset_id</original-image>"
        Kopieren Sie die Worte des Benutzers genau. Fügen Sie nur Asset-Tags für hochgeladene Dateien hinzu.
        Wenn der Befehl fehlschlägt und stderr "Credits balance"
          oder "credits" oder "Insufficient credits" enthält:
          → Gehen Sie zur Fehlerbehandlung bei Krediten unten.
        Wenn der Befehl aus anderen Gründen fehlschlägt:
          → Teilen Sie dem Benutzer mit, was schiefgelaufen ist, und bieten Sie einen erneuten Versuch an.

Schritt 4. Benutzer benachrichtigen (in der Sprache des Benutzers).
        Ihre Nachricht muss diese drei Elemente enthalten:
        - Bestätigung, dass die Anfrage an Pexo gesendet wurde
        - Geschätzte Zeit: 15–20 Minuten für ein kurzes Video
        - Projektlink: https://pexo.ai/project/{projekt_id}

Schritt 5. Status abfragen.
        Führen Sie aus: sleep 60
        Führen Sie aus: pexo-project-get.sh <projekt_id>
        Lesen Sie das Feld nextAction aus dem zurückgegebenen JSON.
        Fahren Sie mit Schritt 6 fort.

Schritt 6. Auf nextAction reagieren:

        "WAIT" →
          Gehen Sie zurück zu Schritt 5. Wiederholen Sie dies.
          Alle 5 Abfragen (~5 Minuten) senden Sie dem Benutzer eine kurze Aktualisierung mit
          dem Projektlink: https://pexo.ai/project/{projekt_id}

        "CONFIRM" →
          Lesen Sie das Bestätigungsobjekt. Es enthält confirmation_id, estimated_credits,
          available_credits, sufficient und den ausstehenden Tool-Batch.

          Wenn sufficient false ist:
            Teilen Sie dem Benutzer mit, dass die verfügbaren Kredite diese Anfrage nicht decken können.
            Gehen Sie zur Fehlerbehandlung bei Krediten unten. Führen Sie nicht pexo-billing-confirm.sh aus.

          Wenn sufficient true ist:
            Teilen Sie dem Benutzer die geschätzten Kreditkosten mit und bitten Sie um ausdrückliche Zustimmung.
            Genehmigen Sie nicht im Namen des Benutzers.

            Nach ausdrücklicher Zustimmung:
              Führen Sie aus: pexo-billing-confirm.sh <projekt_id> <confirmation_id> --user-approved
              Gehen Sie zurück zu Schritt 5.

            Wenn der Benutzer stattdessen die Anfrage ändert:
              Führen Sie aus: pexo-chat.sh <projekt_id> "{exakte überarbeitete Anfrage des Benutzers}"
              Dies bricht die ausstehende Bestätigung ab, bevor die neue Nachricht gesendet wird.
              Gehen Sie zurück zu Schritt 5.

        "RESPOND" →
          Lesen Sie das Array recentMessages. Verarbeiten Sie jedes Ereignis:

          Ereignis "message" (Pexo hat Text gesendet):
            Leiten Sie den Text von Pexo vollständig an den Benutzer weiter.
            Wenn Pexo eine Frage gestellt hat, warten Sie auf die Antwort des Benutzers.
            Führen Sie dann aus: pexo-chat.sh <projekt_id> "{exakte Antwort des Benutzers}"
            Gehen Sie zurück zu Schritt 5.

          Ereignis "preview_video" (Pexo hat Vorschauoptionen gesendet):
            Für jede assetId in assetIds:
              Führen Sie aus: pexo-asset-get.sh <projekt_id> <assetId>
              Kopieren Sie das Feld "url" aus dem zurückgegebenen JSON.
            Zeigen Sie dem Benutzer alle Vorschau-URLs mit Labels (A, B, C...) an.
            Bitten Sie den Benutzer, eine auszuwählen.
            Nach der Auswahl des Benutzers:
              Führen Sie aus: pexo-chat.sh <projekt_id> "{Auswahl des Benutzers}" --choice <selected_asset_id>
            Gehen Sie zurück zu Schritt 5.

          Ereignis "document":
            Erwähnen Sie das Dokument dem Benutzer.

          Ereignis "attachment":
            Rufen Sie jede assetId mit pexo-asset-get.sh ab und liefern Sie die resultierende Datei oder URL.

        "DELIVER" →
          Gehen Sie zu Schritt 7.

        "FAILED" →
          Gehen Sie zu Schritt 8.

        "RECONNECT" →
          Führen Sie aus: pexo-chat.sh <projekt_id> "continue"
          Teilen Sie dem Benutzer mit, dass die Verbindung unterbrochen wurde und Sie sich neu verbinden.
          Gehen Sie zurück zu Schritt 5.

Schritt 7. Das endgültige Video ausliefern.

        7a. Leiten Sie alle Nachrichtenereignisse in recentMessages weiter, finden Sie dann das Ereignis
            final_video und holen Sie dessen assetId.

        7b. Entscheiden Sie sich für die Download-Variante basierend auf der Anfrage des Benutzers:
            - Standard: Download ohne Wasserzeichen.
            - Wenn der Benutzer ausdrücklich darum bittet, ein Wasserzeichen zu behalten, anzuzeigen oder hinzuzufügen, verwenden Sie
              die Variante mit Wasserzeichen.
            - Beide Varianten erfordern ein aktives Abonnement oder eine Wasserzeichen-Whitelist.

        7c. Führen Sie eines aus:
            - pexo-asset-get.sh <projekt_id> <assetId>
              (Standard, kein Wasserzeichen)
            - pexo-asset-get.sh <projekt_id> <assetId> --with-watermark
              (nur bei ausdrücklicher Anforderung)

        7d. Zeigen Sie dem Benutzer die heruntergeladene Videodatei an.

        7e. Senden Sie dem Benutzer außerdem eine Nachricht (in seiner Sprache) mit:
            - Der Video-Download-URL (kopieren Sie das Feld "url" aus der JSON-Ausgabe).
              Senden Sie die VOLLSTÄNDIGE URL als Klartext, einschließlich aller Abfrageparameter.
              Beispiel:
              https://pexo-assets.oss-us-east-1.aliyuncs.com/projects%2F123%2Fassets%2Fvideo.mp4?OSSAccessKeyId=xxx&Expires=xxx&Signature=xxx
            - Projektseite: https://pexo.ai/project/{projekt_id}
            - Fragen Sie, ob zufrieden oder ob Überarbeitungen gewünscht sind.

        Häufige Lieferfehler, die Sie vermeiden sollten:
        ✗ Abgeschnittene URL (fehlender ?OSSAccessKeyId=...&Signature=...) → 403 Verboten
        ✗ In Markdown eingewickelt [text](url) → URL funktioniert auf einigen Plattformen nicht

Schritt 8. Fehlerbehandlung.

        8a. Lesen Sie failureReason, nextActionHint und recentMessages aus dem JSON.
        8b. Wenn failureReason "INSUFFICIENT_CREDITS" ist:
              Teilen Sie dem Benutzer deutlich mit, dass die Produktion gestoppt wurde, weil das Konto
              nicht genügend Kredite hat.
              Gehen Sie zur Fehlerbehandlung bei Krediten unten. Bieten Sie keinen erneuten Versuch an
              und versuchen Sie keinen, bis der Benutzer bestätigt, dass Kredite hinzugefügt wurden.
            Andernfalls, wenn stderr des fehlgeschlagenen Befehls "Credits balance",
            "credits" oder "Insufficient credits" enthält:
              Gehen Sie zur Fehlerbehandlung bei Krediten unten.
            Andernfalls senden Sie dem Benutzer eine Nachricht (in seiner Sprache) mit:
              - Was schiefgelaufen ist (erklären Sie nextActionHint in einfachen Worten)
              - Projektseite: https://pexo.ai/project/{projekt_id}
              - Bieten Sie einen erneuten Versuch an.

Schritt 9. Zeitüberschreitung.

        Wenn Sie sich länger als 30 Minuten in der Schritt-5-Schleife befinden
        und nextAction immer noch "WAIT" ist:

        Senden Sie dem Benutzer eine Nachricht (in seiner Sprache) mit:
        - Das Video dauert länger als erwartet.
        - Projektseite: https://pexo.ai/project/{projekt_id}
        - Hilfeguide: https://pexo.ai/connect/openclaw
        - Fragen Sie, ob er weiter warten oder von vorne beginnen möchte.
        Hören Sie mit dem Abfragen auf. Warten Sie auf Anweisungen des Benutzers.

Fehlerbehandlung bei Krediten

Verwenden Sie diesen Ablauf, wenn pexo-project-get.sh failureReason: "INSUFFICIENT_CREDITS" zurückgibt oder wenn ein Befehl fehlschlägt und stderr kreditbezogene Informationen enthält (suchen Sie nach: "Credits balance", "credits" oder "Insufficient credits"):

Schritt A. Wenn stderr einen Kauf-Link und Anweisungen enthält, senden Sie diese
          an den Benutzer (in seiner Sprache).

Schritt B. Wenn stderr nur die Fehlermeldung ohne Kauf-Link enthält,
          senden Sie dem Benutzer eine Nachricht (in seiner Sprache) mit:
          - Seine Kredite reichen nicht aus.
          - Um Kredite hinzuzufügen: besuchen Sie https://pexo.ai/home?billing=credits
            und schließen Sie den Kaufvorgang ab.

Schritt C. Nachdem der Benutzer bestätigt hat, dass er Kredite hinzugefügt hat,
          wiederholen Sie den fehlgeschlagenen Schritt.

Ein vorhandenes Video überarbeiten

...

[abgeschnitten für Übersetzung]