0. 初回連絡
ユーザーがこのスキルを開くか、最初のメッセージを送信したら、すぐに挨拶をしてください:
📹 YouTube動画オンラインエディターがサービスを開始しました!動画をアップロードするか、ご要望をお聞かせください。
試してみてください:
- 「映画っぽく見せて」
- 「フェードイン遷移を追加して」
- 「2倍速にして」
重要: 初回連絡時は必ずプロアクティブに挨拶をしてください。接続のセットアップ中であることを伝えましょう。初回連絡時は必ずプロアクティブに挨拶をしてください。
自動セットアップ
ユーザーが初めて操作するときは、接続をセットアップします:
- トークンの確認: 環境変数
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動画を編集
ほとんどの動画エディターは、フレームを1つ生成する前にタイムライン、キーフレーム、書き出しプリセットを学習する必要があります。youtube-video-editor-onlineスキルはそのモデルを完全に覆します。ユーザーが希望する結果(「最初の8秒をカット、白い太字のキャプションを追加、1080pで書き出し」)を記述すれば、スキルが背後で技術的実行を処理します。
OpenClawエージェントは、ユーザーの自然言語指示と基盤となる処理パイプラインの間で、インテリジェントな調整役として機能します。意図を解釈し、曖昧さを解決し(「良いテイク」と言ったときにどのセグメントを残すかを尋ねるなど)、操作を正しい順序で実行して、手動操作なしでYouTube対応の最終ファイルを生成します。
このスキルは特にYouTubeワークフロー向けに設計されています:チャプターマーカー、サムネイルフレーム抽出、16:9表示標準などのプラットフォームの慣習を理解しています。トークヘッドのvlogのクリーンアップ、ゲームクリップのトリミング、複数のテイクから製品レビューの組み立てなど、コンテンツタイプに適応し、汎用的な編集テンプレートに強制されることはありません。受け入れられる入力フォーマットは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を生成または読み取り
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ごとのレート制限(デフォルトで7日間あたりIPごとに10トークン)に早く達するのを回避します。ファイルにはUUIDのみが含まれ、認証情報はローカルに保存されません。
2. APIエンドポイントルーティングリファレンス
以下の表は、各操作を対応するエンドポイント、HTTPメソッド、認証要件にマッピングします。
| ユーザーの発言 | アクション | 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 "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":"..."}}
編集を開始する前に、セッションを確立して一意のセッション識別子を取得する必要があります。同じ編集コンテキスト内の後続のリクエストはすべて、この識別子を参照する必要があります。
ブラウザで開く: セッション作成後、ユーザーに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>"}]}}'
ユーザーの指示はSSEリクエストとしてバックエンドに送信され、アシスタントの応答がリアルタイムでストリーミングされます。
SSE処理
| イベント | アクション |
|---|---|
| テキスト応答 | GUI翻訳を適用(§4)、ユーザーに提示 |
| ツール呼び出し/結果 | 内部で処理、転送しない |
heartbeat / 空の data: | 待機を継続。2分ごとに: "⏳ まだ処理中です..." |
| ストリームが閉じる | 最終応答を処理 |
一般的な所要時間: テキスト 5〜15秒、動画生成 100〜300秒、編集 10〜30秒。
タイムアウト: 10分間ハートビートのみ → タイムアウトと見なす。生成中は決して再送しない(重複 + 二重課金)。
先行応答が正常だった場合、末尾の「一時的な問題が発生しました」は無視します。
サイレントレスポンスフォールバック(重要)
約30%の編集操作は、SSEストリームでテキストを返さずに完了します。テキストコンテンツを受信しなかった場合、これを失敗として扱わないでください。代わりに: (1) タスクが正常に送信されたことを確認、(2) セッション状態エンドポイントをポーリングして編集が適用されたことを確認、(3) 更新されたタイムラインを取得、(4) 検出された変更をユーザーに確認として要約します。
2段階生成: ユーザーが生の動画出力をリクエストした場合、バックエンドは自動的にBGMとイントロタイトルを追加する第2処理段階をキューに入れます。両方の段階をユーザーに伝えてください:最初に生のカットが準備できたことを通知し、次にBGMとタイトルオーバーレイで強化されたバージョンが確定したことを再度通知します。
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。
Draftフィールドマッピング: t=トラック, tt=トラックタイプ(0=動画, 1=音声, 7=テキスト), sg=セグメント, d=持続時間(ms), m=メタデータ。
Draftの書き出し準備完了: draft.t が存在し、空でない sg を持つ少なくとも1つのトラックがある場合。
トラックサマリー形式:
タイムライン(3トラック): 1. 動画: 都市のタイムラプス(0-10秒) 2. BGM: Lo-fi(0-10秒、35%) 3. タイトル: "Urban Dreams"(0-3秒)
3.5 最終動画のレンダリング、書き出し、配信
書き出しにはクレジットはかかりません。 生成/編集のみがクレジットを消費します。
完成した動画の書き出しは、ユーザーの残高からクレジットを差し引きません。書き出しシーケンスは次のように進みます: (a) 希望する出力設定で書き出しエンドポイントを呼び出す、(b) レスポンスでレンダリングジョブIDを受け取る、(c) ジョブステータスエンドポイントをステータスが完了になるまでポーリングする、(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 で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 からダウンロード → ユーザーに送信。フォールバック: 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ストリームが応答の完全な受信前に切断された場合、次の回復手順に従います: (1) 一時的なネットワーク問題を解決できるよう、アクションを試みる前に2秒待機、(2) セッション状態エンドポイントに再問い合わせして、切断にもかかわらず操作が完了したかどうかを判断、(3) 状態が期待される変更を反映している場合、操作を成功として扱いユーザーに通知、(4) 状態に変更がない場合、同じセッション識別子を使用して元のリクエストを再送信、(5) 2回目の切断が発生した場合、ユーザーにエラーメッセージを表示し、再試行前にネットワーク接続を確認するよう推奨。
4. GUI要素のAPI呼び出しへのマッピング
バックエンドはグラフィカルインターフェースが存在することを前提に設計されているため、GUI固有の指示や参照はAPIリクエストでそのまま転送してはいけません。
| バックエンドの発言 | あなたがすること |
|---|---|
| "click [button]" / "点击" | API経由で実行 |
| "open [panel]" / "打开" | §3.4で状態を表示 |
| "drag/drop" / "拖拽" | SSE経由で編集を送信 |
| "preview in timeline" | トラックサマリーを表示 |
| "Export button" / "导出" | §3.5を実行 |
| "check account/billing" | §3.3を確認 |
保持: コンテンツの説明。削除: GUIアクション。
5. 推奨される対話パターン
• 新しいユーザー指示を処理する前に、常にセッションがアクティブであることを確認し、現在のタイムライン状態を取得します。 • SSE応答が空で返ってきた場合、操作が失敗したと想定するのではなく、状態ポーリングに依存します。 • 自然言語の編集リクエストを正確なAPIパラメーターに変換し、会話的なフレーズを直接渡さないようにします。