Auto Video Analyzer

自动分析视频内容，提取关键帧进行AI视觉分析。

触发条件

当用户消息包含以下模式时自动调用：

模式	关键词	示例
扫描	分析视频, 看一下视频, 说说视频内容	分析视频 C:\\video.mp4
完整

详细分析视频, 深度分析视频 | 详细分析视频 D:\\demo.mp4 |
| 调试 | Debug视频, 排查视频, 视频问题 | Debug视频，为什么角色不动 |

工作原理

1. 1. 检查/下载工具脚本 - 首次使用自动从 GitHub 拉取对应平台版本
2. 提取视频关键帧 - 使用 FFmpeg 智能采样
3. AI 视觉分析 - 分析帧图片内容
4. 生成分析报告 - 输出结构化分析结果

使用方式

前提条件

安装 FFmpeg (必需):

Windows:
powershell
winget install Gyan.FFmpeg

macOS:
bash
brew install ffmpeg

Linux (Ubuntu/Debian):
bash
sudo apt update && sudo apt install ffmpeg

Linux (CentOS/RHEL):
bash
sudo yum install ffmpeg

自动工作流

当用户说：

分析一下 /Users/xxx/Videos/demo.mp4

AI 自动执行：

1. 1. 检测操作系统类型
2. 检查对应平台的工具脚本是否存在
3. 不存在则从 GitHub 下载

- Windows: auto-analyze-video.ps1
- macOS/Linux: auto-analyze-video.sh

1. 4. 执行脚本提取视频帧
2. 分析帧图片内容
3. 返回分析报告

技术依赖

• - FFmpeg: 视频信息读取和帧提取
• PowerShell (Windows) 或 Bash (macOS/Linux)
• AI Vision: 图像分析能力

工具下载

脚本托管于 GitHub:

• - 仓库: https://github.com/shishenbaiye/auto-video-analyzer
• 工具目录: https://github.com/shishenbaiye/auto-video-analyzer/tree/main/tools

包含：

• - auto-analyze-video.ps1 - Windows PowerShell 版本
• auto-analyze-video.sh - macOS/Linux Bash 版本

首次使用时 AI 会自动检测平台并下载对应版本。

平台自动检测逻辑

AI 助手首次使用时执行以下逻辑：

powershell

展开路径

$toolsDir = $executionContext.InvokeCommand.ExpandString($env:USERPROFILE/.openclaw/workspace/tools)

检测平台

$isWindows = $IsWindows -or ($env:OS -eq Windows_NT) -or ($PSVersionTable.Platform -eq Win32NT)

if ($isWindows) {
$scriptName = auto-analyze-video.ps1
$scriptPath = Join-Path $toolsDir $scriptName
} else {
$scriptName = auto-analyze-video.sh
$scriptPath = Join-Path $toolsDir $scriptName
}

$scriptUrl = https://raw.githubusercontent.com/shishenbaiye/auto-video-analyzer/main/tools/$scriptName

检查并下载

if (-not (Test-Path $scriptPath)) { New-Item -ItemType Directory -Force -Path $toolsDir | Out-Null Invoke-WebRequest -Uri $scriptUrl -OutFile $scriptPath -UseBasicParsing

# Linux/macOS 需要添加执行权限
if (-not $isWindows) {
chmod +x $scriptPath
}

Write-Host ✅ 工具已下载: $scriptPath
}

安装本技能

bash

从 ClawHub 安装

clawhub install auto-video-analyzer

或从 GitHub 直接安装

clawhub install shishenbaiye/auto-video-analyzer

更新日志

v1.0.0

• - 基础视频分析功能
• 支持 Windows PowerShell 版本
• 支持 macOS/Linux Bash 版本
• 自动检测平台并下载对应工具