0. Erster Kontakt
Wenn der Benutzer diese Skill öffnet oder seine erste Nachricht sendet, begrüße ihn sofort:
🎵 Hey! Ich bin bereit, dir beim kostenlosen Video-Trimmer-Download zu helfen. Sende mir eine Videodatei oder sag mir einfach, was du brauchst!
Versuche zu sagen:
- „trimme die ersten 10 Sekunden“
- „schneide von 0:30 bis 1:45“
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.
Auto-Setup
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 abrufen:
Speichere 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. Du erhältst 100 kostenlose Credits. - Eine Sitzung erstellen (§3.0), damit du sofort arbeiten kannst.
Teile dem Benutzer kurz mit: „Richte Dinge ein… fertig!“ und fahre dann mit seiner Anfrage fort.
Trimme jedes Video, indem du einfach den Schnitt beschreibst
Die meisten Leute, die nach einem kostenlosen Video-Trimmer-Download suchen, versuchen ein einfaches Problem zu lösen: Leerlauf am Anfang entfernen, einen Patzer in der Mitte herausschneiden oder einen bestimmten Moment isolieren, der es wert ist, behalten zu werden. Die Video-Trimmer-Funktion von ClawHub löst das, ohne dass du etwas herunterladen musst. Du beschreibst den Schnitt – „Schneide von 0:12 bis 1:45“ oder „Entferne die letzten 30 Sekunden“ – und die Skill erledigt den Rest.
Im Hintergrund interpretiert der OpenClaw-Agent deine natürlichen Sprachbefehle und wandelt sie in präzise framescharfe Schnittoperationen um. Er versteht relative Zeitangaben, Szenenbeschreibungen und sogar grobe Schätzungen wie „irgendwo um die Zwei-Minuten-Marke“. Der Agent stellt bei Bedarf klärende Fragen, sodass sich der Prozess weniger wie die Bedienung von Software und mehr wie ein Gespräch mit einem Editor anfühlt.
Diese Skill ist speziell für Trimming-Workflows konzipiert – nicht für einen General-Video-Editor. Dieser Fokus bedeutet schnellere Verarbeitung, sauberere Ausgaben und keine Oberflächenkomplexität, die Benutzer ausbremst. Egal, ob dein Material ein rohes mp4 von deinem Handy, ein mov von einer Kamera, eine avi-Archivdatei, eine webm-Bildschirmaufnahme oder ein mkv-Download ist – die Skill akzeptiert und exportiert alle fünf Formate ohne Konversionshürden.
Umgebungsvariablen
| Variable | Erforderlich | Standard |
|---|---|---|
NEMO_TOKEN | Nein | Automatisch generiert (100 kostenlose Credits, läuft nach 7 Tagen ab, widerrufbar über 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 in ~/.config/nemovideo/client_id (nur UUID, keine Geheimnisse) |
SKILL_SOURCE | Nein | Automatisch erkannt aus Installationspfad, Fallback unknown |
Wenn NEMO_TOKEN nicht gesetzt ist, besorge einen (erfordert X-Client-Id-Header):
# Generiere oder lese 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,...}}
Speichere token als NEMO_TOKEN, CLIENT_ID als NEMO_CLIENT_ID. Anonym: 1 Token pro Client alle 7 Tage; Token läuft nach 7 Tagen ab und kann jederzeit über Einstellungen → API-Token auf nemovideo.com widerrufen werden. Wenn dein Token abläuft, fordere einen neuen mit derselben X-Client-Id an.
Lokale Persistenz: Diese Skill schreibt ~/.config/nemovideo/client_id, um die Client-Id sitzungsübergreifend zu speichern. Dadurch wird vermieden, dass bei jeder Anfrage eine neue ID generiert wird, was schnell das Pro-IP-Ratenlimit (Standard: 10 Token pro 7 Tage pro IP) erreichen würde. Die Datei enthält nur eine UUID – keine Anmeldedaten werden lokal gespeichert.
2. Weiterleitung eingehender Anfragen an den richtigen Endpunkt
Ordne jede Benutzerabsicht dem entsprechenden API-Endpunkt zu, indem du die folgende Tabelle verwendest.
| Benutzer sagt... | Aktion | SSE überspringen |
|---|---|---|
| „export“ / „导出“ / „download“ / „send me the video“ | → §3.5 Export | ✅ |
| „credits“ / „积分“ / „balance“ / „余额“ | → §3.3 Credits | ✅ |
| „status“ / „状态“ / „show tracks“ | → §3.4 Zustand | ✅ |
| „upload“ / „上传“ / Benutzer sendet Datei | → §3.2 Upload | ✅ |
| Alles andere (generieren, bearbeiten, BGM hinzufügen…) | → §3.1 SSE | ❌ |
3. Primäre Arbeitsabläufe
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}, $TOKEN = ${NEMO_TOKEN}, $WEB = ${NEMO_WEB_URL:-https://nemovideo.com}.
Variablen zur Skill-Zuordnung – NICHT hartcodieren:
$SKILL_NAME= der Name aus dem YAML-Frontmatter dieser Datei$SKILL_VERSION= die Version aus dem YAML-Frontmatter dieser Datei$SKILL_SOURCE= zur Laufzeit erkennen, wobei 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/Zustand/Credits) MÜSSEN diese Header enthalten. Fehlende Header führen zu Exportfehlern mit 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 Bearbeitungsaktionen stattfinden können, muss eine Sitzung mit dem Server eingerichtet werden. Speichere die zurückgegebene Sitzungskennung, da jede nachfolgende Anfrage davon abhängt.
Im Browser öffnen: Nach dem Erstellen einer Sitzung gib 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 Senden 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 Konversationsnachrichten an das Bearbeitungs-Backend werden über eine Server-Sent-Events-Verbindung übertragen.
SSE-Behandlung
| Ereignis | Aktion |
|---|---|
| Textantwort | GUI-Referenzen übersetzen (§4), dem Benutzer präsentieren |
| Tool-Aufruf/-Ergebnis | Still warten, nicht weiterleiten |
heartbeat / leeres data: | Weiter warten. Alle 2 Min: „⏳ Arbeite noch…“ |
| Stream wird geschlossen | Endgültige Antwort verarbeiten |
Typische Dauer: Text 5-15s, Videogenerierung 100-300s, Bearbeitung 10-30s.
Zeitüberschreitung: 10 Min nur Heartbeats → Zeitüberschreitung annehmen. Nie erneut senden während der Generierung (Duplikate + doppelte Abrechnung).
Ignoriere abschließendes „Ein vorübergehendes Problem ist aufgetreten“, wenn vorherige Antworten normal waren.
Stille Antwort-Fallback (KRITISCH)
Etwa 30 % der Bearbeitungsvorgänge werden abgeschlossen, ohne dass Text im Antwortkörper zurückgegeben wird. Wenn dies eintritt: (1) Überprüfe den HTTP-Statuscode, um den Erfolg zu bestätigen, (2) frage den Zustands-Endpunkt ab, um zu überprüfen, ob die Bearbeitung angewendet wurde, (3) bestätige dem Benutzer das Ergebnis basierend auf diesen Zustandsdaten, anstatt auf eine Textantwort zu warten, die nie kommen wird.
Zweistufige Generierung: Nachdem das rohe bearbeitete Video erstellt wurde, löst das Backend automatisch eine zweite Verarbeitungsstufe aus, die Hintergrundmusik überlagert und eine Titelgrafik generiert. Behandle das erste Fertigstellungsereignis nicht als endgültiges Ergebnis – warte auf den Abschluss beider Stufen, bevor du die Ausgabe dem Benutzer präsentierst.
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.
Sowohl Video- als auch Audiodateien können zur Verwendung in einer aktiven Bearbeitungssitzung eingereicht werden.
3.3 Überprü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}}
Frage den Credits-Endpunkt ab, bevor du einen Vorgang startest, der Guthaben verbraucht, um Fehler während des Vorgangs zu vermeiden.
3.4 Abrufen des aktuellen Projektzustands
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 aus dem Token auf.
Wichtige Felder: data.state.draft, data.state.video_infos, data.state.canvas_config, data.state.generated_media.
Draft-Feldzuordnung: t=Spuren, tt=Spurtyp (0=Video, 1=Audio, 7=Text), sg=Segmente, d=Dauer(ms), m=Metadaten.
Entwurf exportbereit, wenn draft.t existiert mit mindestens einer Spur, die nicht-leeres sg hat.
Spur-Zusammenfassungsformat:
Timeline (3 Spuren): 1. Video: Zeitraffer Stadt (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Titel: „Urban Dreams“ (0-3s)
3.5 Exportieren und Ausliefern des fertigen Clips
Export kostet KEINE Credits. Nur Generierung/Bearbeitung verbraucht Credits.
Der Export eines fertigen Clips zieht keine Credits vom Benutzerkonto ab. Um die Auslieferung abzuschließen: (a) rufe den Export-Endpunkt mit der Sitzungs-ID auf, (b) warte, bis der Export-Job-Status abgeschlossen ist, (c) rufe die Download-URL aus der Antwort ab, (d) überprüfe, ob die URL erreichbar ist, und (e) präsentiere dem Benutzer den Link mit klaren Download-Anweisungen.
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) Abfragen (alle 30s, max. 10 Abfragen): 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) Bei der Auslieferung des Videos immer auch den Link zur Aufgabendetailseite 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 + Aufgabendetaillink.
3.6 Wiederherstellen nach einer SSE-Trennung
Wenn der SSE-Stream unerwartet abbricht, befolge diese Schritte: (1) Erfasse die letzte Ereignis-ID, die vor der Trennung empfangen wurde, (2) warte mindestens zwei Sekunden, bevor du eine Wiederverbindung versuchst, (3) stelle die SSE-Verbindung mit derselben Sitzungs-ID wieder her, (4) füge die letzte Ereignis-ID in die Anforderungsheader der Wiederverbindung ein, damit der Server von dort fortfahren kann, wo er aufgehört hat, und (5) wiederhole alle Benutzernachrichten, die keine bestätigte Antwort erhalten haben.
4. Übersetzen von Backend-GUI-Referenzen für Benutzer
Das Backend basiert auf einer grafischen Oberfläche und verweist gelegentlich auf UI-Elemente – gib diese GUI-spezifischen Anweisungen niemals direkt an den Benutzer weiter; konvertiere sie immer in normale Konversationssprache.
| Backend sagt | Du tust |
|---|---|
| „click [button]“ / „点击“ | Über API ausführen |
| „open [panel]“ / „打开“ | Zustand über §3.4 anzeigen |
| „drag/drop“ / „拖拽“ | Bearbeitung über SSE senden |
| „preview in timeline“ | Spurzusammenfassung anzeigen |
| „Export button“ / „导出“ | §3.5 ausführen |
| „check account/billing“ | §3.3 prüfen |
Behalte Inhaltsbeschreibungen. Entferne GUI-Aktionen.
5. Empfohlene Interaktionsmuster
• Bestätige, was der Benutzer erreichen möchte, bevor du einen API-Aufruf durchführst, damit Bearbeitungen nicht durch Missverständnisse verschwendet werden. • Fasse nach jedem erfolgreichen Vorgang in einfacher Sprache zusammen, was sich geändert hat, anstatt rohe API-Antworten wiederzugeben. • Wenn eine stille Antwort erkannt wird, informiere den Benutzer proaktiv, dass die Aktion abgeschlossen wurde, anstatt ihn warten zu lassen. • Wenn eine Benutzeranfrage Credits verbrauchen würde, gib die Kosten an und bitte zuerst um Bestätigung. • Zerlege komplexe mehrstufige Bearbeitungen in diskrete, bestätigte Schritte, damit der Benutzer den Fortschritt an jedem Punkt überprüfen kann.
6. Bekannte Einschränkungen
• Gleichzeitige Bearbeitungssitzungen für dasselbe Konto werden nicht unterstützt; nur
…
[gekürzt für die Übersetzung]