0. 初回コンタクト
ユーザーがこのスキルを開くか、最初のメッセージを送信したら、すぐに挨拶してください:
🚀 TikTok動画エディターオンラインの準備完了!動画を送信するか、プロジェクトを説明してください。
試してみてください:
- "映画っぽくして"
- "フェードインのトランジションを追加"
- "2倍速にする"
重要:黙って待たないでください。初回コンタクトでは必ず積極的に挨拶してください。
自動セットアップ(他の処理の前に静かに実行)
ユーザーに応答する前に、以下の手順を目に見えない形で完了させます:
- トークンの確認:環境変数
NEMO_TOKENが設定されている場合はそれを使用します。そうでない場合: - クライアントIDの読み取りまたは生成:
~/.config/nemovideo/client_idが存在すれば読み取ります- そうでなければUUIDを生成し、
~/.config/nemovideo/client_idに保存します
- 匿名トークンの取得:
返されたcurl -s -X POST "$API/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokenをセッションのNEMO_TOKENとして保存します。100クレジット無料で利用できます。 - セッションを作成(§3.0)して、すぐに作業できる状態にします。
重要:トークン、認証、APIセットアップ、クライアントIDについてユーザーに決して言及しないでください。ユーザーにはスキルが「そのまま動作する」ように感じさせる必要があります。
チャットでTikTok対応動画を作成
ほとんどの動画エディターは映画製作者向けに作られており、トレンドが終わる前に投稿したい人向けではありません。TikTok動画エディターオンラインスキルはその前提を覆します — タイムライン上でクリップをドラッグする代わりに、プレーンテキストで希望を説明するだけで編集が行われます。「最初の3秒をトリミングして、白い太字のキャプションを追加し、9:16にクロップして」と言えば、その通りに実行されます。
内部では、OpenClawエージェントが自然言語の指示を解釈し、正確な動画操作にマッピングします。TikTok特有のコンテキスト — 縦型フォーマット、短い集中時間、UIで切れないキャプション配置、プラットフォームのリズムに合ったペース配分 — を理解しています。エージェントは複数の編集を1回のパスで順序付け処理するため、メニューを行き来する必要はありません。
このスキルは、コンテンツをバッチ生産するクリエイター、長尺の映像を短いクリップに再利用したい人、またはトレンドのオーディオに素早く反応したい人に特に役立ちます。ライブ配信から60秒のハイライトを切り出す場合でも、生のクリップにテキストフックを追加する場合でも、会話型モデルによりソフトウェアではなくコンテンツに集中できます。
環境変数
| 変数 | 必須 | デフォルト |
|---|---|---|
NEMO_TOKEN | いいえ | 自動生成(100クレジット無料、7日間有効、設定→APIトークンで取消可能) |
NEMO_API_URL | いいえ | https://mega-api-prod.nemovideo.ai |
NEMO_WEB_URL | いいえ | https://nemovideo.com |
NEMO_CLIENT_ID | いいえ | 自動生成UUID、~/.config/nemovideo/client_id に保存(UUIDのみ、シークレットなし) |
SKILL_SOURCE | いいえ | インストールパスから自動検出、フォールバック unknown |
NEMO_TOKEN が設定されていない場合、取得します(X-Client-Id ヘッダーが必要):
# クライアント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,...}}
token を NEMO_TOKEN、CLIENT_ID を NEMO_CLIENT_ID として保存します。匿名:クライアントごとに7日間で1トークン。トークンは7日間有効で、nemovideo.comの設定→APIトークンからいつでも取り消し可能です。トークンが期限切れになった場合、同じ X-Client-Id で新しいトークンをリクエストしてください。
ローカル永続化: このスキルは ~/.config/nemovideo/client_id に書き込んで、セッション間でクライアントIDを永続化します。これにより、リクエストごとに新しいIDを生成することを避け、IPごとのレート制限(デフォルトでIPあたり7日間に10トークン)にすぐに達するのを防ぎます。ファイルにはUUIDのみが含まれ、認証情報はローカルに保存されません。
2. 受信リクエストを適切なエンドポイントにルーティング
以下の表を使用して、各タイプの受信リクエストを処理するAPIエンドポイントを決定します。
| ユーザーの発言... | アクション | SSEをスキップ? |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 エクスポート | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 クレジット | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 状態 | ✅ |
| "upload" / "上传" / ユーザーがファイルを送信 | → §3.2 アップロード | ✅ |
| その他すべて(生成、編集、BGM追加…) | → §3.1 SSE | ❌ |
3. 主要ワークフローの実装
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}、$TOKEN = ${NEMO_TOKEN}、$WEB = ${NEMO_WEB_URL:-https://nemovideo.com}。
スキル属性変数 — ハードコードしないこと:
$SKILL_NAME= このファイルのYAMLフロントマターのname$SKILL_VERSION= このファイルのYAMLフロントマターのversion$SKILL_SOURCE= 実行時に以下の最初の一致で検出:- 設定されている場合、環境変数
SKILL_SOURCE - このファイルのパスに既知のプラットフォームディレクトリが含まれる場合(例:
~/.clawhub/→clawhub、~/.cursor/skills/→cursor) - フォールバック:
unknown
- 設定されている場合、環境変数
重要:すべてのAPIリクエスト(レンダリング/エクスポート/アップロード/状態/クレジットを含む)にこれらのヘッダーを含める必要があります。これがないとエクスポートが402で失敗します。
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 新しいセッションの初期化
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":"..."}}
編集アクションを実行する前に、バックエンドとのセッションを確立する必要があります。同じ編集コンテキスト内の後続のすべてのリクエストは、このステップで返されたセッション識別子を参照する必要があります。
ブラウザで開く:セッション作成後、ユーザーにNemoVideoでタスクを表示/編集するためのリンクを提供します:
$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 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>"}]}}'
編集バックエンドへのすべての会話メッセージは、Server-Sent Events(SSE)を介して送信され、利用可能になり次第、応答を段階的にストリーミング返却します。
SSE処理
| イベント | アクション |
|---|---|
| テキスト応答 | GUI変換を適用(§4)、ユーザーに提示 |
| ツール呼び出し/結果 | 黙って待つ、転送しない |
heartbeat / 空の data: | 待機を続ける。2分ごとに「⏳ まだ処理中…」 |
| ストリームが閉じる | 最終応答を処理 |
標準的な所要時間:テキスト5〜15秒、動画生成100〜300秒、編集10〜30秒。
タイムアウト:10分間ハートビートのみ → タイムアウトと想定。生成中は決して再送信しない(重複+二重課金)。
「一時的な問題が発生しました」という最後のメッセージは、以前の応答が正常だった場合は無視します。
サイレントレスポンスフォールバック(重要)
編集操作の約30%は、SSEストリームにテキストを返さずに完了します。ストリームが閉じた後にテキストコンテンツが受信されなかった場合、これをエラーとして扱ったり、ユーザーに再試行を促したりしないでください。代わりに、すぐに状態クエリエンドポイントを呼び出して現在のプロジェクトステータスを確認し、結果の状態をユーザーに提示して、そこから会話を続けます。
二段階生成:バックエンドで生の動画が生成されると、ユーザー入力なしで自動的に第2段階がトリガーされます — システムは出力を確定する前に、BGMとタイトルオーバーレイを追加します。統合では両方の段階を考慮する必要があります。まず生の動画イベントを待ち、次にエンリッチメント段階が完了するのを待ってから、最終結果をユーザーに提示します。
3.2 アセットアップロードの処理
ファイルアップロード: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アップロード: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"}'
パスには me を使用します。バックエンドがトークンからユーザーを解決します。
対応フォーマット: mp4、mov、avi、webm、mkv、jpg、png、gif、webp、mp3、wav、m4a、aac。
アップロードエンドポイントは、ユーザーが編集プロジェクトに組み込みたいメディアファイルを受け入れます。
3.3 利用可能なクレジットの確認
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}}
クレジットを消費する操作を開始する前に、クレジットエンドポイントにクエリを実行してユーザーの現在の残高を取得します。
3.4 現在のプロジェクト状態の取得
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"
パスには me を使用します。バックエンドがトークンからユーザーを解決します。
主要フィールド:data.state.draft、data.state.video_infos、data.state.canvas_config、data.state.generated_media。
ドラフトフィールドマッピング:t=トラック、tt=トラックタイプ(0=ビデオ、1=オーディオ、7=テキスト)、sg=セグメント、d=期間(ミリ秒)、m=メタデータ。
エクスポート可能なドラフト:draft.t が存在し、少なくとも1つのトラックに空でない sg がある場合。
トラックサマリー形式:
タイムライン(3トラック): 1. ビデオ:都市タイムラプス(0-10秒) 2. BGM:Lo-fi(0-10秒、35%) 3. タイトル:「Urban Dreams」(0-3秒)
3.5 エクスポートのトリガーと結果の配信
エクスポートにはクレジットはかかりません。 生成/編集のみがクレジットを消費します。
完成したプロジェクトのエクスポートは、ユーザーのクレジット残高から差し引かれません。エクスポートフローは次のように進みます:(a)セッション識別子でエクスポートエンドポイントを呼び出す、(b)エクスポートジョブのステータスをポーリングまたはリッスンする、(c)完了ステータスイベントを待つ、(d)応答ペイロードからダウンロードURLを抽出する、(e)URLを最終成果物としてユーザーに提示する。
b) 送信: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"}}'
注:sessionId はキャメルケースです(例外)。失敗した場合 → 新しい id で、1回再試行します。
c) ポーリング(30秒ごと、最大10回):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:pending → processing → completed / failed。ダウンロードURLは output.url。
d) output.url からダウンロードしてユーザーに送信。フォールバック:$API/api/render/proxy/<id>/download。
e) 動画を配信する際は、常にタスク詳細リンクも提供します:$WEB/workspace/claim?token=$TOKEN&task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
進捗メッセージ:開始「⏳ レンダリング中 約30秒」→「⏳ 50%」→「✅ 動画準備完了!」+ ファイル + タスク詳細リンク。
3.6 SSE切断からの復旧
SSE接続がストリーム完了前に切断された場合、以下の復旧手順に従います:(1)ストリームの接続クローズまたはエラーイベントで切断を検出します。(2)サーバーに過度の負荷をかけないよう、再接続を試みる前に短い間隔を待ちます。(3)同じセッション識別子を使用してSSE接続を再確立します。(4)状態クエリエンドポイントを呼び出して、切断前にどの程度の進捗があったかを確認します。(5)最後に確認された状態から会話を再開し、意味のあるコンテキストが失われた場合にのみユーザーに通知します。
4. バックエンドGUI参照のユーザー向け翻訳
バックエンドはグラフィカルインターフェースを中心に設計されており、応答でUI要素を参照することがあります — これらのGUI固有の指示を逐語的にユーザーに渡さないでください。代わりに、プレーンな会話言語に翻訳してください。
| バックエンドの発言 | あなたのアクション |
|---|---|
| "click [button]" / "点击" | API経由で実行 |
| "open [panel]" / "打开" | §3.4で状態を表示 |
| "drag/drop" / "拖拽" | SSEで編集を送信 |
| "preview in timeline" | トラックサマリーを表示 |
| "Export button" / "导出" | §3.5を実行 |
| "check account/billing" | §3.3を確認 |
保持する:コンテンツの説明。削除する:GUIアクション。
5. 推奨されるインタラクションパターン
• 編集リクエストを送信する前に、特にトリミングやクリップの置き換えなどの破壊的操作の場合は、必ずユーザーのクリエイティブな意図を確認してください。 • バックエンドからの応答後は、生のAPI出力をそのまま返すのではなく、何が変わったかを平易な言葉で要約してください。 • サイレントレスポンスが発生した場合は、積極的にプロジェクト状態を取得し、会話の自然な続きとして提示してください。 • 操作の途中でユーザーが進捗を尋ねた場合は、状態エンドポイントにクエリを実行し、フレンドリーな非技術的な言葉でステータスを伝えてください。 • ユーザーが現在の編集に満足していることを確認してからエクスポートを提案し、エクスポートが無料であることを思い出させてください。
6. 既知の制約と制限
...
[翻訳のため省略]