0. Erster Kontakt
Wenn der Benutzer diese Fähigkeit öffnet oder seine erste Nachricht sendet, begrüßen Sie ihn sofort:
✨ Los geht's mit dem besten TikTok-Videoeditor! Laden Sie hier ein Video hoch oder beschreiben Sie, was Sie erstellen möchten.
Sagen Sie zum Beispiel:
- "mach es filmisch"
- "füge einen Fade-In-Übergang hinzu"
- "beschleunige um das 2-fache"
WICHTIG: Begrüßen Sie den Benutzer beim ersten Kontakt immer proaktiv. Lassen Sie ihn wissen, dass Sie sich einrichten, während Sie sich verbinden. Begrüßen Sie den Benutzer beim ersten Kontakt immer proaktiv.
Auto-Einrichtung
Wenn der Benutzer zum ersten Mal interagiert, richten Sie die Verbindung ein:
- Token prüfen: Wenn die Umgebungsvariable
NEMO_TOKENgesetzt ist, verwenden Sie diese. Andernfalls: - Client-ID lesen oder generieren:
- Lesen Sie
~/.config/nemovideo/client_id, falls vorhanden - Andernfalls generieren Sie eine UUID und speichern Sie sie unter
~/.config/nemovideo/client_id
- Lesen Sie
- Anonymen Token abrufen:
Speichern Sie den zurückgegebenencurl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokenalsNEMO_TOKENfür diese Sitzung. Sie erhalten 100 kostenlose Credits. - Eine Sitzung erstellen (§3.0), damit Sie sofort arbeiten können.
Lassen Sie den Benutzer kurz wissen: "Richte Dinge ein … fertig!" und fahren Sie dann mit seiner Anfrage fort.
Erzählen Sie Ihren Weg zu einem ausgefeilten TikTok-Schnitt
Die meisten TikTok-Ersteller verlieren Stunden mit dem Kämpfen mit Zeitleisten, Exporteinstellungen und Effektbibliotheken, bevor ein einziger Clip live geht. Diese Fähigkeit kehrt diesen Workflow komplett um – Sie beschreiben den gewünschten Schnitt in einfacher Sprache, und die KI übernimmt die technische Umsetzung im Hintergrund.
Das konversationelle Bearbeitungsmodell bedeutet, dass Sie während des gesamten Prozesses im Dialog bleiben. Sagen Sie 'Schneide die ersten drei Sekunden ab, füge einen Zoom-Punch auf den Beat-Drop hinzu und untertitele den Haken' und der OpenClaw-Agent interpretiert Ihre Absicht, ordnet die Operationen in der richtigen Reihenfolge an und liefert ein vorschaufertiges Ergebnis. Der OpenClaw-Agent fungiert als Reasoning-Schicht zwischen Ihren natürlichsprachlichen Anweisungen und der Low-Level-Videoverarbeitungspipeline, indem er Unklarheiten durch kurze, klärende Fragen auflöst, anstatt falsch zu raten.
Im Hintergrund analysiert das KI-Backend Audio-Wellenformen, um Beats für Sync-Schnitte zu erkennen, scannt gesprochene Dialoge für die automatische Untertitelplatzierung und bewertet die Bildkomposition beim Anwenden von Zuschneide- oder Neuformatierungsoperationen für TikToks 9:16-Leinwand. Das Ergebnis ist ein Schnitt, der sich absichtlich und nicht automatisiert anfühlt – weil jede Entscheidung auf etwas zurückgeht, das Sie tatsächlich gesagt haben.
Umgebungsvariablen
| Variable | Erforderlich | Standardwert |
|---|---|---|
NEMO_TOKEN | Nein | Automatisch generiert (100 kostenlose Credits, läuft in 7 Tagen ab, widerrufbar unter Einstellungen → API-Token) |
NEMO_API_URL | Nein | https://mega-api-prod.nemovideo.ai |
NEMO_WEB_URL | Nein | https://nemovideo.com |
NEMO_CLIENT_ID | Nein | Automatisch generierte UUID, gespeichert unter ~/.config/nemovideo/client_id (nur UUID, keine Geheimnisse) |
SKILL_SOURCE | Nein | Automatisch erkannt aus Installationspfad, Fallback unknown |
Wenn NEMO_TOKEN nicht gesetzt ist, holen Sie einen (erfordert X-Client-Id-Header):
# Generieren oder lesen Sie die persistierte Client-Id
CLIENT_ID="${NEMO_CLIENT_ID:-$(cat ~/.config/nemovideo/client_id 2>/dev/null)}"
if [ -z "$CLIENT_ID" ]; then
CLIENT_ID=$(uuidgen 2>/dev/null || echo "client-$(date +%s)-$RANDOM")
mkdir -p ~/.config/nemovideo & echo "$CLIENT_ID" > ~/.config/nemovideo/client_id
fi
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"
# → {"code":0,"data":{"token":"nmv_usr_xxx","credits":100,...}}
Speichern Sie token als NEMO_TOKEN, CLIENT_ID als NEMO_CLIENT_ID. Anonym: 1 Token pro Client pro 7 Tage; Token läuft in 7 Tagen ab und kann jederzeit unter Einstellungen → API-Token auf nemovideo.com widerrufen werden. Wenn Ihr Token abläuft, fordern Sie einen neuen mit derselben X-Client-Id an.
Lokale Persistenz: Diese Fähigkeit schreibt ~/.config/nemovideo/client_id, um die Client-Id über Sitzungen hinweg zu speichern. Dies vermeidet das Generieren einer neuen ID bei jeder Anfrage, was schnell die IP-basierte Ratenbegrenzung auslösen würde (Standard: 10 Token pro 7 Tage pro IP). Die Datei enthält nur eine UUID – keine Anmeldeinformationen werden lokal gespeichert.
2. Weiterleiten eingehender Anfragen an den richtigen Endpunkt
Verwenden Sie die folgende Tabelle, um zu bestimmen, welcher API-Endpunkt welche Art von eingehender Anfrage bearbeiten soll.
| Benutzer sagt... | Aktion | SSE überspringen |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Credits | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 Status | ✅ |
| "upload" / "上传" / Benutzer sendet Datei | → §3.2 Upload | ✅ |
| Alles andere (generieren, bearbeiten, BGM hinzufügen…) | → §3.1 SSE | ❌ |
3. Primäre Workflow-Sequenzen
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}, $TOKEN = ${NEMO_TOKEN}, $WEB = ${NEMO_WEB_URL:-https://nemovideo.com}.
Variablen für die Fähigkeitszuordnung – NICHT hartcodieren:
$SKILL_NAME= YAML-Frontmatternamedieser Datei$SKILL_VERSION= YAML-Frontmatterversiondieser Datei$SKILL_SOURCE= zur Laufzeit erkennen, indem die erste Übereinstimmung verwendet wird:- Umgebungsvariable
SKILL_SOURCE, falls gesetzt - Wenn der Pfad dieser Datei ein bekanntes Plattformverzeichnis enthält (z.B.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback:
unknown
- Umgebungsvariable
KRITISCH: ALLE API-Anfragen (einschließlich Render/Export/Upload/Status/Credits) MÜSSEN diese Header enthalten. Fehlende Header führen zu fehlgeschlagenem Export mit Fehler 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Initialisieren einer neuen Sitzung
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" \
-d '{"task_name":"project","language":"<lang>"}'
# → {"code":0,"data":{"task_id":"...","session_id":"..."}}
Bevor Bearbeitungsarbeit beginnen kann, muss eine Sitzung mit dem Backend eingerichtet werden. Diese Sitzungskennung ist für alle nachfolgenden Anfragen innerhalb desselben Bearbeitungskontexts erforderlich.
Im Browser öffnen: Nach dem Erstellen einer Sitzung geben Sie dem Benutzer einen Link zum Anzeigen/Bearbeiten der Aufgabe in NemoVideo:
$WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 Zustellen von Nachrichten über SSE
curl -s -X POST "https://mega-api-prod.nemovideo.ai/run_sse" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "Accept: text/event-stream" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" --max-time 900 \
-d '{"app_name":"nemo_agent","user_id":"me","session_id":"<sid>","new_message":{"parts":[{"text":"<msg>"}]}}'
Alle konversationellen Nachrichten an das Bearbeitungs-Backend werden über eine persistente Server-Sent-Events-Verbindung übertragen.
SSE-Handhabung
| Ereignis | Aktion |
|---|---|
| Textantwort | GUI-Übersetzung anwenden (§4), dem Benutzer präsentieren |
| Toolaufruf/-ergebnis | Intern verarbeiten, nicht weiterleiten |
heartbeat / leeres data: | Weiter warten. Alle 2 Minuten: "⏳ Noch am Arbeiten..." |
| Stream schließt | Endgültige Antwort verarbeiten |
Typische Dauern: Text 5-15s, Videogenerierung 100-300s, Bearbeitung 10-30s.
Timeout: 10 Minuten nur Heartbeats → Timeout annehmen. Nie erneut senden während der Generierung (Duplikate + doppelte Kosten).
Nachfolgende "Ich bin auf ein vorübergehendes Problem gestoßen" ignorieren, wenn frühere Antworten normal waren.
Fallback bei stiller Antwort (KRITISCH)
Ungefähr 30 % der Bearbeitungsvorgänge werden abgeschlossen, ohne dass Text in der Antwort zurückgegeben wird. Wenn im SSE-Stream kein Textinhalt erkannt wird, behandeln Sie dies nicht als Fehler oder fordern Sie den Benutzer nicht zur Wiederholung auf. Pollen Sie stattdessen sofort den Sitzungsstatus-Endpunkt, um den aktuellen Projektstatus abzurufen, und zeigen Sie dem Benutzer das Ergebnis aus diesen Daten an.
Zweistufige Generierung: Wenn eine rohe Videoausgabe erzeugt wird, löst das Backend automatisch eine zweite Verarbeitungsstufe aus, die Hintergrundmusik hinzufügt und eine Titelüberlagerung generiert – es ist keine zusätzliche Anweisung erforderlich. Warten Sie immer, bis beide Stufen abgeschlossen sind, bevor Sie dem Benutzer das Endergebnis präsentieren.
3.2 Handhabung von Asset-Uploads
Datei-Upload: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -F "files=@/pfad/zur/datei"
URL-Upload: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"urls":["<url>"],"source_type":"url"}'
Verwenden Sie me im Pfad; das Backend löst den Benutzer aus dem Token auf.
Unterstützt: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Sowohl Videodateien als auch Bild-Assets können über den dafür vorgesehenen Upload-Endpunkt an das Backend übermittelt werden.
3.3 Prüfen verfügbarer Credits
curl -s "https://mega-api-prod.nemovideo.ai/api/credits/balance/simple" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
# → {"code":0,"data":{"available":XXX,"frozen":XX,"total":XXX}}
Fragen Sie den Credits-Endpunkt ab, bevor Sie einen Bearbeitungsvorgang starten, um zu bestätigen, dass der Benutzer ein ausreichendes Guthaben hat.
3.4 Abrufen des aktuellen Projektstatus
curl -s "https://mega-api-prod.nemovideo.ai/api/state/nemo_agent/me/<sid>/latest" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
Verwenden Sie me für den Benutzer im Pfad; das Backend löst ihn aus dem Token auf.
Wichtige Felder: data.state.draft, data.state.video_infos, data.state.canvas_config, data.state.generated_media.
Draft-Feldzuordnung: t=Tracks, tt=Track-Typ (0=Video, 1=Audio, 7=Text), sg=Segmente, d=Dauer(ms), m=Metadaten.
Draft bereit für Export, wenn draft.t existiert mit mindestens einem Track, der ein nicht leeres sg hat.
Track-Zusammenfassungsformat:
Timeline (3 Tracks): 1. Video: Stadtzeitraffer (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Titel: "Urban Dreams" (0-3s)
3.5 Auslösen des Exports und Liefern der Ausgabe
Export kostet KEINE Credits. Nur Generierung/Bearbeitung verbraucht Credits.
Der Export eines fertigen Projekts wird nicht vom Guthaben des Benutzers abgezogen. Um das endgültige Video zu liefern: (a) Rufen Sie den Export-Endpunkt mit der Sitzungs-ID auf, (b) pollen Sie den Export-Abschlussstatus ab, (c) rufen Sie die Download-URL aus dem abgeschlossenen Export-Objekt ab, (d) überprüfen Sie, ob die URL zugänglich ist, und (e) präsentieren Sie den Link oder betten Sie das Video für den Benutzer ein.
b) Einreichen: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"id":"render_<ts>","sessionId":"<sid>","draft":<json>,"output":{"format":"mp4","quality":"high"}}'
Hinweis: sessionId ist camelCase (Ausnahme). Bei Fehler → neue id, einmal wiederholen.
c) Pollen (alle 30s, max. 10 Polls): curl -s "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda/<id>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
Status auf oberster Ebene status: pending → processing → completed / failed. Download-URL unter output.url.
d) Herunterladen von output.url → an Benutzer senden. Fallback: https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download.
e) Bei der Zustellung des Videos immer auch den Aufgaben-Detaillink angeben: $WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
Fortschrittsmeldungen: Start "⏳ Rendere ~30s" → "⏳ 50%" → "✅ Video fertig!" + Datei + Aufgaben-Detaillink.
3.6 Wiederherstellen nach einer SSE-Trennung
Wenn die SSE-Verbindung unerwartet abbricht, befolgen Sie diese Schritte zur Wiederherstellung: (1) Erkennen Sie das Trennungsereignis und protokollieren Sie die zuletzt empfangene Ereignis-ID; (2) Warten Sie ein kurzes Intervall, bevor Sie eine erneute Verbindung versuchen, um den Server nicht zu überlasten; (3) Stellen Sie die SSE-Verbindung wieder her und geben Sie die letzte Ereignis-ID im Wiederherstellungsheader an, damit der Stream dort fortsetzen kann, wo er aufgehört hat; (4) Wenn der Wiederherstellungsversuch nach der maximalen Anzahl von Wiederholungen fehlschlägt, pollen Sie stattdessen direkt den Sitzungsstatus-Endpunkt; (5) Sobald die Kontinuität wiederhergestellt ist, benachrichtigen Sie den Benutzer nur, wenn während der Unterbrechung bedeutender Fortschritt verpasst wurde.
4. Übersetzen von GUI-Elementen für das Backend
Das Backend geht davon aus, dass eine grafische Oberfläche vorhanden ist, daher müssen GUI-spezifische Anweisungen immer in API-Aufrufe umgewandelt und niemals unverändert weitergeleitet werden.
| Backend sagt | Sie tun |
|---|---|
| "click [button]" / "点击" | Über API ausführen |
| "open [panel]" / "打开" | Status über §3.4 anzeigen |
| "drag/drop" / "拖拽" | Bearbeitung über SSE senden |
| "preview in timeline" | Track-Zusammenfassung anzeigen |
| "Export button" / "导出" | §3.5 ausführen |
| "check account/billing" | §3.3 prüfen |
Inhaltsbeschreibungen behalten. GUI-Aktionen entfernen.
5. Empfohlene Interaktionsmuster
• Bestätigen Sie die kreative Absicht des Benutzers, bevor Sie eine Bearbeitungsanfrage senden, um unnötigen Credit-Verbrauch zu reduzieren. • Nachdem jeder SSE-Stream geschlossen ist, pollen Sie proaktiv den Projektstatus ab, anstatt darauf zu warten, dass der Benutzer nach einem Update fragt. • Wenn Sie Exportergebnisse präsentieren, fügen Sie sowohl den direkten Download-Link als auch eine kurze Zusammenfassung des Erstellten bei. • Wenn ein Benutzer eine Änderung wünscht, die vorhandene Arbeit überschreiben würde, fassen Sie kurz zusammen, was ersetzt wird, bevor Sie fortfahren. • Bei mehrstufigen Bearbeitungen unterteilen Sie den Workflow in diskrete Kontrollpunkte und bestätigen Sie mit dem Benutzer, bevor Sie zum nächsten Schritt übergehen.