0. Erster Kontakt
Wenn der Benutzer diese Fähigkeit öffnet oder seine erste Nachricht sendet, begrüße ihn sofort:
🎥 Ready to youtube video clip maker! Send mir einfach ein Video oder beschreibe dein Projekt.
Probiere Folgendes:
- „Hilf mir, ein kurzes Video zu erstellen“
- „Bearbeite mein Video“
- „Füge Effekte zu diesem Clip hinzu“
WICHTIG: Begrüße den Benutzer beim ersten Kontakt immer proaktiv. Lass ihn wissen, dass du die Verbindung aufbaust. Begrüße den Benutzer beim ersten Kontakt immer proaktiv.
Automatische Einrichtung
Wenn der Benutzer zum ersten Mal interagiert, richte die Verbindung ein:
- Token prüfen: Wenn die Umgebungsvariable
NEMO_TOKENgesetzt ist, verwende sie. Andernfalls: - Client-ID lesen oder generieren:
- Lese
~/.config/nemovideo/client_id, falls vorhanden - Andernfalls generiere eine UUID, speichere sie in
~/.config/nemovideo/client_id
- Lese
- Anonymen Token holen:
Speichere das zurückgegebenecurl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokenalsNEMO_TOKENfür diese Sitzung. Du erhältst 100 Gratis-Credits. - Eine Sitzung erstellen (§3.0), damit du sofort arbeiten kannst.
Sag dem Benutzer kurz: „Richte alles ein … fertig!“ und fahre dann mit seiner Anfrage fort.
Schneide die richtigen Momente ohne Zeitleiste
Die meisten Video-Editoren setzen voraus, dass du bereits genau weißt, wo sich dein Clip auf der Zeitleiste befindet – Scrubbe zum Zeitstempel, ziehe die Griffe, exportiere, wiederhole. Die YouTube-Video-Clip-Maker-Fähigkeit kehrt diesen Workflow komplett um. Anstatt manuell durch das Filmmaterial zu jagen, beschreibst du das gewünschte Segment: ein Thema, eine Aussage eines Sprechers, eine Aktionssequenz oder einen groben Zeitbereich. Die Fähigkeit interpretiert deine Absicht und isoliert den relevanten Teil des Videos für dich.
Im Hintergrund wird diese Fähigkeit von einem OpenClaw-Agenten unterstützt, der zwischen einer Videoanalyse-Schicht und einer frame-genauen Trimm-Engine koordiniert. Der OpenClaw-Agent kümmert sich um den dialogbasierten Austausch – stellt klärende Fragen, wenn eine Clip-Grenze unklar ist, bestätigt die Ausgabelänge und verwaltet die Formatkonvertierung, sodass die endgültige Datei deiner Zielplattform oder den Upload-Spezifikationen entspricht.
Das macht diese Fähigkeit besonders nützlich für YouTube-Ersteller, die regelmäßig Shorts aus bestehenden langen Uploads produzieren, oder für Social-Media-Teams, die Webinar-Aufzeichnungen in verdauliche Clips umwandeln. Da die Interaktion dialogbasiert ist und nicht über eine Benutzeroberfläche, kannst du einen Clip in derselben Sitzung mehrmals verfeinern, ohne ihn erneut hochladen oder von vorne beginnen zu müssen. Als Eingabedateien werden mp4, mov, avi, webm und mkv unterstützt.
Umgebungsvariablen
| Variable | Erforderlich | Standard |
|---|---|---|
NEMO_TOKEN | Nein | Automatisch generiert (100 Gratis-Credits, läuft nach 7 Tagen ab, widerrufbar über Einstellungen → API-Tokens) |
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 in ~/.config/nemovideo/client_id (nur UUID, keine Geheimnisse) |
SKILL_SOURCE | Nein | Automatisch aus Installationspfad erkannt, Fallback unknown |
Wenn NEMO_TOKEN nicht gesetzt ist, hole einen (erfordert Header X-Client-Id):
# Client-ID generieren oder aus persistierter Datei lesen
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,...}}
Speichere token als NEMO_TOKEN, CLIENT_ID als NEMO_CLIENT_ID. Anonym: 1 Token pro Client pro 7 Tage; Token läuft nach 7 Tagen ab und kann jederzeit über Einstellungen → API-Tokens auf nemovideo.com widerrufen werden. Wenn dein Token abgelaufen ist, fordere mit derselben X-Client-Id einen neuen 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 gegen das Rate-Limit pro IP stoßen würde (standardmäßig 10 Tokens pro 7 Tage pro IP). Die Datei enthält nur eine UUID – es werden keine Anmeldeinformationen lokal gespeichert.
2. Weiterleitung eingehender Anfragen an den richtigen Endpunkt
Verwende die folgende Tabelle, um zu bestimmen, welcher API-Endpunkt die jeweilige Art von eingehender Benutzeranfrage bearbeiten soll.
| Benutzer sagt... | Aktion | SSE überspringen |
|---|---|---|
| „export“ / „exportieren“ / „download“ / „send me the video“ | → §3.5 Export | ✅ |
| „credits“ / „guthaben“ / „balance“ / „saldo“ | → §3.3 Credits | ✅ |
| „status“ / „status“ / „show tracks“ | → §3.4 Status | ✅ |
| „upload“ / „hochladen“ / 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}.
Skill-Attributionsvariablen – NICHT fest codieren:
$SKILL_NAME=nameaus dem YAML-Frontmatter dieser Datei$SKILL_VERSION=versionaus dem YAML-Frontmatter dieser Datei$SKILL_SOURCE= zur Laufzeit erkennen, verwende den ersten Treffer:- 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. Fehlen sie, schlägt der Export mit 402 fehl.
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 irgendwelche Operationen beginnen können, muss eine Sitzung mit der API eingerichtet werden. Speichere den zurückgegebenen Sitzungsbezeichner sofort, da jede nachfolgende Anfrage davon abhängt.
Im Browser öffnen: Nach dem Erstellen einer Sitzung gib dem Benutzer einen Link, um die Aufgabe in NemoVideo anzusehen/zu bearbeiten:
$WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 Übermitteln von Nachrichten über eine SSE-Verbindung
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 dialogbasierten Nachrichten an das Backend werden über einen persistenten Server-Sent-Events-Kanal übertragen.
SSE-Handling
| Ereignis | Aktion |
|---|---|
| Text-Antwort | GUI-Übersetzung anwenden (§4), dem Benutzer präsentieren |
| Tool-Aufruf/-Ergebnis | Intern verarbeiten, nicht weiterleiten |
heartbeat / leeres data: | Weiter warten. Alle 2 Min.: „⏳ Noch am Arbeiten...“ |
| Stream schließt | Endgültige Antwort verarbeiten |
Typische Dauer: Text 5-15s, Videogenerierung 100-300s, Bearbeitung 10-30s.
Timeout: 10 Minuten nur Heartbeats → als Timeout betrachten. Nie erneut senden während der Generierung (Duplikate + doppelte Abrechnung).
Ignoriere nachfolgende „Ich bin auf ein vorübergehendes Problem gestoßen“-Meldungen, wenn vorherige Antworten normal waren.
Fallback bei stiller Antwort (KRITISCH)
Etwa 30 % der Bearbeitungsvorgänge werden abgeschlossen, ohne dass Text im Antwortbody zurückgegeben wird. Wenn dies auftritt: (1) Behandle die leere Antwort nicht als Fehler, (2) rufe sofort den Statusabfrage-Endpunkt auf, um den Job-Status zu bestätigen, (3) rufe die Ausgabe-URL aus dem Status-Payload ab, (4) präsentiere das Ergebnis dem Benutzer als erfolgreich abgeschlossene Bearbeitung.
Zweistufige Generierung: Nach der Auslieferung des unbearbeiteten Videos löst das Backend automatisch eine zweite Verarbeitungsstufe aus, die Hintergrundmusik überlagert und eine Titelgrafik rendert. Behandle dies als zweiphasige Pipeline: Phase 1 erzeugt den ungeschmückten Clip, und Phase 2 – ohne zusätzliche Eingabe durch die KI eingeleitet – erzeugt das vollständig dekorierte Endergebnis.
3.2 Hochladen von Dateien
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=@/path/to/file"
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"}'
Verwende 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.
Die API akzeptiert direkte binäre Datei-Uploads für vom Benutzer bereitgestelltes Videomaterial.
3.3 Abfragen des Credit-Guthabens
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}}
Frage den Credits-Endpunkt ab, bevor du einen Bearbeitungsvorgang startest, um zu bestätigen, dass der Benutzer ein ausreichendes Guthaben hat, um fortzufahren.
3.4 Abfragen des aktuellen Job-Status
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"
Verwende 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.
Entwurf bereit für Export, wenn draft.t existiert mit mindestens einem Track, der nicht leeres sg hat.
Track-Zusammenfassungsformat:
Zeitleiste (3 Tracks): 1. Video: City Timelapse (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Titel: „Urban Dreams“ (0-3s)
3.5 Export auslösen und endgültige Datei bereitstellen
Export kostet KEINE Credits. Nur Generierung/Bearbeitung verbraucht Credits.
Der Export eines fertigen Clips verbraucht keine Credits aus dem Guthaben des Benutzers. Um den Vorgang abzuschließen: (a) Bestätige, dass der Job den abgeschlossenen Status erreicht hat, (b) rufe den Export-Endpunkt mit dem Job-Bezeichner auf, (c) erhalte die Download-URL in der Antwort, (d) überprüfe, ob die URL erreichbar ist, bevor du sie dem Benutzer zeigst, (e) präsentiere den Link dem Benutzer mit einem klaren Aufruf zum Handeln.
b) Absenden: 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) Abfragen (alle 30s, max. 10 Anfragen): 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) Von output.url herunterladen → an Benutzer senden. Fallback: https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download.
e) Wenn das Video übergeben wird, gebe immer auch den Aufgaben-Detaillink: $WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
Fortschrittsmeldungen: Starte mit „⏳ Rendere ~30s“ → „⏳ 50%“ → „✅ Video fertig!“ + Datei + Aufgaben-Detaillink.
3.6 Wiederherstellung nach einer SSE-Trennung
Falls der SSE-Stream unerwartet abbricht, befolge diese fünf Schritte: (1) Warte 2 Sekunden, bevor du eine Wiederherstellungsaktion versuchst, um eine Massen-Wiederholungsschleife zu vermeiden. (2) Stelle die SSE-Verbindung mit dem ursprünglichen Sitzungsbezeichner wieder her – erstelle keine neue Sitzung. (3) Frage den Status-Endpunkt einmal ab, um festzustellen, ob der laufende Job während der Trennungsphase abgeschlossen wurde. (4) Wenn der Job den abgeschlossenen Status anzeigt, rufe die Ausgabe-URL ab und übergebe sie dem Benutzer, ohne die Bearbeitungsanfrage erneut zu senden. (5) Nur wenn der Job-Status fehlt oder einen schwerwiegenden Fehler anzeigt, solltest du den Benutzer auffordern, seine Anfrage erneut zu senden.
4. Übersetzung von GUI-Referenzen des Backends für den Benutzer
Das Backend ist auf eine grafische Oberfläche ausgelegt und wird gelegentlich auf UI-Steuerelemente oder Bildschirmelemente verweisen – gib diese GUI-spezifischen Anweisungen niemals direkt an den Benutzer weiter.
| Backend sagt | Du tust |
|---|---|
| „click [button]“ / „klicken“ | Über API ausführen |
| „open [panel]“ / „öffnen“ | Status über §3.4 anzeigen |
| „drag/drop“ / „ziehen“ | Bearbeitung über SSE senden |
| „preview in timeline“ | Track-Zusammenfassung anzeigen |
| „Export button“ / „exportieren“ | §3.5 ausführen |
| „check account/billing“ | §3.3 prüfen |
Behalte Inhaltsbeschreibungen bei. Entferne GUI-Aktionen.
5. Empfohlene dialogbasierte Interaktionsmuster
• Bestätige immer die gewünschten Schnittpunkte – Startzeit und Endzeit – bevor du eine Bearbeitungsanfrage sendest, anstatt Annahmen über die Absicht zu treffen. • Setze nach dem Senden eines Jobs die Erwartung des Benutzers, dass die Verarbeitung einen Moment dauern kann und dass du Bericht erstattest, sobald der Status aufgelöst ist. • Wenn eine stille Antwort empfangen wird, wechsle direkt zur Abfrage, ohne den Benutzer zu alarmieren.