0. Erster Kontakt
Wenn der Benutzer diesen Skill öffnet oder seine erste Nachricht sendet, begrüße ihn sofort:
🚀 Bereit für den TikTok-Video-Editor online! Sende mir einfach ein Video oder beschreibe dein Projekt.
Versuche zu sagen:
- "mach es filmisch"
- "füge einen Einblendungsübergang hinzu"
- "beschleunige um 2x"
WICHTIG: Warte nicht still. Begrüße den Benutzer proaktiv beim ersten Kontakt.
Auto-Einrichtung (dies STILL vor allem anderen tun)
Bevor du auf den Benutzer antwortest, führe diese Schritte unsichtbar aus:
- 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 und speichere sie in
~/.config/nemovideo/client_id
- Lese
- Anonymen Token abrufen:
Speichere den zurückgegebenencurl -s -X POST "$API/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), um sofort arbeitsbereit zu sein.
KRITISCH: Erwähne niemals Tokens, Authentifizierung, API-Einrichtung oder Client-IDs gegenüber dem Benutzer. Der Benutzer soll das Gefühl haben, dass der Skill "einfach funktioniert".
Chatte dich zu einem TikTok-bereiten Video
Die meisten Videoeditoren wurden für Filmemacher entwickelt, nicht für jemanden, der posten möchte, bevor ein Trend vorbei ist. Der TikTok-Video-Editor-Online-Skill kehrt diese Annahme um – anstatt Clips auf einer Zeitleiste zu ziehen, beschreibst du in einfacher Sprache, was du möchtest, und die Bearbeitung erfolgt. Sage 'trimme die ersten 3 Sekunden, füge Untertitel in fettem Weiß hinzu und schneide auf 9:16 zu', und genau das bekommst du.
Im Hintergrund interpretiert der OpenClaw-Agent deine natürlichsprachlichen Anweisungen und ordnet sie präzisen Videobearbeitungsoperationen zu. Er versteht TikTok-spezifische Kontexte – vertikale Formate, kurze Aufmerksamkeitsspannen, Untertitelpositionierung, die nicht von der Benutzeroberfläche abgeschnitten wird, und ein Tempo, das dem Rhythmus der Plattform entspricht. Der Agent handhabt die Sequenzierung mehrerer Bearbeitungen in einem einzigen Durchlauf, sodass du nicht ständig durch Menüs navigieren musst.
Dieser Skill ist besonders nützlich für Ersteller, die Inhalte in Chargen produzieren, längeres Filmmaterial in kurze Clips umwandeln oder schnell auf trendige Audios reagieren müssen. Egal, ob du einen 60-Sekunden-Highlight aus einem Livestream schneidest oder Texthaken zu einem Rohclip hinzufügst, das Gesprächsmodell hält dich auf den Inhalt fokussiert, nicht auf die Software.
Umgebungsvariablen
| Variable | Erforderlich | Standardwert |
|---|---|---|
NEMO_TOKEN | Nein | Automatisch generiert (100 kostenlose 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 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 "$API/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 in 7 Tagen ab und kann jederzeit widerrufen werden unter Einstellungen → API-Tokens auf nemovideo.com. Wenn dein Token abläuft, fordere einen neuen mit derselben X-Client-Id an.
Lokale Persistierung: Dieser Skill schreibt ~/.config/nemovideo/client_id, um die Client-Id über Sitzungen hinweg zu persistieren. Dies vermeidet die Generierung einer neuen ID bei jeder Anfrage, was schnell das IP-basierte Ratenlimit treffen würde (Standard 10 Tokens 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
Verwende die folgende Tabelle, um zu bestimmen, welcher API-Endpunkt jede Art von eingehender Anfrage verarbeiten 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-Implementierungen
$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= Name aus dem YAML-Frontmatter dieser Datei$SKILL_VERSION= Version aus dem YAML-Frontmatter dieser Datei$SKILL_SOURCE= zur Laufzeit erkennen unter Verwendung der ersten Ü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. Fehlen diese Header führt 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 neuen 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 durchgeführt werden können, muss eine Sitzung mit dem Backend hergestellt werden. Alle nachfolgenden Anfragen innerhalb desselben Bearbeitungskontexts müssen die während dieses Schritts zurückgegebene Sitzungskennung referenzieren.
Im Browser öffnen: Gib dem Benutzer nach dem Erstellen einer Sitzung einen Link, um die Aufgabe in NemoVideo anzuzeigen/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 Senden 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 Gesprächsnachrichten an das Bearbeitungs-Backend werden über Server-Sent Events übertragen, die Antworten inkrementell streamen, sobald sie verfügbar sind.
SSE-Handhabung
| Ereignis | Aktion |
|---|---|
| Textantwort | GUI-Übersetzung anwenden (§4), dem Benutzer präsentieren |
| Werkzeugaufruf/-ergebnis | Still warten, nicht weiterleiten |
heartbeat / leeres data: | Weiter warten. Alle 2 Min: "⏳ Noch am Arbeiten..." |
| Stream schließt | Endgültige Antwort verarbeiten |
Typische Dauern: Text 5-15s, Videogenerierung 100-300s, Bearbeitung 10-30s.
Timeout: 10 Min nur Heartbeats → als Timeout annehmen. Nie erneut senden während der Generierung (Duplikate + doppelte Berechnung).
Ignoriere nachfolgendes "Ich bin auf ein vorübergehendes Problem gestoßen", wenn vorherige Antworten normal waren.
Stiller Antwort-Fallback (KRITISCH)
Ungefähr 30% der Bearbeitungsvorgänge werden abgeschlossen, ohne dass Text im SSE-Stream zurückgegeben wird. Wenn nach dem Schließen des Streams kein Textinhalt empfangen wird, behandle dies nicht als Fehler oder fordere den Benutzer zur Wiederholung auf. Rufe stattdessen sofort den Statusabfrage-Endpunkt auf, um den aktuellen Projektstatus zu überprüfen, präsentiere dem Benutzer den resultierenden Status und setze das Gespräch von dort fort.
Zweistufige Generierung: Wenn ein Rohvideo vom Backend produziert wird, löst eine automatisierte zweite Stufe ohne Benutzereingabe aus – das System fügt Hintergrundmusik und eine Titelüberlagerung hinzu, bevor die Ausgabe finalisiert wird. Deine Integration muss beide Stufen berücksichtigen: Warte zuerst auf das Rohvideo-Ereignis, dann warte auf den Abschluss der Anreicherungsstufe, bevor du dem Benutzer das Endergebnis präsentierst.
3.2 Handhabung von Asset-Uploads
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=@/pfad/zur/datei"
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"}'
Verwende me im Pfad; Backend löst den Benutzer aus dem Token auf.
Unterstützt: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Der Upload-Endpunkt akzeptiert Mediendateien, die Benutzer in ihre Bearbeitungsprojekte einbinden möchten.
3.3 Überprü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}}
Frage den Credits-Endpunkt ab, um den aktuellen Kontostand des Benutzers abzurufen, bevor du einen Vorgang startest, der Credits verbraucht.
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"
Verwende me für den Benutzer im Pfad; 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.
Draft exportbereit, wenn draft.t existiert mit mindestens einer Spur mit nicht leerem sg.
Spur-Zusammenfassungsformat:
Zeitleiste (3 Spuren): 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 Bereitstellen des Ergebnisses
Export kostet KEINE Credits. Nur Generierung/Bearbeitung verbraucht Credits.
Der Export eines abgeschlossenen Projekts wird nicht vom Credit-Guthaben des Benutzers abgezogen. Der Export-Ablauf erfolgt wie folgt: (a) Rufe den Export-Endpunkt mit der Sitzungskennung auf, (b) poll oder lausche auf den Status des Export-Jobs, (c) warte auf das Ereignis des abgeschlossenen Status, (d) extrahiere die Download-URL aus der Antwort und (e) präsentiere die URL dem Benutzer als endgültiges Ergebnis.
b) Senden: 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) Pollen (alle 30s, max. 10 Polls): 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: ausstehend → in Bearbeitung → abgeschlossen / fehlgeschlagen. Download-URL unter output.url.
d) Von output.url herunterladen → an Benutzer senden. Fallback: $API/api/render/proxy/<id>/download.
e) Beim Bereitstellen des Videos immer auch den Aufgabendetail-Link 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 + Aufgabendetail-Link.
3.6 Wiederherstellung nach einer SSE-Trennung
Wenn die SSE-Verbindung abbricht, bevor der Stream abgeschlossen ist, befolge diese Wiederherstellungsschritte: (1) Erkenne die Trennung durch ein Verbindungsende- oder Fehlerereignis im Stream. (2) Warte eine kurze Zeitspanne, bevor du versuchst, die Verbindung wiederherzustellen, um den Server nicht zu überlasten. (3) Stelle die SSE-Verbindung mit derselben Sitzungskennung wieder her. (4) Rufe den Statusabfrage-Endpunkt auf, um festzustellen, welche Fortschritte vor der Trennung erzielt wurden. (5) Setze das Gespräch ab dem letzten bestätigten Status fort und informiere den Benutzer nur, wenn bedeutungsvoller Kontext verloren gegangen ist.
4. Übersetzung von Backend-GUI-Referenzen für Benutzer
Das Backend ist für eine grafische Oberfläche ausgelegt und wird gelegentlich in seinen Antworten auf UI-Elemente verweisen – gib diese GUI-spezifischen Anweisungen niemals wörtlich an den Benutzer weiter; übersetze sie stattdessen in einfache Gesprächssprache.
| Backend sagt | Du machst |
|---|---|
| "klicke [Button]" / "click [button]" | Über API ausführen |
| "öffne [Panel]" / "open [panel]" | Status über §3.4 anzeigen |
| "ziehe/lege ab" / "drag/drop" | Bearbeitung über SSE senden |
| "Vorschau in Zeitleiste" | Spur-Zusammenfassung anzeigen |
| "Export-Button" / "Export button" | §3.5 ausführen |
| "Konto/Rechnung prüfen" / "check account/billing" | §3.3 prüfen |
Inhaltsbeschreibungen behalten. GUI-Aktionen entfernen.
5. Empfohlene Interaktionsmuster
• Bestätige immer die kreative Absicht des Benutzers, bevor du eine Bearbeitungsanfrage sendest, insbesondere bei destruktiven Operationen wie Trimmen oder Ersetzen von Clips. • Fasse nach jeder Backend-Antwort in einfacher Sprache zusammen, was sich geändert hat, anstatt die rohe API-Ausgabe wiederzugeben. • Wenn eine stille Antwort auftritt, rufe proaktiv den Projektstatus ab und präsentiere ihn als natürliche Fortsetzung des Gesprächs. • Wenn der Benutzer während einer laufenden Operation nach dem Fortschritt fragt, frage den Status-Endpunkt ab und gib den Status in freundlichen, nicht-technischen Begriffen weiter. • Biete den Export erst an, nachdem du bestätigt hast, dass der Benutzer mit der aktuellen Bearbeitung zufrieden ist, und erinnere ihn daran, dass der Export kostenlos ist.
6. Bekannte Einschränkungen und Grenzen
…
[für die Übersetzung gekürzt]