纳米 烟雾转场特效

调用纳米 AI 智能体（ai_agent_flow_id=60064），使用多张图片与 BGM 生成具有烟雾转场特效的视频，适合节日活动 KV、年货节等场景。

功能特性

• 烟雾包裹转场: 使用烟雾效果在多张图片之间进行柔和过渡
• 多素材 + 音乐: 支持多张图片和一条 BGM 音频
• 附件支持: 支持图片、音频附件，通过 file 字段传入
• SSE 流式输出: 调用前提示、输出最终结果(文本、图片、音/视频)
• 飞书优化: 调用前提示、卡片结果展示、2小时超时

飞书调用优化说明

仅在飞书 中生效。其他 channel 保持原有输出方式。

调用前提示

开始调用脚本前，向用户发送提示消息：

🌫️ 正在调用 纳米 烟雾转场特效 技能...
⏳ 当前工具执行时间较长，请耐心等候...

超时设置

• 请求超时时间：2 小时（7200 秒）

结果展示（飞书卡片）

执行完成后，将结果以消息卡片形式展示给用户，包括：

1. 文本内容：效果说明或脚本摘要
2. 视频：烟雾转场特效生成视频
3. 图片：输入图片或关键帧
4. 文档/链接：脚本文档或补充说明

卡片结构示例

{
  "config": {"wide_screen_mode": true},
  "header": {
    "title": {"tag": "plain_text", "content": "🌫️ 纳米 烟雾转场特效 生成完成"},
    "template": "blue"
  },
  "elements": [
    {
      "tag": "div",
      "text": {"tag": "plain_text", "content": "📝 烟雾转场效果说明：..."}
    },
    {
      "tag": "action",
      "actions": [
        {
          "tag": "button",
          "text": {"tag": "plain_text", "content": "🎬 查看烟雾转场视频"},
          "type": "primary",
          "url": "..."
        }
      ]
    }
  ]
}

错误处理

如果执行过程中出现错误，会将错误信息以卡片形式展示给用户。

使用方式

命令行调用

统一通过 skills/nami-smog-transition-effect-video/scripts/nami_smog_transition_effect_video.py 脚本：

python3 skills/nami-smog-transition-effect-video/scripts/nami_smog_transition_effect_video.py \
  --flow-id 60064 \
  -p "3D电影感，C4D风格... 使用上传的mp3作为背景音乐，画面比例3:4" \
  --file '[
    {
      "title": "图片1.jpg",
      "local_path": "/Users/用户/.openclaw/media/inbound/img1.jpg",
      "url": "",
      "file_type": 2,
      "size": 111111,
      "sequential_title": "图片1",
      "ext": "jpg"
    },
    {
      "title": "图片2.jpg",
      "local_path": "/Users/用户/.openclaw/media/inbound/img2.jpg",
      "url": "",
      "file_type": 2,
      "size": 222222,
      "sequential_title": "图片2",
      "ext": "jpg"
    },
    {
      "title": "BGM.mp3",
      "local_path": "/Users/用户/.openclaw/media/inbound/bgm.mp3",
      "url": "",
      "file_type": 3,
      "size": 3333333,
      "sequential_title": "音频1",
      "ext": "mp3"
    }
  ]'

参数说明

附件 file 结构

--file 参数统一传入 JSON 对象数组，每个元素为一个附件对象：

[
  {
    "title": "图片1.jpg",
    "local_path": "/Users/用户/.openclaw/media/inbound/img1.jpg",
    "url": "",
    "file_type": 2,
    "size": 111111,
    "sequential_title": "图片1",
    "ext": "jpg"
  },
  {
    "title": "BGM.mp3",
    "local_path": "/Users/用户/.openclaw/media/inbound/bgm.mp3",
    "url": "",
    "file_type": 3,
    "size": 3333333,
    "sequential_title": "音频1",
    "ext": "mp3"
  }
]

• title: 文件标题
• local_path: 本地绝对路径
• url: 可留空，脚本会自动上传并补全
• file_type: 1=文档，2=图片，3=音/视频
• size: 文件大小
• sequential_title: 素材序号名称
• ext: 文件扩展名

输出格式与解析（SSE 规范）

本技能使用统一 SSE 解析逻辑：

