# Send Flyworks Avatar Video to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "flyworks-avatar-video",
    "name": "Flyworks Avatar Video",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/linhui99/flyworks-avatar-video",
    "canonicalUrl": "https://clawhub.ai/linhui99/flyworks-avatar-video",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/flyworks-avatar-video",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=flyworks-avatar-video",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/authentication.md",
      "references/avatars.md",
      "references/video-generation.md",
      "references/voices.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/flyworks-avatar-video"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/flyworks-avatar-video",
    "downloadUrl": "https://openagent3.xyz/downloads/flyworks-avatar-video",
    "agentUrl": "https://openagent3.xyz/skills/flyworks-avatar-video/agent",
    "manifestUrl": "https://openagent3.xyz/skills/flyworks-avatar-video/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/flyworks-avatar-video/agent.md"
  }
}
```
## Documentation

### Avatar Video Generation Skill

This skill allows you to generate videos using Flyworks (a.k.a HiFly 飞影数字人) Digital Humans. Available features:

Public Avatar Video: Create video from text or audio using pre-made highly realistic avatars.
Talking Photo: Create a "talking photo" video from a single image and text/audio.
Voice Cloning: Clone a voice from an audio sample to use in TTS.

For detailed documentation, see the references/ folder:

authentication.md - API token setup
avatars.md - Working with avatars
voices.md - Voice selection and cloning
video-generation.md - Video creation workflow

### API Token & Limitations

This skill works with a default free-tier token, but it has limitations:

Watermark: Generated videos will have a watermark.
Duration Limit: Videos are limited to 30 seconds.

To remove limitations:

Register at hifly.cc or flyworks.ai.
Get your API key from User Settings.
Set the environment variable: export HIFLY_API_TOKEN="your_token_here"

### scripts/hifly_client.py

The main entry point for all operations.

Usage

# List available public avatars
python scripts/hifly_client.py list_public_avatars

# List available public voices
python scripts/hifly_client.py list_public_voices

# Create a video with a public avatar (TTS)
python scripts/hifly_client.py create_video --type tts --text "Hello world" --avatar "avatar_id_or_alias" --voice "voice_id_or_alias"

# Create a video with a public avatar (Audio URL or File)
python scripts/hifly_client.py create_video --audio "https://... or path/to/audio.mp3" --avatar "avatar_id_or_alias"

# Create a talked photo video using bundled assets
python scripts/hifly_client.py create_talking_photo --image assets/avatar.png --title "Bundled Avatar"

# Clone a voice using bundled assets
python scripts/hifly_client.py clone_voice --audio assets/voice.MP3 --title "Bundled Voice"

# Check status of generated tasks
python scripts/hifly_client.py check_task --id "TASK_ID"

# Manage local aliases (saved in memory.json)
python scripts/hifly_client.py manage_memory add my_avatar "av_12345"
python scripts/hifly_client.py manage_memory list

### 1. Create a simple greeting video

# First find a voice and avatar
python scripts/hifly_client.py list_public_avatars
python scripts/hifly_client.py list_public_voices

# Generate
python scripts/hifly_client.py create_video --type tts --text "Welcome to our service." --avatar "av_public_01" --voice "voice_public_01"

### 2. Use a custom talking photo

# Create the avatar from an image URL
python scripts/hifly_client.py create_talking_photo --image "https://mysite.com/photo.jpg" --title "CEO Photo"
# Output will give you an Avatar ID, e.g., av_custom_99

# Save it to memory
python scripts/hifly_client.py manage_memory add ceo av_custom_99

# Generate video using the new avatar
python scripts/hifly_client.py create_video --type tts --text "Here is the quarterly report." --avatar ceo --voice "voice_public_01"

### Agent Behavior Guidelines

When assisting users with video generation, follow these guidelines:

### Voice Selection Required

Video generation requires both text AND a voice. If the user provides text but no voice:

Check local memory first: Run manage_memory list to see if the user has saved any voice aliases.


Ask the user to choose:

"I see you want to create a video with the text '[text]'. Which voice would you like to use?"
If they have saved voices: "You have these saved voices: [list]. Or would you prefer a public voice?"
If no saved voices: "Would you like to use a public voice, or clone your own voice from an audio sample first?"



Help them select:

To see public voices: list_public_voices
To clone a voice: clone_voice --audio [file] --title [name]

### Complete Workflow Example

For a prompt like "Create a talking photo video from my photo saying 'this is my AI twin'":

Ask: "Which voice would you like for your AI twin? You can use a public voice or clone your own."
If they want to clone: Help them with clone_voice
Create the talking photo with both text and voice:
python scripts/hifly_client.py create_talking_photo \\
  --image user_photo.jpg \\
  --text "this is my AI twin" \\
  --voice SELECTED_VOICE_ID \\
  --title "My AI Twin"

### Saving for Later

After creating avatars or cloning voices, offer to save them:

python scripts/hifly_client.py manage_memory add my_avatar AVATAR_ID --kind avatar
python scripts/hifly_client.py manage_memory add my_voice VOICE_ID --kind voice
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: linhui99
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/flyworks-avatar-video)
- [Send to Agent page](https://openagent3.xyz/skills/flyworks-avatar-video/agent)
- [JSON manifest](https://openagent3.xyz/skills/flyworks-avatar-video/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/flyworks-avatar-video/agent.md)
- [Download page](https://openagent3.xyz/downloads/flyworks-avatar-video)