0. 初回コンタクト
ユーザーがこのスキルを開いたり、最初のメッセージを送信したときは、すぐに挨拶してください:
⚡ こんにちは!動画生成AIをお手伝いします。動画ファイルを送信するか、必要な内容を教えてください!
試してみてください:
- "短い動画を作成して"
- "このクリップにエフェクトを追加して"
- "動画を編集して"
重要: 初回コンタクトでは必ずプロアクティブに挨拶してください。接続をセットアップ中であることを知らせてください。
自動セットアップ
ユーザーが最初に操作するときに、接続をセットアップします:
- トークンの確認:
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)で、すぐに作業できる状態にします。
ユーザーに簡単に「セットアップ中…準備完了!」と伝えてから、リクエストを進めてください。
プレーンテキストを完成した動画ファイルに変換
ほとんどの動画ツールは、何か役立つものを作成する前にそのインターフェースを学ぶ必要があります。このfree-video-generator-aiスキルはそのモデルを完全に逆転させます。必要な出力をプレーンな言葉で説明するだけで、スキルが舞台裏で構成ロジックを処理します。30秒の製品クリップ、ループ背景、または別々のクリップから結合されたマルチシーンシーケンスが必要な場合でも、会話が作業を推進します。
内部では、OpenClawエージェントがあなたの指示を構造化されたタスクとして解釈し、「2番目と3番目のクリップの間にフェードトランジションを追加する」や「これをInstagram用の正方形mp4としてエクスポートする」といったリクエストを個別の処理ステップに分解します。エージェントは会話全体のコンテキストを追跡するため、フォローアップの編集は毎回新しく始めるのではなく、同じプロジェクトを洗練させます。
このアプローチは、迅速に反復するクリエイターに適しています。広告のカットをテストするマーケティング担当者、講義クリップを組み立てる教師、または独自のパイプラインを構築せずに動画機能のプロトタイプを作成する開発者などです。スキルはClawHubの共有インフラストラクチャを通じて実行されるため、分単位のレンダリング料金やフォーマット変換のペイウォールはありません。入力と出力は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ヘッダーが必要):
# 保存されたクライアント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" / "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":"..."}}
他の操作を進める前に、セッションを確立する必要があります。このセッショントークンは、後続のすべてのAPI操作に必要です。
ブラウザで開く: セッションを作成した後、ユーザーに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) 空の応答をエラーとして扱わない、(2) タスク状態エンドポイントをポーリングして完了を確認する、(3) 出力アセットを直接取得する、(4) 通常の応答を受信したかのように結果をユーザーに提示します。
2段階生成: 生の動画が生成された後、バックエンドは自動的に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。
アップロードエンドポイントは、後続の動画生成または編集リクエストで参照されるユーザー提供のメディアファイルを受け入れます。
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ストリームが予期せず切断された場合は、次の手順に従います: (1) 接続が失われる前の最後の既知のタスクIDをキャプチャする、(2) サーバーへの過剰なリクエストを避けるために、再接続を試みる前に最低3秒待つ、(3) 元のセッショントークンを使用してSSE接続を再確立する、(4) キャプチャしたタスクIDを使用してタスク状態エンドポイントのポーリングを再開し、現在の進行状況を確認する、(5) 終了状態が確認されたら、タスクを再起動せずに結果をユーザーに配信する。
4. バックエンド応答のユーザー向け言語へのマッピング
バックエンドはグラフィカルインターフェースが存在することを前提に設計されているため、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. 推奨される会話パターン
• 長時間実行されるタスクを開始する前に、ユーザーの意図と必要な入力を確認し、クレジットの無駄を防ぐ。 • 生成中は段階的な進捗状況を提供し、ユーザーにリクエストが処理中であることを知らせる。 • タスクが完了したら、ダウンロードリンクを提示する前に、何が生成されたかを要約する。 • 配信直後にユーザーが変更を要求した場合は、新しいセッションを開く前に前のセッションがまだ有効かどうかを確認する。 • 技術的なステータスコードは常に、ユーザーに表示する前に平易で親しみやすい言葉に翻訳する。
6. 既知の制約と制限事項
• 動画…
[翻訳のため省略]