1. 仅当 action == "final" 且 targetKey == "summary" 时才解析数据
2. 输出内容包含：
   • final_tips：文本结果
   • 图片结果：attachments[*].results[*] 中 type="image" 的条目
   • 视频结果：attachments[*].results[*] 中 type="video" 的条目
   • 文本结果：attachments[*].results[*] 中 type="document" 的条目

飞书附件处理流程

当用户通过飞书上传图片与 BGM 素材时，按以下流程处理：

步骤 1：获取系统下载的文件路径

系统已自动将附件下载到 /Users/用户/.openclaw/media/inbound/ 目录。

步骤 2：组装 file JSON

[
  {
    "title": "图片1.jpg",
    "local_path": "/Users/用户/.openclaw/media/inbound/img1.jpg",
    "url": "",
    "file_type": 2,
    "size": 111111,
    "sequential_title": "图片1",
    "ext": "jpg"
  },
  {
    "title": "BGM.mp3",
    "local_path": "/Users/用户/.openclaw/media/inbound/bgm.mp3",
    "url": "",
    "file_type": 3,
    "size": 3333333,
    "sequential_title": "音频1",
    "ext": "mp3"
  }
]

步骤 3：调用脚本

python3 skills/nami-smog-transition-effect-video/scripts/nami_smog_transition_effect_video.py \
  --flow-id 60064 \
  -p "根据以上素材生成一条烟雾转场特效视频" \
  --file '[{"title":"图片1.jpg","local_path":"/Users/用户/.openclaw/media/inbound/img1.jpg","url":"","file_type":2,"size":111111,"sequential_title":"图片1","ext":"jpg"},{"title":"BGM.mp3","local_path":"/Users/用户/.openclaw/media/inbound/bgm.mp3","url":"","file_type":3,"size":3333333,"sequential_title":"音频1","ext":"mp3"}]'

其他 channel 说明

--channel 参数说明：

• 用于指定消息来源渠道，不同渠道有不同的输出格式
• feishu：输出飞书卡片格式（包含 header、elements 等结构）
• 其他渠道：输出标准 JSON 格式（包含 text、images、videos、documents 字段）

注意事项

• 建议上传分辨率较高的图片和高质量音频素材
• 结果中的视频/图片链接应该是公网可访问的 URL
• 超时时间 2 小时适合烟雾转场特效视频生成等长时间任务

name: nami-smog-transition-effect-video description: 纳米 烟雾转场特效。基于用户上传的图片和可选音乐，生成带烟雾转场效果的视频画面；支持图片、音频附件；SSE 流式输出，可对接飞书、微信、Discord、Telegram 等 channel。当用户希望生成烟雾包裹、氛围感强的转场特效视频时使用。 metadata: { "openclaw": { "emoji": "🌫️", "requires": { "bins": ["python3", "curl"] }, }, }

纳米 烟雾转场特效

调用纳米 AI 智能体（ai_agent_flow_id=60064），使用多张图片与 BGM 生成具有烟雾转场特效的视频。

关键行为约定

• 当用户未在 prompt 中指定「画面比例」时，上层代理需在传给脚本前在 prompt 末尾追加：画面比例16:9。

使用方式

python3 skills/nami-smog-transition-effect-video/scripts/nami_smog_transition_effect_video.py \
  --flow-id 60064 \
  -p "3D电影感，C4D风格... 使用上传的mp3作为背景音乐，画面比例3:4" \
  --file '[
    {
      "title": "图片1.jpg",
      "local_path": "/Users/用户/.openclaw/media/inbound/img1.jpg",
      "url": "",
      "file_type": 2,
      "size": 111111,
      "sequential_title": "图片1",
      "ext": "jpg"
    },
    {
      "title": "图片2.jpg",
      "local_path": "/Users/用户/.openclaw/media/inbound/img2.jpg",
      "url": "",
      "file_type": 2,
      "size": 222222,
      "sequential_title": "图片2",
      "ext": "jpg"
    },
    {
      "title": "BGM.mp3",
      "local_path": "/Users/用户/.openclaw/media/inbound/bgm.mp3",
      "url": "",
      "file_type": 3,
      "size": 3333333,
      "sequential_title": "音频1",
      "ext": "mp3"
    }
  ]'

参数与输出

• --flow-id 必须为 60064
• SSE 解析逻辑由 skills/nami-smog-transition-effect-video/scripts/nami_smog_transition_effect_video.py 独立实现，输出 results 中的视频即为烟雾转场特效视频，适合节日活动 KV、年货节等场景。