# Send VoiceMonkey 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": "voicemonkey",
    "name": "VoiceMonkey",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/jayakumark/voicemonkey",
    "canonicalUrl": "https://clawhub.ai/jayakumark/voicemonkey",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/voicemonkey",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voicemonkey",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "voicemonkey",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T17:44:23.761Z",
      "expiresAt": "2026-05-17T17:44:23.761Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voicemonkey",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voicemonkey",
        "contentDisposition": "attachment; filename=\"voicemonkey-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "voicemonkey"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/voicemonkey"
    },
    "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/voicemonkey",
    "downloadUrl": "https://openagent3.xyz/downloads/voicemonkey",
    "agentUrl": "https://openagent3.xyz/skills/voicemonkey/agent",
    "manifestUrl": "https://openagent3.xyz/skills/voicemonkey/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/voicemonkey/agent.md"
  }
}
```
## Documentation

### VoiceMonkey

Control Alexa/Echo devices via VoiceMonkey API v2. Make TTS announcements, trigger Alexa routines, start flows, and display images/videos on Echo Show devices.

### Setup

Get your secret token from Voice Monkey Console → Settings → API Credentials
Set environment variable:
export VOICEMONKEY_TOKEN="your-secret-token"

Or add to ~/.clawdbot/clawdbot.json:
{
  "skills": {
    "entries": {
      "voicemonkey": {
        "env": { "VOICEMONKEY_TOKEN": "your-secret-token" }
      }
    }
  }
}


Find your Device IDs in the Voice Monkey Console → Settings → Devices

### API Base URL

https://api-v2.voicemonkey.io

### Announcement API

Make TTS announcements, play audio/video, or display images on Alexa devices.

Endpoint: https://api-v2.voicemonkey.io/announcement

### Basic TTS Announcement

curl -X GET "https://api-v2.voicemonkey.io/announcement?token=$VOICEMONKEY_TOKEN&device=YOUR_DEVICE_ID&text=Hello%20from%20Echo"

### With Authorization Header (recommended)

curl -X POST "https://api-v2.voicemonkey.io/announcement" \\
  -H "Authorization: $VOICEMONKEY_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "device": "YOUR_DEVICE_ID",
    "text": "Hello from Echo the Fox!"
  }'

### With Voice and Chime

curl -X POST "https://api-v2.voicemonkey.io/announcement" \\
  -H "Authorization: $VOICEMONKEY_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "device": "YOUR_DEVICE_ID",
    "text": "Dinner is ready!",
    "voice": "Brian",
    "chime": "soundbank://soundlibrary/alarms/beeps_and_bloops/bell_02"
  }'

### Display Image on Echo Show

curl -X POST "https://api-v2.voicemonkey.io/announcement" \\
  -H "Authorization: $VOICEMONKEY_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "device": "YOUR_DEVICE_ID",
    "text": "Check out this image",
    "image": "https://example.com/image.jpg",
    "media_width": "100",
    "media_height": "100",
    "media_scaling": "best-fit"
  }'

### Play Audio File

curl -X POST "https://api-v2.voicemonkey.io/announcement" \\
  -H "Authorization: $VOICEMONKEY_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "device": "YOUR_DEVICE_ID",
    "audio": "https://example.com/sound.mp3"
  }'

### Play Video on Echo Show

curl -X POST "https://api-v2.voicemonkey.io/announcement" \\
  -H "Authorization: $VOICEMONKEY_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "device": "YOUR_DEVICE_ID",
    "video": "https://example.com/video.mp4",
    "video_repeat": 1
  }'

### Open Website on Echo Show

curl -X POST "https://api-v2.voicemonkey.io/announcement" \\
  -H "Authorization: $VOICEMONKEY_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "device": "YOUR_DEVICE_ID",
    "website": "https://example.com",
    "no_bg": "true"
  }'

### Announcement Parameters

ParameterRequiredDescriptiontokenYes*Secret token (*or use Authorization header)deviceYesDevice ID from Voice Monkey consoletextNoTTS text (supports SSML)voiceNoVoice for TTS (see API Playground for options)languageNoLanguage code for better pronunciationchimeNoSound URL or Alexa sound library referenceaudioNoHTTPS URL of audio file to playbackground_audioNoAudio to play behind TTSimageNoHTTPS URL of image for Echo ShowvideoNoHTTPS URL of MP4 video for Echo Showvideo_repeatNoNumber of times to loop videowebsiteNoURL to open on Echo Showno_bgNoSet "true" to hide Voice Monkey brandingmedia_widthNoImage widthmedia_heightNoImage heightmedia_scalingNoImage scaling modemedia_alignNoImage alignmentmedia_radiusNoCorner radius for image clippingvar-[name]NoUpdate Voice Monkey variables

### Routine Trigger API

Trigger Voice Monkey devices to start Alexa Routines.

Endpoint: https://api-v2.voicemonkey.io/trigger

curl -X POST "https://api-v2.voicemonkey.io/trigger" \\
  -H "Authorization: $VOICEMONKEY_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "device": "YOUR_TRIGGER_DEVICE_ID"
  }'

ParameterRequiredDescriptiontokenYes*Secret token (*or use Authorization header)deviceYesTrigger Device ID from Voice Monkey console

### Flows Trigger API

Start Voice Monkey Flows.

Endpoint: https://api-v2.voicemonkey.io/flows

curl -X POST "https://api-v2.voicemonkey.io/flows" \\
  -H "Authorization: $VOICEMONKEY_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "device": "YOUR_DEVICE_ID",
    "flow": 12345
  }'

ParameterRequiredDescriptiontokenYes*Secret token (*or use Authorization header)deviceYesDevice IDflowYesNumeric Flow ID from Voice Monkey console

### Images

Most common formats supported (JPG, PNG, etc.)
No animated GIFs
Optimize file size for faster loading
Must be hosted at HTTPS URL with valid SSL
CORS must allow wildcard: Access-Control-Allow-Origin: *

### Videos

MP4 format only (MPEG-4 Part-14)
Audio codecs: AAC, MP3
Max resolution: 1080p @30fps or @60fps
Must be hosted at HTTPS URL with valid SSL

### Audio

Formats: AAC, MP3, OGG, Opus, WAV
Bit rate: ≤ 1411.20 kbps
Sample rate: ≤ 48kHz
File size: ≤ 10MB
Total response length: ≤ 240 seconds

### SSML Examples

Use SSML in the text parameter for richer announcements:

<speak>
  <amazon:emotion name="excited" intensity="high">
    This is exciting news!
  </amazon:emotion>
</speak>

<speak>
  The time is <say-as interpret-as="time">3:30pm</say-as>
</speak>

### Notes

Keep your token secure; rotate via Console → Settings → API Credentials if compromised
Use the API Playground to test and explore options
Premium members can upload media directly in the Voice Monkey console
Always confirm before sending announcements to avoid unexpected noise
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: jayakumark
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T17:44:23.761Z
- Expires at: 2026-05-17T17:44:23.761Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/voicemonkey)
- [Send to Agent page](https://openagent3.xyz/skills/voicemonkey/agent)
- [JSON manifest](https://openagent3.xyz/skills/voicemonkey/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/voicemonkey/agent.md)
- [Download page](https://openagent3.xyz/downloads/voicemonkey)