Kimi Video Plugin for OpenClaw

OpenClaw 插件，用于使用 Kimi K2.5 API 分析视频内容。

功能

• 分析本地视频文件或远程视频 URL
• 使用 Kimi K2.5 模型进行智能视频内容分析
• 支持自定义分析提示词

安装

插件已自动安装在 ~/.openclaw/extensions/kimi-video/ 目录下。

配置

在 config.json5 中添加配置：

{
  plugins: {
    entries: {
      "kimi-video": {
        enabled: true,
        config: {
          // API Key (可选，默认使用 MOONSHOT_API_KEY 环境变量)
          apiKey: "your-moonshot-api-key",
          // 模型选择 (可选，默认 kimi-k2.5)
          model: "kimi-k2.5",
          // API 基础 URL (可选)
          baseUrl: "https://api.moonshot.cn/v1"
        }
      }
    }
  }
}

或者只使用环境变量：

export MOONSHOT_API_KEY="your-moonshot-api-key"

使用

工具名称：video_analyze

参数：

• videoPath (可选): 本地视频文件路径
• videoUrl (可选): 远程视频 URL
• prompt (可选): 自定义分析提示词

注意：videoPath 和 videoUrl 至少提供一个。

示例

分析本地视频：

{
  "videoPath": "/path/to/video.mp4"
}

分析远程视频：

{
  "videoUrl": "https://example.com/video.mp4"
}

使用自定义提示词：

{
  "videoUrl": "https://example.com/video.mp4",
  "prompt": "请分析这个视频中的主要人物和对话内容"
}

工具启用

由于这是插件工具，需要在 agent 配置中启用：

{
  agents: {
    list: [
      {
        id: "main",
        tools: {
          allow: [
            "video_analyze",  // 启用视频分析工具
            "kimi-video"      // 或启用整个插件的所有工具
          ]
        }
      }
    ]
  }
}

文件结构

~/.openclaw/extensions/kimi-video/
├── package.json           # 包配置
├── openclaw.plugin.json   # 插件清单
├── index.ts              # 插件入口
├── src/
│   ├── tool.ts           # video_analyze 工具实现
│   └── kimi-api.ts       # Kimi API 调用
└── README.md             # 本文件

依赖

• OpenClaw >= 2026.1.0
• Node.js >= 22.0.0

API 参考

• Base URL: https://api.moonshot.cn/v1
• 模型: kimi-k2.5
• 能力: video_in (视频输入)