纳米 子弹时间特效

调用纳米 AI 智能体（ai_agent_flow_id=51741），基于上传图片生成具有强烈视觉冲击力的子弹时间特效视频。

功能特性

• 子弹时间效果: 模拟时间凝固、相机绕主体运动的经典子弹时间镜头
• 图片驱动: 通过单张或多张图片生成具有空间感的视觉效果
• 附件支持: 支持图片附件，通过 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-bullet-time-effect-video/scripts/nami_bullet_time_effect_video.py 脚本：

python3 skills/nami-bullet-time-effect-video/scripts/nami_bullet_time_effect_video.py \
  --flow-id 51741 \
  -p "图片唱歌跳舞" \
  --file '[{
    "title": "图片1.jpg",
    "local_path": "/Users/用户/.openclaw/media/inbound/image1.jpg",
    "url": "",
    "file_type": 2,
    "size": 123456,
    "sequential_title": "图片1",
    "ext": "jpg"
  }]'

参数说明

附件 file 结构

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

[
  {
    "title": "图片1.jpg",
    "local_path": "/Users/用户/.openclaw/media/inbound/image1.jpg",
    "url": "",
    "file_type": 2,
    "size": 123456,
    "sequential_title": "图片1",
    "ext": "jpg"
  }
]

• 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" 的条目

飞书附件处理流程

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

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

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

步骤 2：组装 file JSON

[
  {
    "title": "图片1.jpg",
    "local_path": "/Users/用户/.openclaw/media/inbound/image1.jpg",
    "url": "",
    "file_type": 2,
    "size": 123456,
    "sequential_title": "图片1",
    "ext": "jpg"
  }
]

步骤 3：调用脚本

python3 skills/nami-bullet-time-effect-video/scripts/nami_bullet_time_effect_video.py \
  --flow-id 51741 \
  -p "使用以上传图片生成一条子弹时间特效视频" \
  --file '[{"title":"图片1.jpg","local_path":"/Users/用户/.openclaw/media/inbound/image1.jpg","url":"","file_type":2,"size":123456,"sequential_title":"图片1","ext":"jpg"}]'

其他 channel 说明

--channel 参数说明：

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

注意事项

• 建议上传画质较高、主体清晰的图片
• 结果中的视频/图片链接应该是公网可访问的 URL
• 超时时间 2 小时适合子弹时间特效视频生成等长时间任务

name: nami-bullet-time-effect-video description: 纳米 子弹时间特效。基于用户上传的图片，生成具有强烈空间感和时间凝固效果的子弹时间特效视频；支持图片附件；SSE 流式输出，可对接飞书、微信、Discord、Telegram 等 channel。当用户希望用单张或多张图片生成子弹时间风格特效视频时使用。 metadata: { "openclaw": { "emoji": "⏱️", "requires": { "bins": ["python3", "curl"] }, }, }

纳米 子弹时间特效

调用纳米 AI 智能体（ai_agent_flow_id=51741），基于上传图片生成具有强烈视觉冲击力的子弹时间特效视频。

使用方式

python3 skills/nami-bullet-time-effect-video/scripts/nami_bullet_time_effect_video.py \
  --flow-id 51741 \
  -p "图片唱歌跳舞" \
  --file '[{
    "title": "图片1.jpg",
    "local_path": "/Users/用户/.openclaw/media/inbound/image1.jpg",
    "url": "",
    "file_type": 2,
    "size": 123456,
    "sequential_title": "图片1",
    "ext": "jpg"
  }]'

参数与输出

• --flow-id 必须为 51741
• SSE 解析逻辑由 skills/nami-bullet-time-effect-video/scripts/nami_bullet_time_effect_video.py 独立实现，输出 results 中的视频即为子弹时间特效结果。