@let5sne/kimi-video 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenClaw Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,124 @@
+# Kimi Video Plugin for OpenClaw
+
+OpenClaw 插件，用于使用 Kimi K2.5 API 分析视频内容。
+
+## 功能
+
+- 分析本地视频文件或远程视频 URL
+- 使用 Kimi K2.5 模型进行智能视频内容分析
+- 支持自定义分析提示词
+
+## 安装
+
+插件已自动安装在 `~/.openclaw/extensions/kimi-video/` 目录下。
+
+## 配置
+
+在 `config.json5` 中添加配置：
+
+```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"
+        }
+      }
+    }
+  }
+}
+```
+
+或者只使用环境变量：
+
+```bash
+export MOONSHOT_API_KEY="your-moonshot-api-key"
+```
+
+## 使用
+
+工具名称：`video_analyze`
+
+参数：
+- `videoPath` (可选): 本地视频文件路径
+- `videoUrl` (可选): 远程视频 URL
+- `prompt` (可选): 自定义分析提示词
+
+注意：`videoPath` 和 `videoUrl` 至少提供一个。
+
+### 示例
+
+分析本地视频：
+```json
+{
+  "videoPath": "/path/to/video.mp4"
+}
+```
+
+分析远程视频：
+```json
+{
+  "videoUrl": "https://example.com/video.mp4"
+}
+```
+
+使用自定义提示词：
+```json
+{
+  "videoUrl": "https://example.com/video.mp4",
+  "prompt": "请分析这个视频中的主要人物和对话内容"
+}
+```
+
+## 工具启用
+
+由于这是插件工具，需要在 agent 配置中启用：
+
+```json5
+{
+  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 (视频输入)

package/index.ts

@@ -0,0 +1,57 @@
+import type { ClawdbotPluginApi } from "openclaw/plugin-sdk";
+import { registerVideoAnalyzeTool, type ToolConfig } from "./src/tool.js";
+
+function resolveConfig(pluginConfig: unknown): ToolConfig {
+  const raw =
+    pluginConfig && typeof pluginConfig === "object" && !Array.isArray(pluginConfig)
+      ? (pluginConfig as Record<string, unknown>)
+      : {};
+
+  // Get API key from config or environment variable
+  const apiKey =
+    typeof raw.apiKey === "string" && raw.apiKey.trim()
+      ? raw.apiKey.trim()
+      : process.env.MOONSHOT_API_KEY || "";
+
+  if (!apiKey) {
+    throw new Error(
+      "Moonshot API key is required. Set it in plugin config or MOONSHOT_API_KEY environment variable."
+    );
+  }
+
+  return {
+    apiKey,
+    model:
+      typeof raw.model === "string" && raw.model.trim()
+        ? raw.model.trim()
+        : "kimi-k2.5",
+    baseUrl:
+      typeof raw.baseUrl === "string" && raw.baseUrl.trim()
+        ? raw.baseUrl.trim()
+        : "https://api.moonshot.cn/v1",
+  };
+}
+
+const kimiVideoPlugin = {
+  id: "kimi-video",
+  name: "Kimi Video",
+  description: "Video analysis plugin using Kimi K2.5 API",
+  register(api: ClawdbotPluginApi) {
+    try {
+      const config = resolveConfig(api.pluginConfig);
+      
+      api.logger.info(`[kimi-video] Initializing with model: ${config.model}`);
+      
+      registerVideoAnalyzeTool(api, config);
+      
+      api.logger.info("[kimi-video] Video analyze tool registered successfully");
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : String(err);
+      api.logger.error(`[kimi-video] Failed to initialize: ${errorMessage}`);
+      throw err;
+    }
+  },
+};
+
+export default kimiVideoPlugin;
+export { registerVideoAnalyzeTool };

package/openclaw.plugin.json

@@ -0,0 +1,28 @@
+{
+  "id": "kimi-video",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "apiKey": {
+        "type": "string",
+        "description": "Moonshot API Key (optional, defaults to MOONSHOT_API_KEY env var)"
+      },
+      "model": {
+        "type": "string",
+        "description": "Model to use for video analysis",
+        "default": "kimi-k2.5"
+      },
+      "baseUrl": {
+        "type": "string",
+        "description": "Base URL for Moonshot API",
+        "default": "https://api.moonshot.cn/v1"
+      }
+    }
+  },
+  "uiHints": {
+    "apiKey": { "label": "API Key", "sensitive": true },
+    "model": { "label": "Model" },
+    "baseUrl": { "label": "Base URL" }
+  }
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@let5sne/kimi-video",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "OpenClaw plugin for video analysis using Kimi K2.5 API",
+  "license": "MIT",
+  "files": [
+    "index.ts",
+    "src",
+    "openclaw.plugin.json"
+  ],
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "openclaw": "^2026.1.0",
+    "typescript": "^5.7.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.1.0"
+  }
+}

package/src/kimi-api.ts

@@ -0,0 +1,101 @@
+import { readFile, stat } from "fs/promises";
+import { execSync } from "child_process";
+import { tmpdir } from "os";
+import { join } from "path";
+
+export interface KimiVideoConfig {
+  apiKey: string;
+  model: string;
+  baseUrl: string;
+}
+
+export interface VideoAnalyzeRequest {
+  videoPath?: string;
+  videoUrl?: string;
+  prompt?: string;
+}
+
+export interface VideoAnalyzeResponse {
+  content: string;
+  usage?: {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+  };
+}
+
+const DEFAULT_PROMPT = "请详细分析这个视频的内容，包括：1. 视频主题 2. 画面内容 3. 关键信息";
+
+export class KimiVideoAnalyzer {
+  private config: KimiVideoConfig;
+
+  constructor(config: KimiVideoConfig) {
+    this.config = config;
+  }
+
+  async analyzeVideo(request: VideoAnalyzeRequest): Promise<VideoAnalyzeResponse> {
+    const { videoPath, videoUrl, prompt = DEFAULT_PROMPT } = request;
+
+    if (!videoPath && !videoUrl) {
+      throw new Error("Either videoPath or videoUrl must be provided");
+    }
+
+    // Use kimi CLI for video analysis (it handles video_in properly)
+    if (videoPath) {
+      return this.analyzeWithKimiCli(videoPath, prompt);
+    } else if (videoUrl) {
+      // Download URL to temp file first
+      const tempPath = join(tmpdir(), `kimi-video-${Date.now()}.mp4`);
+      execSync(`curl -sL "${videoUrl}" -o "${tempPath}"`);
+      const result = await this.analyzeWithKimiCli(tempPath, prompt);
+      execSync(`rm -f "${tempPath}"`);
+      return result;
+    }
+
+    throw new Error("No video source provided");
+  }
+
+  private async analyzeWithKimiCli(
+    filePath: string,
+    prompt: string
+  ): Promise<VideoAnalyzeResponse> {
+    // Verify file exists
+    const stats = await stat(filePath);
+    if (!stats.isFile()) {
+      throw new Error("Path is not a file");
+    }
+
+    // Copy to /tmp for kimi to access
+    const tempPath = join(tmpdir(), `video-${Date.now()}.mp4`);
+    execSync(`cp "${filePath}" "${tempPath}"`);
+
+    try {
+      // Use kimi CLI with --quiet for clean output
+      const cmd = `cd /tmp && kimi -w /tmp -y -p "${prompt.replace(/"/g, '\\"')} 文件路径: ${tempPath}" --print --final-message-only 2>&1`;
+      
+      const output = execSync(cmd, {
+        encoding: "utf-8",
+        timeout: 120000, // 2 minutes timeout
+        maxBuffer: 10 * 1024 * 1024, // 10MB buffer
+      });
+
+      // Clean up temp file
+      execSync(`rm -f "${tempPath}"`);
+
+      return {
+        content: output.trim(),
+        usage: undefined, // kimi CLI doesn't expose token usage
+      };
+    } catch (error) {
+      // Clean up on error
+      execSync(`rm -f "${tempPath}"`).toString();
+      
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      throw new Error(`Kimi CLI error: ${errorMessage}`);
+    }
+  }
+}
+
+export function createKimiVideoAnalyzer(config: KimiVideoConfig): KimiVideoAnalyzer {
+  return new KimiVideoAnalyzer(config);
+}

