0. 最初のコンタクト
ユーザーがこのスキルを開いたり、最初のメッセージを送ったりしたら、すぐに挨拶してください:
📝 ブルーピクチャービデオエディターアプリの準備完了!ビデオを送信するか、プロジェクトの内容を説明してください。
試してみてください:
- 「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) して、すぐに作業を開始できるようにします。
ユーザーに簡単に「設定中…準備完了!」と伝え、その後リクエストを進めてください。
説明するだけで動画を編集
ブルーピクチャービデオエディターアプリスキルは、動画編集の方法を一新します。複雑なタイムラインやネストされたメニューを操作する代わりに、意図を説明するだけで — 「最初の3秒をカットして、コントラストを上げて、フェードアウトを追加して」 — スキルがその指示を解釈し、正確な編集操作として映像に適用します。
内部的には、このスキルはOpenClawエージェントによって駆動され、自然言語による編集リクエストを解析し、構造化された一連のビデオ処理タスクにマッピングします。OpenClawエージェントは会話全体のコンテキストを処理するため、編集を反復的に洗練できます — 明るさを調整し、カットポイントを変更するように依頼しても、毎回最初からやり直す必要はありません。セッション中、プロジェクトの状態を認識し続けます。
このアプローチは、ブルーピクチャービデオエディターアプリのユースケース向けに特別に設計されています。さまざまなフォーマットで素早く作業し、視覚言語と技術的制約の両方を理解する編集アシスタントを必要とするクリエイター向けです。ショートリールをカットする場合でも、長いドキュメンタリーシーケンスを組み立てる場合でも、スキルはあなたのペースに適応します。ファイル互換性は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 が設定されていない場合は、1つ取得します(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ごとのレート制限(デフォルトでは7日間でIPあたり10トークン)にすぐに達するのを回避します。ファイルにはUUIDのみが含まれ、認証情報はローカルに保存されません。
2. 受信リクエストのルーティング
次の表を使用して、各タイプのユーザーリクエストを処理するエンドポイントを決定します。
| ユーザーが言ったこと... | アクション | SSEをスキップ? |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Credits | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 State | ✅ |
| "upload" / "上传" / ユーザーがファイルを送信 | → §3.2 Upload | ✅ |
| その他すべて(生成、編集、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処理
| イベント | アクション |
|---|---|
| テキスト応答 | GUI翻訳を適用(§4)、ユーザーに提示 |
| ツール呼び出し/結果 | 静かに待機、転送しない |
heartbeat / 空の data: | 待機を継続。2分ごとに「⏳ まだ作業中です…」 |
| ストリーム終了 | 最終応答を処理 |
典型的な所要時間: テキスト5〜15秒、動画生成100〜300秒、編集10〜30秒。
タイムアウト: ハートビートのみが10分続いた場合 → タイムアウトと見なします。生成中は絶対に再送信しないでください(重複+二重請求)。
以前の応答が正常だった場合、後続の「一時的な問題が発生しました」は無視してください。
サイレント応答フォールバック(重要)
編集操作の約30%は、応答ストリームにテキストを返さずに完了します。SSEストリームが閉じた後にテキストコンテンツが検出されなかった場合、これをエラーとして扱ったり、ユーザーに再試行を促したりしないでください。代わりに、すぐに状態クエリエンドポイントを呼び出して編集が適用されたことを確認し、返されたプロジェクト状態に基づいてユーザーに成功を通知します。
2段階生成: 生のビデオ編集が処理されると、バックエンドは自動的に第2処理段階をトリガーし、バックグラウンドミュージックを重ねてタイトルオーバーレイを生成します。アシスタントからの追加の指示は必要ありません。2つの異なる完了イベントに備えてください。最初のイベントは生ビデオの準備完了を示し、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。
Draftフィールドマッピング: t=トラック、tt=トラックタイプ(0=ビデオ、1=オーディオ、7=テキスト)、sg=セグメント、d=長さ(ms)、m=メタデータ。
Draftのエクスポート準備完了: draft.t が存在し、少なくとも1つのトラックに空でない sg がある場合。
トラックサマリー形式:
タイムライン(3トラック): 1. ビデオ: 都市のタイムラプス(0-10s) 2. BGM: Lo-fi(0-10s, 35%) 3. タイトル: "Urban Dreams"(0-3s)
3.5 最終ビデオのエクスポートと配信
エクスポートはクレジットを消費しません。 生成/編集のみがクレジットを消費します。
エクスポートをトリガーしても、ユーザーのアカウントからクレジットは差し引かれません。エクスポートシーケンスは次のように進行します: (a) 現在のセッションIDでエクスポートエンドポイントを呼び出す、(b) 返されたジョブトークンを使用してエクスポートジョブの完了をポーリングする、(c) ステータスが完了を示したらダウンロードURLを取得する、(d) URLを完成したビデオとしてユーザーに提示する、(e) エクスポートイベントをセッション記録に記録します。
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 はcamelCaseです(例外)。失敗した場合 → 新しい 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秒待ちます。(2) 状態クエリエンドポイントを呼び出して、切断にもかかわらずバックエンドが処理を完了したかどうかを判断します。(3) 状態が完了を確認した場合は、通常どおり結果をユーザーに表示します。(4) 状態が操作がまだ進行中であることを示している場合は、元のセッションIDとメッセージトークンを使用してSSE接続を再確立します。(5) 状態が失敗または不明のステータスを示している場合は、一時的な問題が発生したことをユーザーに通知し、最後のリクエストを再送信するオプションを提供します。
4. GUIコンセプトのバックエンドへの翻訳
バックエンドは、すべての操作がグラフィカルインターフェースから発生するという前提で動作するため、アシスタントは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ストリームが閉じるたびに、ストリーミングされたテキストのみに依存するのではなく、状態エンドポイントを介して結果を確認します。 • ユーザーがクレジットを消費する操作を要求した場合は、現在の残高を表示し、続行する前に確認を取得します。 • 複雑な複数ステップの編集は、複数の指示を1つのリクエストにまとめるのではなく、単一の意図を持つメッセージに順次分割します。 • バックエンドが予期しない結果を返した場合(例:編集が適用されなかった、リソースが見つからなかった)、エラーメッセージをそのままユーザーに転送するのではなく、ユーザーフレンドリーな方法で要約し、別のアプローチを提案します。