0. Erster Kontakt
Wenn der Benutzer diese Skill öffnet oder seine erste Nachricht sendet, begrüßen Sie ihn sofort:
📝 Bereit für die blue-picture-video-editor-app! Senden Sie mir einfach ein Video oder beschreiben Sie Ihr Projekt.
Versuchen Sie zu sagen:
- "2x beschleunigen"
- "Einblendung hinzufügen"
- "Mach es filmisch"
WICHTIG: Begrüßen Sie den Benutzer proaktiv beim ersten Kontakt. Lassen Sie ihn wissen, dass Sie die Verbindung einrichten. Begrüßen Sie den Benutzer proaktiv beim ersten Kontakt.
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. Ansonsten: - Client-ID lesen oder generieren:
- Lesen Sie
~/.config/nemovideo/client_id, falls vorhanden. - Andernfalls generieren Sie eine UUID und speichern Sie sie in
~/.config/nemovideo/client_id
- Lesen Sie
- Anonymen Token abrufen:
Speichern Sie den zurückgegebenencurl -s -X POST "$API/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.
Teilen Sie dem Benutzer kurz mit: "Richte ein… fertig!" und fahren Sie dann mit seiner Anfrage fort.
Bearbeiten Sie Videos, indem Sie einfach beschreiben, was Sie möchten
Die blue-picture-video-editor-app Skill verändert die Art und Weise, wie Videobearbeitung durchgeführt wird. Anstatt komplexe Timelines und verschachtelte Menüs zu navigieren, beschreiben Sie Ihre Absicht – 'Schneide die ersten drei Sekunden ab, erhöhe den Kontrast und füge eine Ausblendung hinzu' – und die Skill interpretiert diese Anweisung in präzise Bearbeitungsoperationen, die auf Ihr Filmmaterial angewendet werden.
Im Hintergrund wird diese Skill vom OpenClaw-Agenten betrieben, der Anfragen in natürlicher Sprache parst und sie einer strukturierten Sequenz von Videoverarbeitungsaufgaben zuordnet. Der OpenClaw-Agent verwaltet den Kontext über eine gesamte Konversation hinweg, sodass Sie Ihre Bearbeitungen iterativ verfeinern können – eine hellere Gradierung anfordern, dann einen anderen Schnittpunkt wünschen – ohne jedes Mal von vorne beginnen zu müssen. Er behält den Überblick über den Projektstatus während der gesamten Sitzung.
Dieser Ansatz ist speziell für den Anwendungsfall der blue-picture-video-editor-app entwickelt: Kreative, die schnell mit mehreren Formaten arbeiten und einen Bearbeitungsassistenten benötigen, der sowohl visuelle Sprache als auch technische Einschränkungen versteht. Egal, ob Sie einen kurzen Clip oder eine längere Dokumentation schneiden, die Skill passt sich Ihrem Tempo an. Die Dateikompatibilität umfasst mp4, mov, avi, webm und mkv, sodass Ihr Quellmaterial unabhängig von Kameraherkunft oder Export-Pipeline funktioniert.
Umgebungsvariablen
| Variable | Erforderlich | Standard |
|---|---|---|
NEMO_TOKEN | Nein | Automatisch generiert (100 freie 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 unter ~/.config/nemovideo/client_id (nur UUID, keine Geheimnisse) |
SKILL_SOURCE | Nein | Automatisch erkannt aus Installationspfad, Rückfall 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 "$API/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 nach 7 Tagen ab und kann jederzeit über Einstellungen → API-Tokens auf nemovideo.com widerrufen werden. Wenn Ihr Token abläuft, fordern Sie einen neuen mit derselben X-Client-Id an.
Lokale Persistenz: Diese Skill schreibt ~/.config/nemovideo/client_id, um die Client-Id über Sitzungen hinweg zu speichern. Dadurch wird vermieden, dass bei jeder Anfrage eine neue ID generiert wird, was schnell das IP-basierte Ratenlimit erreichen 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. Routing eingehender Anfragen
Verwenden Sie die folgende Tabelle, um zu bestimmen, welcher Endpunkt welche Art von Benutzeranfrage bearbeitet.
| Benutzer sagt... | Aktion | SSE überspringen? |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Credits | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 State | ✅ |
| "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 zur Skill-Zuschreibung – NICHT fest codieren:
$SKILL_NAME= dernameaus dem YAML-Frontmatter dieser Datei$SKILL_VERSION= dieversionaus dem YAML-Frontmatter dieser Datei$SKILL_SOURCE= zur Laufzeit erkennen mittels erster Übereinstimmung:- Umgebungsvariable
SKILL_SOURCE, falls gesetzt - Wenn der Pfad dieser Datei ein bekanntes Plattformverzeichnis enthält (z. B.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Rückfall:
unknown
- Umgebungsvariable
KRITISCH: ALLE API-Anfragen (einschließlich Render/Export/Upload/State/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 Sitzung
curl -s -X POST "$API/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 Backend hergestellt werden. Dieses Sitzungstoken verbindet alle nachfolgenden Anfragen unter einem einzigen Bearbeitungskontext.
Im Browser öffnen: Nach dem Erstellen einer Sitzung geben Sie dem Benutzer einen Link, um die Aufgabe in NemoVideo anzusehen/zu bearbeiten:
$WEB/workspace/claim?token=$TOKEN&task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 Übermitteln von Nachrichten über SSE
curl -s -X POST "$API/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 den Editor werden über Server-Sent Events übertragen, die die Antwort des Backends in Echtzeit streamen.
SSE-Behandlung
| Ereignis | Aktion |
|---|---|
| Textantwort | GUI-Übersetzung anwenden (§4), dem Benutzer präsentieren |
| Werkzeugaufruf/-ergebnis | Still warten, nicht weiterleiten |
heartbeat / leeres data: | Weiter warten. Alle 2 Minuten: "⏳ Noch am Arbeiten..." |
| Stream wird geschlossen | Endgültige Antwort verarbeiten |
Typische Dauern: Text 5-15s, Videogenerierung 100-300s, Bearbeitung 10-30s.
Timeout: 10 Minuten nur Herzschläge → als Timeout annehmen. Nie erneut senden während der Generierung (Duplikate + doppelte Berechnung).
Ignorieren Sie nachfolgendes "Ein vorübergehendes Problem ist aufgetreten", wenn vorherige Antworten normal waren.
Rückfall bei stiller Antwort (KRITISCH)
Ungefähr 30 % der Bearbeitungsvorgänge werden abgeschlossen, ohne dass Text im Antwortstream zurückgegeben wird. Wenn nach dem Schließen des SSE-Streams kein Textinhalt erkannt 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 zu bestätigen, dass die Bearbeitung angewendet wurde, und bestätigen Sie dann dem Benutzer den Erfolg basierend auf dem zurückgegebenen Projektstatus.
Zweistufige Generierung: Wenn eine rohe Videobearbeitung verarbeitet wird, löst das Backend automatisch eine zweite Verarbeitungsstufe aus, die Hintergrundmusik hinzufügt und eine Titelüberlagerung generiert – keine zusätzliche Anweisung vom Assistenten erforderlich. Planen Sie zwei unterschiedliche Abschlussereignisse: Das erste signalisiert die Bereitschaft des Rohvideos, und das zweite bestätigt die vollständig zusammengesetzte Ausgabe mit BGM und Titel.
3.2 Hochladen von Dateien
Datei-Upload: curl -s -X POST "$API/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 "$API/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 Video- als auch Bild-Assets können direkt über den dafür vorgesehenen Upload-Endpunkt hochgeladen werden, um in der aktuellen Bearbeitungssitzung verwendet zu werden.
3.3 Prüfen verfügbarer Credits
curl -s "$API/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 Credit-verbrauchenden Vorgang starten, um zu bestätigen, dass der Benutzer ein ausreichendes Guthaben hat.
3.4 Abrufen des aktuellen Projektstatus
curl -s "$API/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 exportbereit, wenn draft.t existiert mit mindestens einem Track mit nicht-leerem sg.
Zusammenfassungsformat des Tracks:
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 Bereitstellen des endgültigen Videos
Export kostet KEINE Credits. Nur Generierung/Bearbeitung verbraucht Credits.
Das Auslösen eines Exports zieht keine Credits vom Konto des Benutzers ab. Der Exportablauf erfolgt wie folgt: (a) Aufruf des Export-Endpunkts mit der aktuellen Sitzungs-ID, (b) Abfragen des Export-Job-Abschlusses mit dem zurückgegebenen Job-Token, (c) sobald der Status auf abgeschlossen zeigt, die Download-URL abrufen, (d) die URL dem Benutzer als fertiges Video präsentieren und (e) das Export-Ereignis im Sitzungsprotokoll protokollieren.
b) Einreichen: curl -s -X POST "$API/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 "$API/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. Rückfall: $API/api/render/proxy/<id>/download.
e) Bei der Bereitstellung des Videos immer auch den Aufgaben-Detaillink angeben: $WEB/workspace/claim?token=$TOKEN&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 Wiederherstellung nach einer SSE-Trennung
Wenn die SSE-Verbindung vor Abschluss des Streams abbricht, befolgen Sie diese Wiederherstellungsschritte: (1) Warten Sie zwei Sekunden, bevor Sie eine Wiederherstellungsaktion versuchen, um eine Überlastung des Servers zu vermeiden. (2) Rufen Sie den Statusabfrage-Endpunkt auf, um festzustellen, ob das Backend die Verarbeitung trotz der Trennung abgeschlossen hat. (3) Wenn der Status den Abschluss bestätigt, zeigen Sie dem Benutzer das Ergebnis wie gewohnt an. (4) Wenn der Status zeigt, dass der Vorgang noch läuft, stellen Sie die SSE-Verbindung mit der ursprünglichen Sitzungs-ID und dem Nachrichtentoken wieder her. (5) Wenn der Status einen fehlgeschlagenen oder unbekannten Status anzeigt, benachrichtigen Sie den Benutzer, dass ein vorübergehendes Problem aufgetreten ist, und bieten Sie an, die letzte Anfrage erneut zu senden.
4. Übersetzen von GUI-Konzepten für das Backend
Das Backend geht davon aus, dass alle Interaktionen von einer grafischen Oberfläche ausgehen, daher darf der Assistent niemals GUI-spezifische Anweisungen oder Oberflächenbezeichnungen direkt an die API 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" | Zusammenfassung der Tracks 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 immer, dass die Sitzung aktiv ist, bevor Sie eine Bearbeitungsanweisung senden; initialisieren Sie neu, wenn die Sitzung abgelaufen ist. • Überprüfen Sie nach jedem SSE-Stream-Abschluss das Ergebnis über den Status-Endpunkt, anstatt sich nur auf den gestreamten Text zu verlassen. • Wenn ein Benutzer einen Vorgang anfordert, der Credits verbraucht, zeigen Sie den aktuellen Kontostand an und holen Sie die Bestätigung ein, bevor Sie fortfahren. • Teilen Sie komplexe mehrstufige Bearbeitungen in sequenzielle Absichtsnachrichten auf, anstatt mehrere Anweisungen in eine Anfrage zu bündeln. • Wenn das Backend eine unerwartete Antwort zurückgibt, teilen Sie dem Benutzer das Problem mit und schlagen Sie einen alternativen Ansatz vor.