@unityclaw/skills 1.0.4 → 1.0.6

package/README.md

@@ -90,11 +90,8 @@ npx @unityclaw/skills /unityclaw-media-analysis https://youtube.com/watch?v=...
 | [unityclaw-image-compress](./unityclaw-image-compress/SKILL.md) | Compress images with quality control | 🗜️ |
 
 ### Video Skills
-
 | Skill | Description | Emoji |
 |-------|-------------|-------|
-| [unityclaw-video-generation-sora](./unityclaw-video-generation-sora/SKILL.md) | Generate videos using OpenAI Sora | 🎬 |
-| [unityclaw-video-generation-veo](./unityclaw-video-generation-veo/SKILL.md) | Generate videos using Google Veo | 🎥 |
 | [unityclaw-video-generation-kling](./unityclaw-video-generation-kling/SKILL.md) | Generate videos using Kling AI | 📹 |
 | [unityclaw-video-generation-other](./unityclaw-video-generation-other/SKILL.md) | Generate videos using Doubao, Wan, MiniMax, JiMeng | 🎞️ |
 

package/dist/{chunk-FAGVVFFQ.js → chunk-CVOSGIUI.js}

@@ -1,9 +1,11 @@
 // src/index.ts
-import { spawn } from "child_process";
+import { spawn, execSync } from "child_process";
 import { cp, mkdir, readdir, readFile } from "fs/promises";
-import { existsSync, readdirSync } from "fs";
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync } from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
+import * as os from "os";
+import * as readline from "readline";
 function getSkillsDir() {
   const hasSkillDirs = (dir) => {
     try {
@@ -106,7 +108,58 @@ function getClaudeSkillsDir() {
 }
 function getOpenClawSkillsDir() {
   const homeDir = process.env.HOME || process.env.USERPROFILE || "";
-  return process.env.OPENCLAW_SKILLS_DIR || path.join(homeDir, ".openclaw", "skills");
+  return process.env.OPENCLAW_SKILLS_DIR || path.join(homeDir, ".openclaw", "workspace", "skills");
+}
+async function promptForApiKey() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question("\nEnter your UnityClaw API key (or press Enter to skip): ", (answer) => {
+      rl.close();
+      resolve(answer.trim() || void 0);
+    });
+  });
+}
+function updateOpenClawEnvConfig(apiKey) {
+  const openclawDir = path.join(os.homedir(), ".openclaw");
+  const openclawPath = path.join(openclawDir, "openclaw.json");
+  let config = {};
+  if (existsSync(openclawPath)) {
+    try {
+      config = JSON.parse(readFileSync(openclawPath, "utf-8"));
+    } catch {
+      config = {};
+    }
+  }
+  if (!config.env) config.env = {};
+  const env = config.env;
+  if (!env.vars) env.vars = {};
+  env.vars.UNITYCLAW_API_KEY = apiKey;
+  if (!existsSync(openclawDir)) {
+    mkdirSync(openclawDir, { recursive: true });
+  }
+  writeFileSync(openclawPath, JSON.stringify(config, null, 2), "utf-8");
+}
+function hasExistingApiKey() {
+  const sdkConfigPath = path.join(os.homedir(), ".unityclaw", "config.json");
+  if (existsSync(sdkConfigPath)) {
+    try {
+      const config = JSON.parse(readFileSync(sdkConfigPath, "utf-8"));
+      if (config?.apiKey) return true;
+    } catch {
+    }
+  }
+  const openclawPath = path.join(os.homedir(), ".openclaw", "openclaw.json");
+  if (existsSync(openclawPath)) {
+    try {
+      const config = JSON.parse(readFileSync(openclawPath, "utf-8"));
+      if (config?.env?.vars?.UNITYCLAW_API_KEY) return true;
+    } catch {
+    }
+  }
+  return false;
 }
 async function installSkills(target, skills) {
   const targetDir = target === "claude" ? getClaudeSkillsDir() : getOpenClawSkillsDir();
@@ -137,6 +190,41 @@ Installing ${skillsToInstall.length} skill(s):
   }
   console.log(`
 \u2728 Done! Skills installed to: ${targetDir}`);
