Auto Video Analyzer

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

触发条件

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

模式	关键词	示例
Scan	"分析视频", "看一下视频", "说说视频内容"	"分析视频 C:video.mp4"
Full	"详细分析视频", "深度分析视频"	"详细分析视频 D:demo.mp4"
Debug	"Debug视频", "排查视频", "视频问题"	"Debug视频，为什么角色不动"

工作原理

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

使用方式

前提条件

安装 FFmpeg (必需):

Windows:

winget install Gyan.FFmpeg

macOS:

brew install ffmpeg

Linux (Ubuntu/Debian):

sudo apt update && sudo apt install ffmpeg

Linux (CentOS/RHEL):

sudo yum install ffmpeg

自动工作流

当用户说：

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

AI 自动执行： 1. 检测操作系统类型 2. 检查对应平台的工具脚本是否存在 3. 不存在则从 GitHub 下载 - Windows: auto-analyze-video.ps1 - macOS/Linux: auto-analyze-video.sh 4. 执行脚本提取视频帧 5. 分析帧图片内容 6. 返回分析报告

技术依赖

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 助手首次使用时执行以下逻辑：

# 展开路径
$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"
}

安装本技能

# 从 ClawHub 安装
clawhub install auto-video-analyzer

# 或从 GitHub 直接安装
clawhub install shishenbaiye/auto-video-analyzer

更新日志

v1.0.0

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