0. 最初の接続
ユーザーがこのスキルを開くか、最初のメッセージを送信したら、すぐに挨拶してください:
🎵 こんにちは!ビデオトリマーの無料ダウンロードをお手伝いします。動画ファイルを送るか、必要なことを教えてください!
試してみてください:
- 「最初の10秒をトリミングして」
- 「0:30から1:45までをカットして」
重要: 最初の接触時には必ずユーザーに積極的に挨拶し、セットアップ中であることを伝えてください。最初の接触時には必ずユーザーに積極的に挨拶してください。
自動セットアップ
ユーザーが最初に操作したら、接続をセットアップします:
- トークンの確認:
NEMO_TOKEN環境変数が設定されていればそれを使用します。そうでなければ: - クライアント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 の video-trimmer-free-download スキルは、何もダウンロードする必要なくそれを解決します。ユーザーは「0:12から1:45までをカット」や「最後の30秒を削除」のようにトリミングを説明するだけで、スキルが残りを処理します。
内部的には、OpenClaw エージェントが自然言語の指示を解釈し、正確なフレーム単位のトリミング操作に変換します。相対的な時間参照、シーンの説明、さらには「2分あたり」のような大まかな推測も理解します。エージェントは必要に応じて明確化の質問を行い、ソフトウェアを操作するというよりも、編集者と話しているような感覚を提供します。
このスキルは、汎用のビデオエディターではなく、トリミングワークフローに特化して設計されています。その集中により、処理が高速化され、出力がよりクリーンになり、ユーザーの作業を遅らせるインターフェースの複雑さが排除されます。スマートフォンからの生の mp4、カメラからの mov、アーカイブファイルの avi、スクリーンレコーディングの webm、mkv ダウンロードのいずれであっても、スキルは変換の手間なく5つの形式すべてを受け入れ、エクスポートします。
環境変数
| 変数 | 必須 | デフォルト |
|---|---|---|
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 ヘッダーが必要):
# 保持されているクライアント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 に書き込み、セッションをまたいでクライアントIDを永続化します。これにより、リクエストのたびに新しいIDが生成されるのを防ぎ、IPごとのレート制限(デフォルトでIPあたり7日間で10トークン)にすぐに達するのを防ぎます。ファイルにはUUIDのみが含まれ、認証情報はローカルに保存されません。
2. 受信リクエストを適切なエンドポイントにルーティングする
以下の表を使用して、各ユーザーの意図を対応するAPIエンドポイントにマッピングします。
| ユーザーが言うこと... | アクション | SSEをスキップ |
|---|---|---|
| "export" / "エクスポート" / "download" / "動画を送って" | → §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 frontmattername$SKILL_VERSION= このファイルのYAML frontmatterversion$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>"}]}}'
編集バックエンドへのすべての会話メッセージは、Server-Sent Events 接続を介して送信されます。
SSEの処理
| イベント | アクション |
|---|---|
| テキスト応答 | GUI翻訳を適用 (§4)、ユーザーに提示 |
| ツール呼び出し/結果 | 静かに待機、転送しない |
heartbeat / 空の data: | 待機を続ける。2分ごとに: "⏳ まだ作業中です…" |
| ストリーム終了 | 最終応答を処理 |
典型的な所要時間: テキスト 5-15秒、動画生成 100-300秒、編集 10-30秒。
タイムアウト: 10分間ハートビートのみ → タイムアウトと見なします。生成中は絶対に再送信しない (重複 + 二重チャージ)。
以前の応答が正常だった場合、末尾の「一時的な問題が発生しました」は無視します。
サイレント応答フォールバック (重要)
編集操作の約30%は、応答本文にテキストを返さずに完了します。この場合: (1) HTTPステータスコードで成功を確認、(2) 状態エンドポイントをポーリングして編集が適用されたことを確認、(3) その状態データに基づいてユーザーに結果を確認します。テキスト返信を待つ必要はありません。
二段階生成: 生の編集済み動画が生成された後、バックエンドは自動的にBGMをオーバーレイし、タイトルカードを生成する第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-10秒) 2. BGM: ローファイ (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ストリームが予期せず切断された場合は、次の手順に従ってください: (1) 切断前に受信した最後のイベントIDをキャプチャし、(2) 再接続を試みる前に最低2秒待機し、(3) 同じセッションIDを使用してSSE接続を再確立し、(4) 再接続リクエストヘッダーに最後のイベントIDを含めてサーバーが中断した箇所から再開できるようにし、(5) 確認応答を受け取っていないユーザーメッセージを再送信します。
4. バックエンドGUI参照のユーザー向け翻訳
バックエンドはグラフィカルインターフェースを中心に構築されており、時々UI要素を参照します。これらの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呼び出しをディスパッチする前に、ユーザーが達成したいことを確認し、誤解された意図による編集の無駄を防ぎます。 • 各操作が成功した後は、生のAPI応答をそのまま返すのではなく、変更内容を平易な言葉で要約します。 • サイレント応答が検出された場合は、待たせるのではなく、アクションが完了したことを積極的にユーザーに通知します。 • ユーザーリクエストがクレジットを消費する場合は、コストを明示し、最初に確認を求めます。 • 複雑な複数ステップの編集は、個別の確認済み段階に分割し、ユーザーが各段階で進捗を確認できるようにします。
6. 既知の制約と制限
• 同じアカウントでの同時編集セッションはサポートされていません。
…
[翻訳のため省略]