# Send Video Messages from your openclaw 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. 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. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "avatar-video-messages",
    "name": "Video Messages from your openclaw",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/thewulf7/avatar-video-messages",
    "canonicalUrl": "https://clawhub.ai/thewulf7/avatar-video-messages",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/avatar-video-messages",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=avatar-video-messages",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.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/avatar-video-messages"
    },
    "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/avatar-video-messages",
    "downloadUrl": "https://openagent3.xyz/downloads/avatar-video-messages",
    "agentUrl": "https://openagent3.xyz/skills/avatar-video-messages/agent",
    "manifestUrl": "https://openagent3.xyz/skills/avatar-video-messages/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/avatar-video-messages/agent.md"
  }
}
```
## Documentation

### Video Message

Generate avatar video messages from text or audio. Outputs as Telegram video notes (circular format).

### Installation

npm install -g openclaw-avatarcam

### Configuration

Configure in TOOLS.md:

### Video Message (avatarcam)
- avatar: default.vrm
- background: #00FF00

### Settings Reference

SettingDefaultDescriptionavatardefault.vrmVRM avatar file pathbackground#00FF00Color (hex) or image path

### System Dependencies

PlatformCommandmacOSbrew install ffmpegLinuxsudo apt-get install -y xvfb xauth ffmpegWindowsInstall ffmpeg and add to PATHDockerSee Docker section below

Note: macOS and Windows don't need xvfb — they have native display support.

### Docker Users

Add to OPENCLAW_DOCKER_APT_PACKAGES:

build-essential procps curl file git ca-certificates xvfb xauth libgbm1 libxss1 libatk1.0-0 libatk-bridge2.0-0 libgdk-pixbuf2.0-0 libgtk-3-0 libasound2 libnss3 ffmpeg

### Usage

# With color background
avatarcam --audio voice.mp3 --output video.mp4 --background "#00FF00"

# With image background
avatarcam --audio voice.mp3 --output video.mp4 --background "./bg.png"

# With custom avatar
avatarcam --audio voice.mp3 --output video.mp4 --avatar "./custom.vrm"

### Sending as Video Note

Use OpenClaw's message tool with asVideoNote:

message action=send filePath=/tmp/video.mp4 asVideoNote=true

### Workflow

Read config from TOOLS.md (avatar, background)
Generate TTS if given text: tts text="..." → audio path
Run avatarcam with audio + settings → MP4 output
Send as video note via message action=send filePath=... asVideoNote=true
Return NO_REPLY after sending

### Example Flow

User: "Send me a video message saying hello"

# 1. TTS
tts text="Hello! How are you today?" → /tmp/voice.mp3

# 2. Generate video
avatarcam --audio /tmp/voice.mp3 --output /tmp/video.mp4 --background "#00FF00"

# 3. Send as video note
message action=send filePath=/tmp/video.mp4 asVideoNote=true

# 4. Reply
NO_REPLY

### Technical Details

SettingValueResolution384x384 (square)Frame rate30fps constantMax duration60 secondsVideo codecH.264 (libx264)Audio codecAACQualityCRF 18 (high quality)ContainerMP4

### Processing Pipeline

Electron renders VRM avatar with lip sync at 1280x720
WebM captured via canvas.captureStream(30)
FFmpeg processes: crop → fps normalize → scale → encode
Message tool sends via Telegram sendVideoNote API

### Platform Support

PlatformDisplayNotesmacOSNative QuartzNo extra depsLinuxxvfb (headless)apt install xvfbWindowsNativeNo extra deps

### Headless Rendering

Avatarcam auto-detects headless environments:

Uses xvfb-run when $DISPLAY is not set (Linux only)
macOS/Windows use native display
GPU stall warnings are safe to ignore
Generation time: ~1.5x realtime (20s audio ≈ 30s processing)

### Notes

Config is read from TOOLS.md
Clean up temp files after sending: rm /tmp/video*.mp4
For regular video (not circular), omit asVideoNote=true
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: thewulf7
- Version: 0.1.2
## 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/avatar-video-messages)
- [Send to Agent page](https://openagent3.xyz/skills/avatar-video-messages/agent)
- [JSON manifest](https://openagent3.xyz/skills/avatar-video-messages/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/avatar-video-messages/agent.md)
- [Download page](https://openagent3.xyz/downloads/avatar-video-messages)