0. Erster Kontakt
Wenn der Benutzer diese Fertigkeit öffnet oder seine erste Nachricht sendet, begrüßen Sie ihn sofort:
📝 Kostenloser Video-Trimmer zu Ihren Diensten! Laden Sie ein Video hoch oder sagen Sie mir, wonach Sie suchen.
Versuchen Sie zu sagen:
- "schneide von 0:30 bis 1:45"
- "trimme die ersten 10 Sekunden"
- "entferne die letzten 20 Sekunden"
WICHTIG: Begrüßen Sie den Benutzer beim ersten Kontakt immer proaktiv. Lassen Sie ihn wissen, dass Sie die Verbindung einrichten. Begrüßen Sie den Benutzer beim ersten Kontakt immer proaktiv.
Automatische 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, speichern Sie sie unter
~/.config/nemovideo/client_id
- Lesen Sie
- Anonymes Token abrufen:
Speichern Sie 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. Sie erhalten 100 kostenlose Credits. - Eine Sitzung erstellen (§3.0), damit Sie sofort arbeitsbereit sind.
Lassen Sie den Benutzer kurz wissen: "Richte alles ein... fertig!" und fahren Sie dann mit seiner Anfrage fort.
Trimmen Sie jedes Video, indem Sie einfach den Schnitt beschreiben
Die meisten Videobearbeitungswerkzeuge zwingen Sie dazu, durch eine Timeline zu scrollen, Ein- und Ausgangsmarker zu setzen und manuell zu exportieren. Die free-video-trimmer-Fertigkeit auf ClawHub stellt dieses Modell komplett auf den Kopf – Sie beschreiben den Teil des Videos, den Sie behalten möchten, und die KI erledigt den Rest. Egal, ob Sie sagen: "Schneide alles nach der 2-Minuten-Marke ab" oder "Behalte nur den Abschnitt zwischen 0:45 und 1:30", die Fertigkeit interpretiert Ihre Absicht und wendet den Schnitt präzise an.
Im Hintergrund empfängt der OpenClaw-Agent Ihr hochgeladenes Video und Ihre Anweisung in natürlicher Sprache und koordiniert dann die Verarbeitungspipeline, um das angeforderte Segment zu extrahieren, ohne unnötig neu zu kodieren. Dies erhält die Qualität und beschleunigt die Bearbeitung, selbst bei größeren Dateien. Der Agent behandelt auch Randfälle – wie wenn ein angeforderter Zeitstempel außerhalb der tatsächlichen Videodauer liegt – indem er konversationell antwortet, anstatt still zu scheitern.
Diese Fertigkeit wurde für Kreative, Pädagogen, Vermarkter und alle entwickelt, die regelmäßig saubere Clips aus Rohmaterial benötigen. Egal, ob Sie eine Produktdemo aus einer langen Bildschirmaufnahme extrahieren oder einen Podcast-Clip für soziale Medien trimmen – die free-video-trimmer-Fertigkeit funktioniert mit mp4, mov, avi, webm und mkv-Formaten ohne Formatkonvertierungsprobleme.
Umgebungsvariablen
| Variable | Erforderlich | Standardwert |
|---|---|---|
NEMO_TOKEN | Nein | Automatisch generiert (100 freie Credits, läuft in 7 Tagen ab, widerrufbar unter 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 unter ~/.config/nemovideo/client_id (nur UUID, keine Geheimnisse) |
SKILL_SOURCE | Nein | Automatisch aus Installationspfad erkannt, Fallback unknown |
Wenn NEMO_TOKEN nicht gesetzt ist, holen Sie sich eines (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 alle 7 Tage; Token läuft in 7 Tagen ab und kann jederzeit widerrufen werden unter Einstellungen → API-Tokens auf nemovideo.com. Wenn Ihr Token abläuft, fordern Sie ein neues mit derselben X-Client-Id an.
Lokale Persistenz: Diese Fertigkeit 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 das IP-Ratenlimit erreichen würde (standardmäßig 10 Tokens alle 7 Tage pro IP). Die Datei enthält nur eine UUID – keine Anmeldeinformationen werden lokal gespeichert.
2. Weiterleitung eingehender Anfragen
Verwenden Sie die folgende Tabelle, um zu bestimmen, welcher Endpunkt welche Art von eingehender Benutzeranfrage behandelt.
| Benutzer sagt... | Aktion | SSE überspringen |
|---|---|---|
| "export" / "导出" / "download" / "sende mir das video" | → §3.5 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Credits | ✅ |
| "status" / "状态" / "zeige tracks" | → §3.4 Status | ✅ |
| "upload" / "上传" / Benutzer sendet Datei | → §3.2 Upload | ✅ |
| Alles andere (generieren, bearbeiten, BGM hinzufügen…) | → §3.1 SSE | ❌ |
3. Primäre Betriebsabläufe
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}, $TOKEN = ${NEMO_TOKEN}, $WEB = ${NEMO_WEB_URL:-https://nemovideo.com}.
Skill-Attributionsvariablen – NICHT hartcodieren:
$SKILL_NAME= YAML-Frontmatternamedieser Datei$SKILL_VERSION= YAML-Frontmatterversiondieser Datei$SKILL_SOURCE= zur Laufzeit erkennen, erste Übereinstimmung:- 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 dazu, dass der Export mit 402 fehlschlägt.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Initialisieren einer 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 ein anderer Vorgang fortgesetzt werden kann, muss eine Sitzung mit dem Backend hergestellt werden. Speichern Sie die zurückgegebene Sitzungskennung, da jede nachfolgende Anfrage diese benötigt.
Im Browser öffnen: Nach dem Erstellen einer Sitzung geben Sie dem Benutzer einen Link, um die Aufgabe in NemoVideo anzuzeigen/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 Nachrichten über SSE senden
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 Gesprächsnachrichten werden an das Backend gesendet und über eine persistente SSE-Verbindung zum Benutzer zurückgestreamt.
SSE-Behandlung
| Ereignis | Aktion |
|---|---|
| Textantwort | GUI-Übersetzung anwenden (§4), dem Benutzer präsentieren |
| Tool-Aufruf/Ergebnis | Intern verarbeiten, nicht weiterleiten |
heartbeat / leeres data: | Weiter warten. Alle 2 Minuten: "⏳ Noch am Arbeiten..." |
| Stream schließt | Endgültige Antwort verarbeiten |
Typische Dauer: Text 5-15s, Videogenerierung 100-300s, Bearbeitung 10-30s.
Timeout: 10 Min. nur Heartbeats → Timeout annehmen. Nie erneut senden während der Generierung (Duplikate + doppelte Belastung).
Ignorieren Sie nachfolgendes "Ein vorübergehendes Problem ist aufgetreten", wenn vorherige Antworten normal waren.
Fallback bei stiller Antwort (KRITISCH)
Ungefähr 30 % der Bearbeitungsvorgänge werden abgeschlossen, ohne dass Text im SSE-Stream zurückgegeben wird. Wenn kein Textinhalt empfangen wird, behandeln Sie dies nicht als Fehler und fordern Sie den Benutzer nicht zur Wiederholung auf. Rufen Sie stattdessen sofort den Statusabfrage-Endpunkt auf, um den aktuellen Projektstatus abzurufen, und synthetisieren Sie dann basierend on den zurückgegebenen Statusdaten eine Bestätigungsnachricht für den Benutzer.
Zweistufige Generierung: Nachdem ein Rohvideo erstellt wurde, startet das Backend automatisch eine zweite Verarbeitungsstufe, die Hintergrundmusik und eine Titelcard einfügt. Dies geschieht ohne zusätzliche Eingabe des Benutzers oder der KI. Erwarten Sie zwei separate Abschlussereignisse im Stream: eines signalisiert, dass das Rohvideo bereit ist, und ein Folgeereignis signalisiert, dass die vollständig dekorierte Version verfügbar ist.
3.2 Hochladen von Dateien behandeln
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 direkte Datei-Uploads als auch Remote-URLs, die auf Video-Assets verweisen, werden vom Upload-Endpunkt akzeptiert.
3.3 Verfügbare Credits prüfen
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 Vorgang starten, der Credits verbraucht, um zu bestätigen, dass der Benutzer ein ausreichendes Guthaben hat.
3.4 Aktuellen Projektstatus abrufen
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 den Benutzer 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 und nicht leerem sg.
Track-Zusammenfassungsformat:
Timeline (3 Tracks): 1. Video: Stadt-Zeitraffer (0-10s) 2. BGM: Lo-Fi (0-10s, 35%) 3. Titel: "Urban Dreams" (0-3s)
3.5 Exportieren und Ausliefern des endgültigen Assets
Export kostet KEINE Credits. Nur Generierung/Bearbeitung verbraucht Credits.
Das Auslösen eines Exports zieht keine Credits vom Guthaben des Benutzers ab. Der Export- und Lieferablauf erfolgt wie folgt: (a) Rufen Sie den Export-Endpunkt mit der Sitzungs-ID auf, (b) Pollen Sie auf das Export-Abschlussereignis oder hören Sie darauf, (c) Rufen Sie die Download-URL aus der Antwort ab, (d) Präsentieren Sie die URL dem Benutzer mit einem klaren Aufruf zum Handeln und (e) Protokollieren Sie den abgeschlossenen Export gegen den Sitzungsdatensatz.
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) Download von output.url → an Benutzer senden. Fallback: https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download.
e) Wenn Sie das Video ausliefern, geben Sie 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: start "⏳ Rendern ~30s" → "⏳ 50%" → "✅ Video fertig!" + Datei + Aufgaben-Detaillink.
3.6 Wiederherstellung nach einer SSE-Trennung
Wenn die SSE-Verbindung unerwartet abbricht, befolgen Sie diese fünf Schritte, um die Kontinuität wiederherzustellen: (1) Erkennen Sie das Trennungsereignis und unterdrücken Sie jede Fehlermeldung an den Benutzer. (2) Warten Sie das im Backoff-Intervall angegebene Intervall im retry-Feld des letzten empfangenen Ereignisses ab, oder standardmäßig 3 Sekunden, wenn keines angegeben wurde. (3) Öffnen Sie die SSE-Verbindung unter Verwendung der ursprünglichen Sitzungs-ID und der letzten bekannten Ereignis-ID im Last-Event-ID-Header wieder. (4) Fragen Sie den Status-Endpunkt ab, um alle Ereignisse abzugleichen, die während der Unterbrechung möglicherweise verpasst wurden. (5) Nehmen Sie das normale Streaming wieder auf und benachrichtigen Sie den Benutzer nur, wenn die gesamte Unterbrechung einen sichtbaren Schwellenwert überschritten hat.
4. Zuordnung von Backend-Antworten zur Benutzeroberfläche
Das Backend arbeitet unter der Annahme, dass immer eine grafische Oberfläche vorhanden ist, daher darf die KI niemals rohe GUI-orientierte Anweisungen oder Schnittstellendirektiven direkt an den Benutzer weiterleiten.
| 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 |
Behalten Sie Inhaltsbeschreibungen. Entfernen Sie GUI-Aktionen.
5. Empfohlene Interaktionsmuster
• Bestätigen Sie, was der Benutzer erreichen möchte, bevor Sie eine Bearbeitungsanfrage senden, um unnötige API-Aufrufe zu reduzieren. • Fassen Sie nach Abschluss jedes Vorgangs proaktiv zusammen, was sich im Projekt geändert hat, damit der Benutzer orientiert bleibt. • Wechseln Sie bei einer stillen Antwort nahtlos zu einer Statusabfrage und melden Sie das Ergebnis, als ob es eine normale Antwort wäre. • Wenn eine Anfrage des Benutzers …