+  console.log("target", target);
+  console.log("hasExistingApiKey", hasExistingApiKey());
+  if (target === "openclaw" && !hasExistingApiKey()) {
+    console.log("\n\u{1F527} Configuration:");
+    console.log("  UnityClaw API key not found.\n");
+    const apiKey = await promptForApiKey();
+    if (apiKey) {
+      try {
+        execSync(`npx @unityclaw/sdk config set apiKey ${apiKey}`, { stdio: "pipe" });
+      } catch {
+        const configDir = path.join(os.homedir(), ".unityclaw");
+        const configPath = path.join(configDir, "config.json");
+        let config = {};
+        if (existsSync(configPath)) {
+          try {
+            config = JSON.parse(readFileSync(configPath, "utf-8"));
+          } catch {
+            config = {};
+          }
+        }
+        config.apiKey = apiKey;
+        if (!existsSync(configDir)) {
+          mkdirSync(configDir, { recursive: true });
+        }
+        writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+      }
+      updateOpenClawEnvConfig(apiKey);
+      console.log("\n  \u2705 API key saved to:");
+      console.log("     - ~/.openclaw/openclaw.json");
+      console.log("\n  Get your API key at: https://unityclaw.com");
+    } else {
+      console.log("\n  \u26A0\uFE0F  Skipped. Configure later with:");
+      console.log("     npx @unityclaw/sdk config set apiKey <your-key>");
+    }
+  }
 }
 async function executeSkill(skillCommand) {
   const args = [

package/dist/cli.cjs

@@ -33,6 +33,8 @@ var import_promises = require("fs/promises");
 var import_fs = require("fs");
 var import_path = __toESM(require("path"), 1);
 var import_url = require("url");
+var os = __toESM(require("os"), 1);
+var readline = __toESM(require("readline"), 1);
 var import_meta = {};
 function getSkillsDir() {
   const hasSkillDirs = (dir) => {
@@ -136,7 +138,58 @@ function getClaudeSkillsDir() {
 }
 function getOpenClawSkillsDir() {
   const homeDir = process.env.HOME || process.env.USERPROFILE || "";
-  return process.env.OPENCLAW_SKILLS_DIR || import_path.default.join(homeDir, ".openclaw", "skills");
+  return process.env.OPENCLAW_SKILLS_DIR || import_path.default.join(homeDir, ".openclaw", "workspace", "skills");
+}
+async function promptForApiKey() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question("\nEnter your UnityClaw API key (or press Enter to skip): ", (answer) => {
+      rl.close();
+      resolve(answer.trim() || void 0);
+    });
+  });
+}
+function updateOpenClawEnvConfig(apiKey) {
+  const openclawDir = import_path.default.join(os.homedir(), ".openclaw");
+  const openclawPath = import_path.default.join(openclawDir, "openclaw.json");
+  let config = {};
+  if ((0, import_fs.existsSync)(openclawPath)) {
+    try {
+      config = JSON.parse((0, import_fs.readFileSync)(openclawPath, "utf-8"));
+    } catch {
+      config = {};
+    }
+  }
+  if (!config.env) config.env = {};
+  const env = config.env;
+  if (!env.vars) env.vars = {};
+  env.vars.UNITYCLAW_API_KEY = apiKey;
+  if (!(0, import_fs.existsSync)(openclawDir)) {
+    (0, import_fs.mkdirSync)(openclawDir, { recursive: true });
+  }
+  (0, import_fs.writeFileSync)(openclawPath, JSON.stringify(config, null, 2), "utf-8");
+}
+function hasExistingApiKey() {
+  const sdkConfigPath = import_path.default.join(os.homedir(), ".unityclaw", "config.json");
+  if ((0, import_fs.existsSync)(sdkConfigPath)) {
+    try {
+      const config = JSON.parse((0, import_fs.readFileSync)(sdkConfigPath, "utf-8"));
+      if (config?.apiKey) return true;
+    } catch {
+    }
+  }
+  const openclawPath = import_path.default.join(os.homedir(), ".openclaw", "openclaw.json");
+  if ((0, import_fs.existsSync)(openclawPath)) {
+    try {
+      const config = JSON.parse((0, import_fs.readFileSync)(openclawPath, "utf-8"));
+      if (config?.env?.vars?.UNITYCLAW_API_KEY) return true;
+    } catch {
+    }
+  }
+  return false;
 }
 async function installSkills(target, skills) {
   const targetDir = target === "claude" ? getClaudeSkillsDir() : getOpenClawSkillsDir();
@@ -167,6 +220,41 @@ Installing ${skillsToInstall.length} skill(s):
   }
   console.log(`
 \u2728 Done! Skills installed to: ${targetDir}`);
+  console.log("target", target);
+  console.log("hasExistingApiKey", hasExistingApiKey());
+  if (target === "openclaw" && !hasExistingApiKey()) {
+    console.log("\n\u{1F527} Configuration:");
+    console.log("  UnityClaw API key not found.\n");
+    const apiKey = await promptForApiKey();
+    if (apiKey) {
+      try {
+        (0, import_child_process.execSync)(`npx @unityclaw/sdk config set apiKey ${apiKey}`, { stdio: "pipe" });
+      } catch {
+        const configDir = import_path.default.join(os.homedir(), ".unityclaw");
+        const configPath = import_path.default.join(configDir, "config.json");
+        let config = {};
+        if ((0, import_fs.existsSync)(configPath)) {
+          try {
+            config = JSON.parse((0, import_fs.readFileSync)(configPath, "utf-8"));
+          } catch {
+            config = {};
+          }
+        }
+        config.apiKey = apiKey;
+        if (!(0, import_fs.existsSync)(configDir)) {
+          (0, import_fs.mkdirSync)(configDir, { recursive: true });
+        }
+        (0, import_fs.writeFileSync)(configPath, JSON.stringify(config, null, 2), "utf-8");
+      }
+      updateOpenClawEnvConfig(apiKey);
+      console.log("\n  \u2705 API key saved to:");
+      console.log("     - ~/.openclaw/openclaw.json");
+      console.log("\n  Get your API key at: https://unityclaw.com");
+    } else {
+      console.log("\n  \u26A0\uFE0F  Skipped. Configure later with:");
+      console.log("     npx @unityclaw/sdk config set apiKey <your-key>");
+    }
+  }
 }
 async function executeSkill(skillCommand) {
   const args2 = [

package/dist/cli.js

@@ -3,7 +3,7 @@ import {
   executeSkill,
   installSkills,
   listSkills
-} from "./chunk-FAGVVFFQ.js";
+} from "./chunk-CVOSGIUI.js";
 
 // src/cli.ts
 import { program } from "commander";

package/dist/index.cjs

@@ -44,6 +44,8 @@ var import_promises = require("fs/promises");
 var import_fs = require("fs");
 var import_path = __toESM(require("path"), 1);
 var import_url = require("url");
+var os = __toESM(require("os"), 1);
+var readline = __toESM(require("readline"), 1);
 var import_meta = {};
 function getSkillsDir() {
   const hasSkillDirs = (dir) => {
@@ -147,7 +149,58 @@ function getClaudeSkillsDir() {
 }
 function getOpenClawSkillsDir() {
   const homeDir = process.env.HOME || process.env.USERPROFILE || "";
-  return process.env.OPENCLAW_SKILLS_DIR || import_path.default.join(homeDir, ".openclaw", "skills");
+  return process.env.OPENCLAW_SKILLS_DIR || import_path.default.join(homeDir, ".openclaw", "workspace", "skills");
+}
+async function promptForApiKey() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question("\nEnter your UnityClaw API key (or press Enter to skip): ", (answer) => {
+      rl.close();
+      resolve(answer.trim() || void 0);
+    });
+  });
+}
+function updateOpenClawEnvConfig(apiKey) {
+  const openclawDir = import_path.default.join(os.homedir(), ".openclaw");
+  const openclawPath = import_path.default.join(openclawDir, "openclaw.json");
+  let config = {};
+  if ((0, import_fs.existsSync)(openclawPath)) {
+    try {
+      config = JSON.parse((0, import_fs.readFileSync)(openclawPath, "utf-8"));
+    } catch {
+      config = {};
+    }
+  }
+  if (!config.env) config.env = {};
+  const env = config.env;
+  if (!env.vars) env.vars = {};
+  env.vars.UNITYCLAW_API_KEY = apiKey;
+  if (!(0, import_fs.existsSync)(openclawDir)) {
+    (0, import_fs.mkdirSync)(openclawDir, { recursive: true });
+  }
+  (0, import_fs.writeFileSync)(openclawPath, JSON.stringify(config, null, 2), "utf-8");
+}
+function hasExistingApiKey() {
+  const sdkConfigPath = import_path.default.join(os.homedir(), ".unityclaw", "config.json");
+  if ((0, import_fs.existsSync)(sdkConfigPath)) {
+    try {
+      const config = JSON.parse((0, import_fs.readFileSync)(sdkConfigPath, "utf-8"));
+      if (config?.apiKey) return true;
+    } catch {
+    }
+  }
+  const openclawPath = import_path.default.join(os.homedir(), ".openclaw", "openclaw.json");
+  if ((0, import_fs.existsSync)(openclawPath)) {
+    try {
+      const config = JSON.parse((0, import_fs.readFileSync)(openclawPath, "utf-8"));
+      if (config?.env?.vars?.UNITYCLAW_API_KEY) return true;
+    } catch {
+    }
+  }
+  return false;
 }
 async function installSkills(target, skills) {
   const targetDir = target === "claude" ? getClaudeSkillsDir() : getOpenClawSkillsDir();
@@ -178,6 +231,41 @@ Installing ${skillsToInstall.length} skill(s):
   }
   console.log(`
 \u2728 Done! Skills installed to: ${targetDir}`);
