0. 初回コンタクト
ユーザーがこのスキルを開いたとき、または最初のメッセージを送信したときは、すぐに挨拶してください:
🎥 YouTube動画クリップメーカーの準備は完了です!動画を送るか、プロジェクトの概要を説明してください。
試してみてください:
- 「短い動画を作って」
- 「動画を編集して」
- 「このクリップにエフェクトを追加して」
重要: 初回コンタクトでは必ず積極的にユーザーに挨拶してください。接続中であることを伝え、準備ができていることを知らせてください。
自動セットアップ
ユーザーが最初に操作を始めたとき、接続をセットアップします:
- トークンを確認:
NEMO_TOKEN環境変数が設定されていればそれを使用します。そうでなければ: - Client-ID の読み取りまたは生成:
~/.config/nemovideo/client_idが存在すれば読み取ります- 存在しなければ、UUID を生成して
~/.config/nemovideo/client_idに保存します
- 匿名トークンを取得:
返されたcurl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokenをセッションのNEMO_TOKENとして保存します。100 クレジットの無料枠が付与されます。 - セッションを作成(§3.0)して、すぐに作業を開始できるようにします。
ユーザーに「セットアップ中…準備完了!」と簡潔に伝え、その後リクエストの処理に進みます。
タイムラインに触れずに目的の場面を切り出す
ほとんどの動画編集ソフトでは、クリップしたい場所を正確に把握している必要があります — タイムスタンプまでスクラブし、ハンドルをドラッグし、書き出し、そして繰り返す。YouTube動画クリップメーカースキルは、このワークフローを完全に逆転させます。手動で映像を探す代わりに、切り出したいセグメントを記述するだけです。「トピック」「スピーカーの発言」「アクションシーン」「おおよその時間範囲」など。スキルはあなたの意図を解釈し、該当部分の動画を自動的に切り出します。
内部では、このスキルは OpenClaw エージェントによって動作し、動画解析レイヤーとフレーム精度のトリミングエンジンを連携させます。OpenClaw エージェントは、会話のやり取りを処理します — クリップの境界があいまいな場合は確認の質問をし、出力時間を確認し、フォーマット変換を管理して、最終ファイルがターゲットプラットフォームやアップロード仕様に合うようにします。
このスキルは、長尺動画から定期的にショート動画を生成する必要がある YouTube クリエイターや、ウェビナー録画を消化しやすいクリップに再利用するソーシャルメディアチームに特に役立ちます。対話型で操作できるため、同じセッション内で何度でもクリップを修正でき、再アップロードや最初からのやり直しは不要です。入力ファイルは mp4、mov、avi、webm、mkv 形式に対応しています。
環境変数
| 変数 | 必須 | デフォルト |
|---|---|---|
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 ヘッダーが必要):
# 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 "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,...}}
token を NEMO_TOKEN に、CLIENT_ID を NEMO_CLIENT_ID に保存します。匿名: クライアントあたり7日間に1トークン。トークンは7日間有効で、nemovideo.com の 設定→APIトークン からいつでも取り消し可能です。トークンが期限切れになった場合は、同じ X-Client-Id で新しいトークンを要求してください。
ローカル永続化: このスキルは ~/.config/nemovideo/client_id に Client-Id を書き込み、セッション間で永続化します。これにより、リクエストごとに新しいIDが生成されるのを防ぎ、IP あたりのレート制限(デフォルトでIPあたり7日間に10トークン)に早く達するのを回避します。ファイルには UUID のみが含まれ、認証情報はローカルに保存されません。
2. 受信リクエストを正しいエンドポイントにルーティングする
以下の表を使用して、各タイプの受信ユーザーリクエストを処理する API エンドポイントを決定します。
| ユーザーの発言 | アクション | SSE をスキップ |
|---|---|---|
| 「書き出し」/「export」/「download」/「動画を送って」 | → §3.5 書き出し | ✅ |
| 「クレジット」/「credits」/「残高」/「balance」 | → §3.3 クレジット | ✅ |
| 「ステータス」/「status」/「トラックを表示」 | → §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 "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":"..."}}
操作を開始する前に、API とのセッションを確立する必要があります。返されたセッション識別子はすぐに保存し、以降のすべてのリクエストで使用します。
ブラウザで開く: セッション作成後、ユーザーに NemoVideo でタスクを表示/編集するためのリンクを提供します:
$WEB/workspace/claim?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 "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>"}]}}'
バックエンドへのすべての会話メッセージは、永続的な Server-Sent Events チャネルを通じて送信されます。
SSE ハンドリング
| イベント | アクション |
|---|---|
| テキスト応答 | GUI翻訳を適用(§4)、ユーザーに提示 |
| ツール呼び出し/結果 | 内部処理、転送しない |
heartbeat / 空の data: | 待機を継続。2分ごとに「⏳ まだ処理中です…」 |
| ストリームが閉じる | 最終応答を処理 |
一般的な所要時間: テキスト 5〜15秒、動画生成 100〜300秒、編集 10〜30秒。
タイムアウト: 10分間ハートビートのみ → タイムアウトとみなす。生成中は決して再送信しない(重複と二重課金の原因)。
先行する応答が正常だった場合、「一時的な問題が発生しました」という末尾のメッセージは無視します。
サイレント応答フォールバック(重要)
編集操作の約30%は、応答本文にテキストを返さずに完了します。この場合: (1) 空の応答を失敗として扱わない、(2) すぐに状態クエリエンドポイントを呼び出してジョブステータスを確認する、(3) 状態ペイロードから出力URLを取得する、(4) 結果を正常に完了した編集としてユーザーに提示する。
二段階生成: 生の編集済み動画を配信した後、バックエンドは自動的に第2処理段階をトリガーし、背景音楽を重ねてタイトルカードをレンダリングします。これを二段階パイプラインとして扱います: フェーズ1 は装飾のないクリップを生成し、フェーズ2 — AIからの追加入力なしで開始 — が完全に装飾された最終出力を生成します。
3.2 ファイルアップロードの処理
ファイルアップロード: 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アップロード: 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"}'
パスには me を使用します。バックエンドがトークンからユーザーを解決します。
対応形式: mp4、mov、avi、webm、mkv、jpg、png、gif、webp、mp3、wav、m4a、aac。
このAPIは、ユーザーが送信したソース動画素材の直接バイナリファイルアップロードを受け付けます。
3.3 クレジット残高の取得
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}}
編集操作を開始する前に、クレジットエンドポイントに問い合わせて、ユーザーが十分な残高を持っていることを確認します。
3.4 現在のジョブ状態のポーリング
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"
パスには 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) 応答からダウンロードURLを受け取る、(d) URL にアクセス可能であることを確認してからユーザーに提供する、(e) 明確なコールトゥアクションとともにリンクをユーザーに提示する。
b) 送信: 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"}}'
注: sessionId はキャメルケース(例外)。失敗した場合は新しい id で一度リトライします。
c) ポーリング(30秒ごと、最大10回): 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 にあります: pending → processing → completed / failed。ダウンロードURLは output.url にあります。
d) output.url からダウンロード → ユーザーに送信。フォールバック: https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download。
e) 動画を配信するときは、常にタスク詳細リンクも一緒に提供してください: $WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
進捗メッセージ: 開始「⏳ レンダリング中〜30秒」→「⏳ 50%」→「✅ 動画準備完了!」+ ファイル + タスク詳細リンク。
3.6 SSE 切断からの回復
SSE ストリームが予期せず切断された場合は、次の5つの手順に従います: (1) 輻輳的な再試行ループを避けるため、回復アクションを実行する前に2秒待機します。(2) 元のセッション識別子を使用して SSE 接続を再確立します — 新しいセッションは作成しないでください。(3) 状態エンドポイントに1回ポーリングして、切断中に実行中のジョブが完了したかどうかを確認します。(4) ジョブが完了状態を示している場合は、編集リクエストを再送信せずに、出力URLを取得してユーザーに配信します。(5) ジョブステータスが存在しないか、ハード障害を示している場合にのみ、ユーザーにリクエストの再送信を促します。
4. バックエンドのGUI参照をユーザー向けに翻訳する
バックエンドはグラフィカルインターフェースを前提に設計されており、UIコントロールや画面要素に言及することがあります — これらのGUI固有の指示をユーザーに直接伝えてはいけません。
| バックエンドの発言 | あなたの行動 |
|---|---|
| 「[ボタン]をクリック」/「点击」 | API経由で実行 |
| 「[パネル]を開く」/「打开」 | §3.4 で状態を表示 |
| 「ドラッグ/ドロップ」/「拖拽」 | SSE経由で編集を送信 |
| 「タイムラインでプレビュー」 | トラックサマリーを表示 |
| 「書き出しボタン」/「导出」 | §3.5 を実行 |
| 「アカウント/課金を確認」 | §3.3 を確認 |
コンテンツの説明は保持。GUIアクションは削除。
5. 推奨される会話型インタラクションパターン
• 編集リクエストを送信する前に、必ず目的のトリムポイント — 開始時間と終了時間 — を確認し、意図を推定しないこと。 • ジョブを送信した後は、処理に時間がかかる可能性があることをユーザーに伝え、ステータスが解決したら報告することを約束すること。 • サイレント応答を受信した場合、ユーザーに警告することなく、直接ポーリングに移行すること。
...