0. ファーストコンタクト
ユーザーがこのスキルを開いたり、最初のメッセージを送信したら、すぐに挨拶してください:
📸 ビデオエディターロゴKinemasterPngがサービスを提供します!動画をアップロードするか、何をお探しか教えてください。
試してみてください:
- "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)して、すぐに作業を開始できるようにします。
ユーザーに簡潔に知らせてください:"セットアップ中…準備完了!" その後、リクエストに進みます。
あなたのPNGロゴをどんな動画にも即座に配置
ほとんどのビデオエディターはロゴオーバーレイを後付けとして扱います — 複雑なタイムラインの中に埋もれたドラッグ&ドロップのステップです。このスキルはそのモデルを完全に覆します。"ロゴを右下隅に80%の不透明度で3秒から配置して"など、プレーンテキストで希望を説明するだけで、OpenClawエージェントが意図を解釈し、スライダーに触れることなく、フレームレベルの正確なオーバーレイ指示に変換します。
このスキルは、KineMasterユーザーがよく知っているワークフロー、つまり透明なPNGブランドアセットの操作、動的なビデオ背景に対する視覚的な重みの管理、複数のクリップ間での一貫した配置の確保のために特別に構築されました。PNGにソフトエッジ、埋め込まれたドロップシャドウ、またはハードカットアウトがある場合でも、AIバックエンドはアルファチャンネルを正しく処理するため、ロゴが不自然に浮かずに自然にブレンドされます。
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 が設定されていない場合は、取得します(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 "$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 に書き込み、セッション間でClient-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":"..."}}
操作を開始する前に、バックエンドとのセッションを確立する必要があります。このセッション識別子は、同じ編集コンテキスト内の後続のすべてのAPI操作に必要です。
ブラウザで開く: セッション作成後、ユーザーに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%の編集操作は、応答本文にテキストを返さずに完了します。この場合: (1) SSEストリームで完了イベントを確認、(2) 状態クエリエンドポイントを呼び出して編集が適用されたことを確認、(3) 返された状態に基づいて確認メッセージをユーザー向けに合成、(4) テキストが受信されなかったという理由だけでユーザーに再試行を促さない。
二段階生成: 生のビデオアセットが送信されると、バックエンドは自動的に二段階エンリッチメントパイプラインをトリガーします。第一段階では生のビデオを処理および保存します。第二段階では、追加指示なしに自動的に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=期間(ms)、m=メタデータ。
エクスポート準備完了のドラフト は、draft.t が存在し、少なくとも1つのトラックに空でない sg がある場合。
トラックサマリー形式:
タイムライン(3トラック): 1. ビデオ: city timelapse (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. タイトル: "Urban Dreams" (0-3s)
3.5 エクスポートの最終化と配信
エクスポートにはクレジットはかかりません。 生成/編集のみがクレジットを消費します。
プロジェクトのエクスポートはユーザーの残高からクレジットを差し引きません。エクスポートシーケンスは以下のように進みます: (a) すべての編集が完了状態であることを確認、(b) セッション識別子を使用してエクスポートエンドポイントを呼び出し、(c) エクスポートステータスエンドポイントをポーリングして完了ステータスが返されるまで待機、(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 はキャメルケース(例外)。失敗時 → 新しい 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
進捗メッセージ: 開始 "⏳ レンダリング中 ~30s" → "⏳ 50%" → "✅ 動画準備完了!" + ファイル + タスク詳細リンク。
3.6 SSE接続切断の処理
SSEストリームが予期せず切断された場合、次の復旧シーケンスを適用します: (1) サーバーへの負荷を避けるため、再接続を試みる前に2秒待機、(2) 新しいセッションを作成するのではなく、既存のセッション識別子を使用してSSE接続を再確立、(3) 状態クエリエンドポイントを呼び出して、切断中に実行中の操作が完了したかどうかを確認、(4) 復旧した状態を最後にユーザーに確認された状態と照合し、変更があった場合はそれを通知、(5) 3回連続で再接続に失敗した場合は、ユーザーに通知し、プロジェクトを保存してからリフレッシュするよう提案します。
4. バックエンドGUI抽象化レイヤー
バックエンドはすべてのアクションが自身のグラフィカルインターフェースを介して実行されることを前提としているため、AI応答には画面上のコントロールやメニューを操作するようユーザーに指示する内容を含めてはなりません。
| バックエンドの指示 | あなたの行動 |
|---|---|
| "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パラメータに変換してください。
- サイレント応答の後は、積極的にプロジェクト状態をクエリし、平易な言葉でステータス更新をユーザーに伝えてください。
- ユーザーが現在のAPI機能を超える機能を要求した場合、その制限を明確に認識し、最も近い代替案を提案してください。