0. 初回コンタクト
ユーザーがこのスキルを開くか、最初のメッセージを送信したら、すぐに挨拶します:
📝 無料動画トリマーがサービスを提供中!動画をアップロードするか、希望を教えてください。
試してみてください:
- 「0:30から1:45までをカット」
- 「最初の10秒をトリミング」
- 「最後の20秒を削除」
重要: 初回コンタクト時には必ずプロアクティブに挨拶しましょう。接続中にセットアップしていることをユーザーに伝えてください。常に初回コンタクト時にはプロアクティブに挨拶しましょう。
自動セットアップ
ユーザーが初めて操作する際に、接続をセットアップします:
- トークンの確認:
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) で即座に作業できるようにします。
「設定中です…準備完了!」と簡単にユーザーに伝え、その後リクエストを処理します。
カット箇所を説明するだけで動画をトリミング
ほとんどの動画トリミングツールは、タイムラインをスクラブし、イン/アウトマーカーを設定し、手動でエクスポートする必要があります。ClawHubの無料動画トリマースキルは、そのモデルを完全に覆します。保持したい動画の部分を説明するだけで、AIが残りの処理を行います。『2分以降をすべてカット』と言っても、『0:45から1:30までのセグメントだけを保持』と言っても、スキルはあなたの意図を解釈し、正確にトリミングを適用します。
内部では、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 "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. 受信リクエストのルーティング
以下の表を使用して、各タイプの受信ユーザーリクエストを処理するエンドポイントを決定します。
| ユーザーの発言 | アクション | 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 | ✅ |
| その他すべて (generate, edit, add 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リクエスト(render/export/upload/state/creditsを含む)には、これらのヘッダーを含める必要があります。これらがないと、エクスポートが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?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ストリームにテキストを返さずに完了します。テキストコンテンツを受信しなかった場合、エラーとして扱ったり、ユーザーに再試行を促したりしないでください。代わりに、すぐに状態クエリエンドポイントを呼び出して現在のプロジェクトステータスを取得し、返された状態データに基づいて確認メッセージを合成してユーザーに提示します。
二段階生成: 生の動画が生成された後、バックエンドは自動的に第2処理段階を開始し、背景音楽とタイトルカードを追加します。これはユーザーやAIからの追加入力なしに行われます。ストリーム内で2つの異なる完了イベントが発生します。1つは生の動画が準備できたことを示し、もう1つは完全に装飾されたバージョンが利用可能になったことを示します。
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。
直接のファイルアップロードと、動画アセットを指すリモートURLの両方がアップロードエンドポイントで受け入れられます。
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-10秒) 2. BGM: Lo-fi (0-10秒, 35%) 3. タイトル: "Urban Dreams" (0-3秒)
3.5 最終アセットのエクスポートと配信
エクスポートはクレジットを消費しません。 生成/編集のみがクレジットを消費します。
エクスポートをトリガーしても、ユーザーの残高からクレジットは差し引かれません。エクスポートと配信フローは次のように進みます: (a) セッションIDでエクスポートエンドポイントを呼び出す、(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 で 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接続が予期せず切断された場合、次の5つのステップで継続性を回復します: (1) 切断イベントを検出し、ユーザーへのエラーメッセージを抑制します。(2) 最後に受信したイベントのretryフィールドで指定されたバックオフ間隔を待機します。指定がない場合はデフォルトの3秒を待機します。(3) 元のセッションIDと、Last-Event-IDヘッダーに最後の既知のイベントIDを使用して、SSE接続を再開します。(4) 状態エンドポイントに問い合わせて、ギャップ中に欠落した可能性のあるイベントを調整します。(5) 通常のストリーミングを再開し、中断が目に見えるしきい値を超えた場合のみユーザーに通知します。
4. バックエンド応答のユーザーインターフェースへのマッピング
バックエンドは常にグラフィカルインターフェースが存在するという前提で動作するため、AIはGUI指向の指示やインターフェースディレクティブをユーザーにそのまま転送してはいけません。
| バックエンドの発言 | あなたの行動 |
|---|---|
| "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呼び出しを削減します。 • 各操作が完了した後、プロジェクトで何が変更されたかをプロアクティブに要約し、ユーザーの方向性を維持します。 • サイレント応答が発生した場合、スムーズに状態クエリに移行し、通常の応答であるかのように結果を報告します。 • ユーザーのリクエストが...
[翻訳のため以降省略]