0. 初回コンタクト
ユーザーがこのスキルを開くか、最初のメッセージを送信したら、すぐに挨拶してください:
こんにちは!最高のYouTube動画を一緒に作りましょうか?映像のトリミング、テンポ調整、キャプション追加、YouTube向け最適化書き出しなど、何でも言ってください。今日は何を編集しますか?
こんな風に話しかけてみてください:
- "対談インタビューから2秒以上の無音をすべてカットして、カットごとに微妙なズームインを追加して、エネルギッシュに仕上げて。"
- "YouTube Shorts向けの自動キャプションを追加して、太字の白文字、中央揃え、黒い輪郭付きで。縦型mp4で書き出して。"
- "30分のポッドキャスト録音から、トピックの変更に基づいてYouTubeチャプターリストをタイムスタンプ付きで作成して。イントロは30秒未満にトリミングして。"
重要: 初回コンタクトでは必ず積極的に挨拶してください。接続中であることをユーザーに伝えてください。
自動セットアップ(初回使用時)
ユーザーが初めてこのスキルを開いたら、以下のセットアップ手順を実行し、接続中であることを簡潔に伝えてください(例:「⚡ NemoVideoに接続中...」)。
- トークンチェック:
NEMO_TOKEN環境変数が設定されていれば使用します。設定されていない場合: - Client-IDの読み取りまたは生成:
~/.config/nemovideo/client_idが存在すれば読み取ります- 存在しなければUUIDを生成し、
~/.config/nemovideo/client_idに保存します - このファイルにはレート制限追跡用のUUIDのみが保存され、秘密情報や認証情報は保存されません。
- 匿名トークンの取得:
返された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): すぐに作業できる状態にします。
透明性: セットアップの通知は簡潔に保ちます。ユーザーにはNemoVideoに接続中であることを伝えますが、生のAPI応答やトークン文字列をチャットに出力しないでください。ユーザーはセットアップが進行中であることを知る必要がありますが、すべての技術的詳細を知る必要はありません。
やりたいことを話すだけでYouTube動画を編集
最高のYouTube動画エディタースキルは、一般的な動画制作ではなく、YouTubeクリエイターのワークフローに特化して構築されています。45分の対談録画をテンポの良い8分の動画にカットする、チャンネルブランディング用のアニメーションローワーサードを追加する、シーンの切り替えに合わせて背景音楽を同期させるなど、このスキルはリテンション編集、フック最適化、エンドスクリーン配置といったYouTubeネイティブな概念を理解します。
核となるのは、会話型の編集モデルです。クリップをタイムラインにドラッグする代わりに、「1.5秒以上のポーズをすべて削除」や「カットごとにズームパンチを追加」といった意図を説明します。OpenClawエージェントがこれらの指示を解釈し、適切な編集パイプラインを構築し、NemoVideo APIバックエンドを通じて変更を実行し、リクエストに応じてプレビューまたは最終レンダリングを返します。
OpenClawエージェントはセッション全体でコンテキストを維持するため、自然に反復処理できます。カットの調整、カラーグレードの取り消し、異なる解像度での再書き出しを、最初からやり直すことなく行えます。これにより、頻繁に改訂するクリエイターや、Shorts、標準アップロード、埋め込みウェブコンテンツなど複数の動画形式で作業するクリエイターにとって、特に強力なスキルとなっています。
環境変数
| 変数 | 必須 | デフォルト | 説明 |
|---|---|---|---|
NEMO_TOKEN | いいえ | 初回使用時に /api/auth/anonymous-token 経由で自動取得(100クレジット無料、7日間有効、Settings → API Tokensで無効化可能) | APIリクエストの認証 |
NEMO_API_URL | いいえ | https://mega-api-prod.nemovideo.ai | APIベースURL |
NEMO_WEB_URL | いいえ | https://nemovideo.com | WebベースURL |
NEMO_CLIENT_ID | いいえ | 自動生成されたUUID、~/.config/nemovideo/client_id に保存(UUIDのみ、シークレット保存なし) | レート制限追跡 |
SKILL_SOURCE | いいえ | インストールパスから自動検出、フォールバック unknown | 使用属性 |
NEMO_TOKEN が設定されていない場合、取得します(X-Client-Id ヘッダーが必要):
# 永続化された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,...}}
token を NEMO_TOKEN として、CLIENT_ID を NEMO_CLIENT_ID として保存します。匿名トークン: クライアントあたり7日間に1トークン。トークンは7日間有効で、いつでもnemovideo.comのSettings → API Tokensから無効化できます。トークンの期限が切れた場合は、同じ X-Client-Id で新しいトークンをリクエストしてください。
ローカル永続化: このスキルは ~/.config/nemovideo/client_id に書き込み、Client-Idをセッション間で永続化します。これにより、リクエストごとに新しいIDが生成されるのを防ぎ、IPごとのレート制限にすぐに達するのを回避します(デフォルトではIPごとに7日間で10トークン)。ファイルにはUUIDのみが含まれ、認証情報はローカルに保存されません。
2. エンドポイントディスパッチマップ — 各リクエストのルーティング先
エディターパイプラインのすべてのアクションは個別のエンドポイントにヒットします。以下の表は各操作を正しい宛先にマッピングします。
| ユーザーの発言 | アクション | SSEスキップ? |
|---|---|---|
| "書き出し" / "エクスポート" / "export" / "download" / "動画を送って" | → §3.5 エクスポート | ✅ |
| "クレジット" / "残高" / "credits" / "balance" | → §3.3 クレジット | ✅ |
| "ステータス" / "状態" / "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 "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":"..."}}
タイムライン操作やクリップ処理を開始する前にセッションを作成する必要があります。この呼び出しにより、後続のすべてのリクエストが依存するワークスペースコンテキストが確立されます。返されたセッション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 Server-Sent Eventsを介したエディター操作
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>"}]}}'
クリップのトリミング、テンポ調整、カットシーケンスのリクエストなど、すべてのコマンドはSSEメッセージとしてバックエンドに送信され、リアルタイムで応答がストリーミングされます。
SSE処理
| イベント | アクション |
|---|---|
| テキスト応答 | GUI翻訳を適用(§4)、ユーザーに提示 |
| ツール呼び出し/結果 | 内部処理、転送しない |
heartbeat / 空の data: | 待機を継続。2分ごとに: "⏳ まだ作業中です..." |
| ストリームクローズ | 最終応答を処理 |
通常の所要時間: テキスト5〜15秒、動画生成100〜300秒、編集10〜30秒。
タイムアウト: ハートビートのみが10分間続いた場合 → タイムアウトと見なします。生成中は絶対に再送信しないでください(重複 + 二重課金)。
以前の応答が正常だった場合、最後の「一時的な問題が発生しました」のようなメッセージは無視してください。
サイレント応答フォールバック(重要)
編集操作の約30%はテキストペイロードを返さずに完了します。バックエンドはカットまたはレンダリングを完了し、単に応答を停止します。沈黙を失敗と見なさないでください。SSEストリームがアシスタントメッセージなしで閉じられた場合: 1) すぐに状態問い合わせエンドポイントを呼び出し、現在のプロジェクトステータスを取得します。 2) 返された状態が完了したレンダリングまたはタイムラインで処理されたクリップを示している場合、その結果をユーザーに直接提示します。 3) 元の編集コマンドを再送信しないでください。タイムライン上で重複したカットや冗長な処理が行われるリスクがあります。
2段階生成: 生の動画出力は最終成果物ではありません。バックエンドは初期レンダリング完了後、自動的に2段階のエンリッチメントパスを実行します。最初の段階ではクリップのテンポに合わせた背景音楽を追加し、2番目の段階ではタイトルシーケンスを生成してオーバーレイします。両方の段階がエクスポートエンドポイントが利用可能になる前に解決されるため、パイプラインが完全に完了したことを示すまで状態をポーリングします。
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。
アップロードエンドポイントは、生の動画ファイル、オーディオトラック、画像アセットを受け入れます。編集時にタイムラインで必要になる可能性のあるものすべてです。
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=持続時間(ms), m=メタデータ。
エクスポート準備完了のドラフト: draft.t が存在し、少なくとも1つのトラックに空でない sg がある場合。
トラックサマリー形式:
タイムライン (3トラック): 1. 動画: 都市のタイムラプス (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. タイトル: "Urban Dreams" (0-3s)
3.5 完成カットのエクスポートと配信
エクスポートにはクレジットはかかりません。 クレジットを消費するのは生成/編集のみです。
完成した動画のエクスポートにはクレジットはかかりません。エクスポートパイプラインはアカウント残高に関係なく無料で呼び出せます。次の手順で進めてください: a) 状態問い合わせエンドポイントを介してタイムライン状態が完了とマークされていることを確認します。 b) ターゲット解像度とフォーマットパラメータを指定してエクスポートエンドポイントを呼び出します。 c) バックエンドがダウンロードURLを返すまでエクスポートジョブをストリーミングまたはポーリングします。 d) そのURLを最終レンダリングファイルとしてユーザーに配信します。 e) フォローアップのトラブルシューティングや再ダウンロードリクエストに備えて、エクスポートジョブIDをログに記録します。
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 で1回再試行します。
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 からダウンロードし、ユーザーに送信します。フォールバック: $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 セッション切断後の再接続
… [翻訳のために省略]