package/src/tool.ts

@@ -0,0 +1,79 @@
+import type { ClawdbotPluginApi } from "openclaw/plugin-sdk";
+import {
+  KimiVideoAnalyzer,
+  createKimiVideoAnalyzer,
+  type KimiVideoConfig,
+  type VideoAnalyzeRequest,
+} from "./kimi-api.js";
+
+// Use plain JSON schema instead of TypeBox
+const VideoAnalyzeToolSchema = {
+  type: "object",
+  properties: {
+    videoPath: {
+      type: "string",
+      description: "Local file path to the video file to analyze",
+    },
+    videoUrl: {
+      type: "string",
+      description: "URL of the video to analyze",
+    },
+    prompt: {
+      type: "string",
+      description: "Custom prompt for video analysis (optional)",
+    },
+  },
+};
+
+export interface ToolConfig {
+  apiKey: string;
+  model: string;
+  baseUrl: string;
+}
+
+export function registerVideoAnalyzeTool(
+  api: ClawdbotPluginApi,
+  config: ToolConfig
+) {
+  const analyzer = createKimiVideoAnalyzer({
+    apiKey: config.apiKey,
+    model: config.model,
+    baseUrl: config.baseUrl,
+  });
+
+  api.registerTool({
+    name: "video_analyze",
+    label: "Video Analysis",
+    description:
+      "Analyze video content using Kimi K2.5 AI. Provide either a local file path (videoPath) or a URL (videoUrl). The tool will analyze the video and return detailed information about its content, scenes, objects, and key events.",
+    parameters: VideoAnalyzeToolSchema,
+    async execute(_toolCallId, params) {
+      const json = (payload: unknown) => ({
+        content: [{ type: "text" as const, text: JSON.stringify(payload, null, 2) }],
+        details: payload,
+      });
+
+      try {
+        const request: VideoAnalyzeRequest = {
+          videoPath: params.videoPath,
+          videoUrl: params.videoUrl,
+          prompt: params.prompt,
+        };
+
+        const result = await analyzer.analyzeVideo(request);
+
+        return json({
+          success: true,
+          analysis: result.content,
+          usage: result.usage,
+        });
+      } catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        return json({
+          success: false,
+          error: errorMessage,
+        });
+      }
+    },
+  });
+}