+  console.log("target", target);
+  console.log("hasExistingApiKey", hasExistingApiKey());
+  if (target === "openclaw" && !hasExistingApiKey()) {
+    console.log("\n\u{1F527} Configuration:");
+    console.log("  UnityClaw API key not found.\n");
+    const apiKey = await promptForApiKey();
+    if (apiKey) {
+      try {
+        (0, import_child_process.execSync)(`npx @unityclaw/sdk config set apiKey ${apiKey}`, { stdio: "pipe" });
+      } catch {
+        const configDir = import_path.default.join(os.homedir(), ".unityclaw");
+        const configPath = import_path.default.join(configDir, "config.json");
+        let config = {};
+        if ((0, import_fs.existsSync)(configPath)) {
+          try {
+            config = JSON.parse((0, import_fs.readFileSync)(configPath, "utf-8"));
+          } catch {
+            config = {};
+          }
+        }
+        config.apiKey = apiKey;
+        if (!(0, import_fs.existsSync)(configDir)) {
+          (0, import_fs.mkdirSync)(configDir, { recursive: true });
+        }
+        (0, import_fs.writeFileSync)(configPath, JSON.stringify(config, null, 2), "utf-8");
+      }
+      updateOpenClawEnvConfig(apiKey);
+      console.log("\n  \u2705 API key saved to:");
+      console.log("     - ~/.openclaw/openclaw.json");
+      console.log("\n  Get your API key at: https://unityclaw.com");
+    } else {
+      console.log("\n  \u26A0\uFE0F  Skipped. Configure later with:");
+      console.log("     npx @unityclaw/sdk config set apiKey <your-key>");
+    }
+  }
 }
 async function executeSkill(skillCommand) {
   const args = [

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   installSkills,
   listSkills,
   parseSkill
-} from "./chunk-FAGVVFFQ.js";
+} from "./chunk-CVOSGIUI.js";
 export {
   executeSkill,
   getClaudeSkillsDir,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unityclaw/skills",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "UnityClaw Skills - Claude Code and OpenClaw skill definitions for AI-powered image/video generation, media analysis, and more",
   "type": "module",
   "bin": {

package/unityclaw-video-generation-sora/SKILL.md

@@ -1,286 +0,0 @@
----
-name: unityclaw-video-generation-sora
-description: Generate cinematic videos using OpenAI Sora AI model
-version: 1.0.1
-metadata:
-  openclaw:
-    requires:
-      env:
-        - UNITYCLAW_API_KEY
-      bins:
-        - node
-        - npm
-    primaryEnv: UNITYCLAW_API_KEY
-    emoji: "🎬"
-    homepage: https://unityclaw.com
-    install:
-      - kind: node
-        package: "@unityclaw/sdk"
-        bins: []
----
-
-# UnityClaw Video Generation - Sora
-
-Generate cinematic videos using OpenAI's Sora AI model.
-
-## Installation
-
-```bash
-npm install @unityclaw/sdk
-```
-
-## Configuration
-
-Set your API key using one of these methods:
-
-```bash
-# Method 1: Use SDK CLI (recommended - persists across sessions)
-npx @unityclaw/sdk config set apiKey your-api-key
-
-# Method 2: Environment variable
-export UNITYCLAW_API_KEY=your-api-key
-```
-
-## Response Structure
-
-> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access data via `result.response.data`.
-
-```typescript
-interface UnityClawResult {
-  success: boolean;        // ✅ Use this to check if SDK call succeeded
-  taskId: string;          // Task identifier
-  taskFolder: string;      // Path to task folder with logs
-  duration: number;        // Request duration in ms
-  response: {              // API response object
-    code: number;          // 0 = success
-    data: Array<{          // ✅ Result data here
-      name: string;
-      contentType: string;
-      content: string;     // URL to generated video
-    }> | null;
-  };
-  logs: Array<{ timestamp; level; message }>;
-  attachments: any[];
-}
-```
-
-## Quick Start
-
-```typescript
-import { UnityClawClient } from '@unityclaw/sdk';
-
-const client = new UnityClawClient();
-
-const result = await client.video.sora({
-  prompt: 'A cat playing piano in a cozy living room',
-  orientation: { value: 'landscape', label: 'Landscape' }
-});
-
-// ✅ Correct: Check result.success, access data via result.response.data
-if (result.success && result.response?.data) {
-  console.log('Generated video:', result.response.data);
-}
-```
-
-## Available APIs
-
-### Sora Video Generation
-
-```typescript
-// Basic usage
-const result = await client.video.sora({
-  prompt: 'A drone shot flying over snowy mountains',
-  orientation: { value: 'landscape', label: 'Landscape' }
-});
-
-// With reference image
-const result = await client.video.sora({
-  prompt: 'Animate this scene with gentle movement',
-  attachment: [{ tmp_url: 'https://...', name: 'scene.jpg' }],
-  orientation: { value: 'portrait', label: 'Portrait' }
-});
-```
-
-### Sora Stable Video Generation
-
-```typescript
-// With duration and size control
-const result = await client.video.soraStable({
-  prompt: 'A peaceful ocean wave at sunset',
-  size: { value: '1920x1080', label: '1080p' },
-  seconds: { value: '10', label: '10s' }
-});
-
-// Image-to-video
-const result = await client.video.soraStable({
-  attachment: [{ tmp_url: 'https://...', name: 'image.jpg' }],
-  prompt: 'Bring this image to life',
-  size: { value: '1280x720', label: '720p' },
-  seconds: { value: '5', label: '5s' }
-});
-```
-
-## Parameter Types
-
-### SoraVideoParams
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `prompt` | `string \| TextFieldItem[]` | No | Text description of the video |
-| `attachment` | `AttachmentFieldItem[]` | No | Reference image for image-to-video |
-| `orientation` | `LabelFieldItem` | Yes | Video orientation |
-
-### SoraStableParams
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `prompt` | `string \| TextFieldItem[]` | No | Text description |
-| `attachment` | `AttachmentFieldItem[]` | No | Reference image |
-| `size` | `LabelFieldItem` | No | Video resolution |
-| `seconds` | `LabelFieldItem` | No | Video duration |
-
-## Examples
-
-### Text-to-Video
-
-```typescript
-const client = new UnityClawClient();
-
-const result = await client.video.sora({
-  prompt: 'A cinematic drone shot flying through a futuristic neon-lit city at night, with flying cars and holographic billboards',
-  orientation: { value: 'landscape', label: 'Landscape' }
-});
-
-if (result.success && result.response?.data) {
-  console.log('Video URL:', result.response.data[0].content);
-}
-```
-
-### Image-to-Video
-
-```typescript
-const result = await client.video.sora({
-  prompt: 'Animate this image with subtle camera movement and parallax effect',
-  attachment: [
-    { tmp_url: 'https://example.com/landscape.jpg', name: 'landscape.jpg' }
-  ],
-  orientation: { value: 'landscape', label: 'Landscape' }
-});
-```
-
-### Long Duration Video
-
-```typescript
-const result = await client.video.soraStable({
-  prompt: 'A time-lapse of a flower blooming in a garden',
-  size: { value: '1920x1080', label: '1080p Landscape' },
-  seconds: { value: '15', label: '15s' }
-});
-```
-
-### Portrait Video for Social Media
-
-```typescript
-const result = await client.video.sora({
-  prompt: 'A person walking through a misty forest with sunlight filtering through the trees',
-  orientation: { value: 'portrait', label: 'Portrait' }
-});
-```
-
-### Batch Generation
-
-```typescript
-const prompts = [
-  'A serene beach at golden hour with waves gently rolling',
-  'A busy Tokyo street crossing at night with neon signs',
-  'An astronaut floating in space with Earth in the background'
-];
-
-const results = await Promise.all(
-  prompts.map(prompt => client.video.sora({
-    prompt,
-    orientation: { value: 'landscape', label: 'Landscape' }
-  }))
-);
-
-results.forEach((result, i) => {
-  if (result.success && result.response?.data) {
-    console.log(`Video ${i + 1}: ${result.response.data?.[0]?.content}`);
-  }
-});
-```
-
-## Orientation Options
-
-| Value | Label | Aspect Ratio | Use Case |
-|-------|-------|--------------|----------|
-| `landscape` | Landscape | 16:9 | YouTube, presentations |
-| `portrait` | Portrait | 9:16 | TikTok, Instagram Reels |
-| `square` | Square | 1:1 | Instagram feed |
-
-## Response Format
-
-```typescript
-interface AttachmentResult {
-  name: string;
-  contentType: 'attachment/url';
-  content: string;  // URL to generated video
-}
-
-interface APIResponse<AttachmentResult[]> {
-  code: number;
-  msg?: string;
-  data?: AttachmentResult[];
-}
-```
-
-## Error Handling
-
-```typescript
-const result = await client.video.sora({
-  prompt: 'A test video',
-  orientation: { value: 'landscape', label: 'Landscape' }
-});
-
-if (!result.success) {
-  console.error('Request failed');
-  console.log('Check logs:', result.logs);
-  return;
-}
-
-if (result.response?.code !== 0) {
-  console.error('API error:', result.response);
-  return;
-}
-
-// Success
-console.log('Success:', result.response.data);
-```
-
-## Task Folders
-
-Each execution creates a task folder:
-
-```typescript
-const result = await client.video.sora({
-  prompt: 'test',
-  orientation: { value: 'landscape', label: 'Landscape' }
-});
-
-console.log('Task ID:', result.taskId);
-console.log('Task Folder:', result.taskFolder);
-console.log('Downloaded Videos:', result.attachments);
-```
-
-## Best Practices
-
-1. **Detailed Prompts**: Include camera angles, lighting, and movement descriptions
-2. **Reference Images**: Use high-quality images for image-to-video
-3. **Orientation**: Match orientation to target platform
-4. **Duration**: Use `soraStable` for precise duration control
-
-## Related Skills
-
-- [unityclaw-video-generation-veo](../unityclaw-video-generation-veo/SKILL.md) - Google Veo video generation
-- [unityclaw-video-generation-kling](../unityclaw-video-generation-kling/SKILL.md) - Kling video generation
-- [unityclaw-image-generation](../unityclaw-image-generation/SKILL.md) - Generate reference images

package/unityclaw-video-generation-veo/SKILL.md

@@ -1,275 +0,0 @@
----
-name: unityclaw-video-generation-veo
-description: Generate high-quality videos using Google Veo AI model
-version: 1.0.1
-metadata:
-  openclaw:
-    requires:
-      env:
-        - UNITYCLAW_API_KEY
-      bins:
-        - node
-        - npm
-    primaryEnv: UNITYCLAW_API_KEY
-    emoji: "🎥"
-    homepage: https://unityclaw.com
-    install:
-      - kind: node
-        package: "@unityclaw/sdk"
-        bins: []
----
-
-# UnityClaw Video Generation - Veo
-
-Generate high-quality videos using Google's Veo AI model with advanced control over aspect ratio, resolution, and duration.
-
-## Installation
-
-```bash
-npm install @unityclaw/sdk
-```
-
-## Configuration
-
-Set your API key using one of these methods:
-
-```bash
-# Method 1: Use SDK CLI (recommended - persists across sessions)
-npx @unityclaw/sdk config set apiKey your-api-key
-
-# Method 2: Environment variable
-export UNITYCLAW_API_KEY=your-api-key
-```
-
-## Response Structure
-
-> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access data via `result.response.data`.
-
-```typescript
-interface UnityClawResult {
-  success: boolean;        // ✅ Use this to check if SDK call succeeded
-  taskId: string;          // Task identifier
-  taskFolder: string;      // Path to task folder with logs
-  duration: number;        // Request duration in ms
-  response: {              // API response object
-    code: number;          // 0 = success
-    data: Array<{          // ✅ Result data here
-      name: string;
-      contentType: string;
-      content: string;     // URL to generated video
-    }> | null;
-  };
-  logs: Array<{ timestamp; level; message }>;
-  attachments: any[];
-}
-```
-
-## Quick Start
-
-```typescript
-import { UnityClawClient } from '@unityclaw/sdk';
-
-const client = new UnityClawClient();
-
-const result = await client.video.veo({
-  prompt: 'A beautiful sunset over the ocean with waves crashing',
-  aspect_ratio: { value: '16:9', label: '16:9' },
-  duration: { value: '8', label: '8s' }
-});
-
-// ✅ Correct: Check result.success, access data via result.response.data
-if (result.success && result.response?.data) {
-  console.log('Generated video:', result.response.data);
-}
-```
-
-## API Reference
-
-### veo()
-
-Generate video using Google Veo model.
-
-```typescript
-await client.video.veo({
-  prompt?: string | TextFieldItem[];
-  attachment?: AttachmentFieldItem[];
-  first_frame?: AttachmentFieldItem[];
-  last_frame?: AttachmentFieldItem[];
-  aspect_ratio?: LabelFieldItem | string;
-  resolution?: LabelFieldItem | string;
-  duration?: LabelFieldItem | string;
-}): Promise<APIResponse<AttachmentResult[]>>
-```
-
-## Parameters
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `prompt` | `string \| TextFieldItem[]` | No* | Text description (*required if no attachment) |
-| `attachment` | `AttachmentFieldItem[]` | No* | Reference image (*required if no prompt) |
-| `first_frame` | `AttachmentFieldItem[]` | No | Starting frame for video |
-| `last_frame` | `AttachmentFieldItem[]` | No | Ending frame for video |
-| `aspect_ratio` | `LabelFieldItem \| string` | No | Video aspect ratio |
-| `resolution` | `LabelFieldItem \| string` | No | Video resolution |
-| `duration` | `LabelFieldItem \| string` | No | Video duration in seconds |
-
-## Examples
-
-### Text-to-Video
-
-```typescript
-const client = new UnityClawClient();
-
-const result = await client.video.veo({
-  prompt: 'A majestic eagle soaring through misty mountain peaks at sunrise',
-  aspect_ratio: { value: '16:9', label: '16:9' },
-  resolution: { value: '1080p', label: '1080p' },
-  duration: { value: '8', label: '8s' }
-});
-```
-
-### Image-to-Video
-
-```typescript
-const result = await client.video.veo({
-  attachment: [
-    { tmp_url: 'https://example.com/landscape.jpg', name: 'landscape.jpg' }
-  ],
-  aspect_ratio: { value: '16:9', label: '16:9' },
-  duration: { value: '5', label: '5s' }
-});
-```
-
-### First/Last Frame Control
-
-```typescript
-// Generate video with specific start and end frames
-const result = await client.video.veo({
-  first_frame: [
-    { tmp_url: 'https://example.com/start.jpg', name: 'start.jpg' }
-  ],
-  last_frame: [
-    { tmp_url: 'https://example.com/end.jpg', name: 'end.jpg' }
-  ],
-  prompt: 'Smooth transition between the two scenes',
-  duration: { value: '8', label: '8s' }
-});
-```
-
-### High Resolution Video
-
-```typescript
-const result = await client.video.veo({
-  prompt: 'A cinematic shot of a luxury car driving through a city at night',
-  aspect_ratio: { value: '16:9', label: '16:9' },
-  resolution: { value: '4K', label: '4K' },
-  duration: { value: '10', label: '10s' }
-});
-```
-
-### Portrait Video
-
-```typescript
-const result = await client.video.veo({
-  prompt: 'A model walking down a fashion runway with dramatic lighting',
-  aspect_ratio: { value: '9:16', label: '9:16' },
-  duration: { value: '5', label: '5s' }
-});
-```
-
-### Simple String Parameters
-
-```typescript
-// You can also use simple strings instead of LabelFieldItem
-const result = await client.video.veo({
-  prompt: 'A peaceful garden scene',
-  aspect_ratio: '16:9',
-  resolution: '1080p',
-  duration: '8'
-});
-```
-
-## Aspect Ratio Options
-
-| Value | Use Case |
-|-------|----------|
-| `16:9` | Standard landscape (YouTube, presentations) |
-| `9:16` | Portrait (TikTok, Instagram Reels) |
-| `1:1` | Square (Instagram feed) |
-
-## Duration Options
-
-| Value | Description |
-|-------|-------------|
-| `5` | 5 seconds |
-| `8` | 8 seconds (default) |
-| `10` | 10 seconds |
-
-## Resolution Options
-
-| Value | Description |
-|-------|-------------|
-| `720p` | HD quality |
-| `1080p` | Full HD |
-| `4K` | Ultra HD |
-
-## Response Format
-
-```typescript
-interface AttachmentResult {
-  name: string;
-  contentType: 'attachment/url';
-  content: string;  // URL to generated video
-}
-```
-
-## Error Handling
-
-```typescript
-const result = await client.video.veo({
-  prompt: 'A test video',
-  aspect_ratio: '16:9'
-});
-
-if (!result.success) {
-  console.error('Request failed');
-  console.log('Check logs:', result.logs);
-  return;
-}
-
-if (result.response?.code !== 0) {
-  console.error('API error:', result.response);
-  return;
-}
-
-// Success
-console.log('Success:', result.response.data);
-```
-
-## Task Folders
-
-Each execution creates a task folder:
-
-```typescript
-const result = await client.video.veo({
-  prompt: 'test',
-  aspect_ratio: '16:9'
-});
-
-console.log('Task ID:', result.taskId);
-console.log('Task Folder:', result.taskFolder);
-console.log('Downloaded Videos:', result.attachments);
-```
-
-## Best Practices
-
-1. **First/Last Frame**: Use for precise control over video start/end
-2. **Resolution**: Match to your output requirements
-3. **Duration**: Shorter videos generate faster
-4. **Prompts**: Be specific about camera movement and style
-
-## Related Skills
-
-- [unityclaw-video-generation-sora](../unityclaw-video-generation-sora/SKILL.md) - OpenAI Sora video generation
-- [unityclaw-video-generation-kling](../unityclaw-video-generation-kling/SKILL.md) - Kling video generation
-- [unityclaw-image-generation](../unityclaw-image-generation/SKILL.md) - Generate reference images