{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/voicemonkey",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voicemonkey",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-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/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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/voicemonkey",
    "agentPageUrl": "https://openagent3.xyz/skills/voicemonkey/agent",
    "manifestUrl": "https://openagent3.xyz/skills/voicemonkey/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/voicemonkey/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "VoiceMonkey",
        "body": "Control Alexa/Echo devices via VoiceMonkey API v2. Make TTS announcements, trigger Alexa routines, start flows, and display images/videos on Echo Show devices."
      },
      {
        "title": "Setup",
        "body": "Get your secret token from Voice Monkey Console → Settings → API Credentials\nSet environment variable:\nexport VOICEMONKEY_TOKEN=\"your-secret-token\"\n\nOr add to ~/.clawdbot/clawdbot.json:\n{\n  \"skills\": {\n    \"entries\": {\n      \"voicemonkey\": {\n        \"env\": { \"VOICEMONKEY_TOKEN\": \"your-secret-token\" }\n      }\n    }\n  }\n}\n\n\nFind your Device IDs in the Voice Monkey Console → Settings → Devices"
      },
      {
        "title": "API Base URL",
        "body": "https://api-v2.voicemonkey.io"
      },
      {
        "title": "Announcement API",
        "body": "Make TTS announcements, play audio/video, or display images on Alexa devices.\n\nEndpoint: https://api-v2.voicemonkey.io/announcement"
      },
      {
        "title": "Basic TTS Announcement",
        "body": "curl -X GET \"https://api-v2.voicemonkey.io/announcement?token=$VOICEMONKEY_TOKEN&device=YOUR_DEVICE_ID&text=Hello%20from%20Echo\""
      },
      {
        "title": "With Authorization Header (recommended)",
        "body": "curl -X POST \"https://api-v2.voicemonkey.io/announcement\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"text\": \"Hello from Echo the Fox!\"\n  }'"
      },
      {
        "title": "With Voice and Chime",
        "body": "curl -X POST \"https://api-v2.voicemonkey.io/announcement\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"text\": \"Dinner is ready!\",\n    \"voice\": \"Brian\",\n    \"chime\": \"soundbank://soundlibrary/alarms/beeps_and_bloops/bell_02\"\n  }'"
      },
      {
        "title": "Display Image on Echo Show",
        "body": "curl -X POST \"https://api-v2.voicemonkey.io/announcement\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"text\": \"Check out this image\",\n    \"image\": \"https://example.com/image.jpg\",\n    \"media_width\": \"100\",\n    \"media_height\": \"100\",\n    \"media_scaling\": \"best-fit\"\n  }'"
      },
      {
        "title": "Play Audio File",
        "body": "curl -X POST \"https://api-v2.voicemonkey.io/announcement\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"audio\": \"https://example.com/sound.mp3\"\n  }'"
      },
      {
        "title": "Play Video on Echo Show",
        "body": "curl -X POST \"https://api-v2.voicemonkey.io/announcement\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"video\": \"https://example.com/video.mp4\",\n    \"video_repeat\": 1\n  }'"
      },
      {
        "title": "Open Website on Echo Show",
        "body": "curl -X POST \"https://api-v2.voicemonkey.io/announcement\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"website\": \"https://example.com\",\n    \"no_bg\": \"true\"\n  }'"
      },
      {
        "title": "Announcement Parameters",
        "body": "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"
      },
      {
        "title": "Routine Trigger API",
        "body": "Trigger Voice Monkey devices to start Alexa Routines.\n\nEndpoint: https://api-v2.voicemonkey.io/trigger\n\ncurl -X POST \"https://api-v2.voicemonkey.io/trigger\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_TRIGGER_DEVICE_ID\"\n  }'\n\nParameterRequiredDescriptiontokenYes*Secret token (*or use Authorization header)deviceYesTrigger Device ID from Voice Monkey console"
      },
      {
        "title": "Flows Trigger API",
        "body": "Start Voice Monkey Flows.\n\nEndpoint: https://api-v2.voicemonkey.io/flows\n\ncurl -X POST \"https://api-v2.voicemonkey.io/flows\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"flow\": 12345\n  }'\n\nParameterRequiredDescriptiontokenYes*Secret token (*or use Authorization header)deviceYesDevice IDflowYesNumeric Flow ID from Voice Monkey console"
      },
      {
        "title": "Images",
        "body": "Most common formats supported (JPG, PNG, etc.)\nNo animated GIFs\nOptimize file size for faster loading\nMust be hosted at HTTPS URL with valid SSL\nCORS must allow wildcard: Access-Control-Allow-Origin: *"
      },
      {
        "title": "Videos",
        "body": "MP4 format only (MPEG-4 Part-14)\nAudio codecs: AAC, MP3\nMax resolution: 1080p @30fps or @60fps\nMust be hosted at HTTPS URL with valid SSL"
      },
      {
        "title": "Audio",
        "body": "Formats: AAC, MP3, OGG, Opus, WAV\nBit rate: ≤ 1411.20 kbps\nSample rate: ≤ 48kHz\nFile size: ≤ 10MB\nTotal response length: ≤ 240 seconds"
      },
      {
        "title": "SSML Examples",
        "body": "Use SSML in the text parameter for richer announcements:\n\n<speak>\n  <amazon:emotion name=\"excited\" intensity=\"high\">\n    This is exciting news!\n  </amazon:emotion>\n</speak>\n\n<speak>\n  The time is <say-as interpret-as=\"time\">3:30pm</say-as>\n</speak>"
      },
      {
        "title": "Notes",
        "body": "Keep your token secure; rotate via Console → Settings → API Credentials if compromised\nUse the API Playground to test and explore options\nPremium members can upload media directly in the Voice Monkey console\nAlways confirm before sending announcements to avoid unexpected noise"
      }
    ],
    "body": "VoiceMonkey\n\nControl Alexa/Echo devices via VoiceMonkey API v2. Make TTS announcements, trigger Alexa routines, start flows, and display images/videos on Echo Show devices.\n\nSetup\nGet your secret token from Voice Monkey Console → Settings → API Credentials\nSet environment variable:\nexport VOICEMONKEY_TOKEN=\"your-secret-token\"\n\nOr add to ~/.clawdbot/clawdbot.json:\n{\n  \"skills\": {\n    \"entries\": {\n      \"voicemonkey\": {\n        \"env\": { \"VOICEMONKEY_TOKEN\": \"your-secret-token\" }\n      }\n    }\n  }\n}\n\nFind your Device IDs in the Voice Monkey Console → Settings → Devices\nAPI Base URL\nhttps://api-v2.voicemonkey.io\n\nAnnouncement API\n\nMake TTS announcements, play audio/video, or display images on Alexa devices.\n\nEndpoint: https://api-v2.voicemonkey.io/announcement\n\nBasic TTS Announcement\ncurl -X GET \"https://api-v2.voicemonkey.io/announcement?token=$VOICEMONKEY_TOKEN&device=YOUR_DEVICE_ID&text=Hello%20from%20Echo\"\n\nWith Authorization Header (recommended)\ncurl -X POST \"https://api-v2.voicemonkey.io/announcement\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"text\": \"Hello from Echo the Fox!\"\n  }'\n\nWith Voice and Chime\ncurl -X POST \"https://api-v2.voicemonkey.io/announcement\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"text\": \"Dinner is ready!\",\n    \"voice\": \"Brian\",\n    \"chime\": \"soundbank://soundlibrary/alarms/beeps_and_bloops/bell_02\"\n  }'\n\nDisplay Image on Echo Show\ncurl -X POST \"https://api-v2.voicemonkey.io/announcement\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"text\": \"Check out this image\",\n    \"image\": \"https://example.com/image.jpg\",\n    \"media_width\": \"100\",\n    \"media_height\": \"100\",\n    \"media_scaling\": \"best-fit\"\n  }'\n\nPlay Audio File\ncurl -X POST \"https://api-v2.voicemonkey.io/announcement\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"audio\": \"https://example.com/sound.mp3\"\n  }'\n\nPlay Video on Echo Show\ncurl -X POST \"https://api-v2.voicemonkey.io/announcement\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"video\": \"https://example.com/video.mp4\",\n    \"video_repeat\": 1\n  }'\n\nOpen Website on Echo Show\ncurl -X POST \"https://api-v2.voicemonkey.io/announcement\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"website\": \"https://example.com\",\n    \"no_bg\": \"true\"\n  }'\n\nAnnouncement Parameters\nParameter\tRequired\tDescription\ntoken\tYes*\tSecret token (*or use Authorization header)\ndevice\tYes\tDevice ID from Voice Monkey console\ntext\tNo\tTTS text (supports SSML)\nvoice\tNo\tVoice for TTS (see API Playground for options)\nlanguage\tNo\tLanguage code for better pronunciation\nchime\tNo\tSound URL or Alexa sound library reference\naudio\tNo\tHTTPS URL of audio file to play\nbackground_audio\tNo\tAudio to play behind TTS\nimage\tNo\tHTTPS URL of image for Echo Show\nvideo\tNo\tHTTPS URL of MP4 video for Echo Show\nvideo_repeat\tNo\tNumber of times to loop video\nwebsite\tNo\tURL to open on Echo Show\nno_bg\tNo\tSet \"true\" to hide Voice Monkey branding\nmedia_width\tNo\tImage width\nmedia_height\tNo\tImage height\nmedia_scaling\tNo\tImage scaling mode\nmedia_align\tNo\tImage alignment\nmedia_radius\tNo\tCorner radius for image clipping\nvar-[name]\tNo\tUpdate Voice Monkey variables\nRoutine Trigger API\n\nTrigger Voice Monkey devices to start Alexa Routines.\n\nEndpoint: https://api-v2.voicemonkey.io/trigger\n\ncurl -X POST \"https://api-v2.voicemonkey.io/trigger\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_TRIGGER_DEVICE_ID\"\n  }'\n\nParameter\tRequired\tDescription\ntoken\tYes*\tSecret token (*or use Authorization header)\ndevice\tYes\tTrigger Device ID from Voice Monkey console\nFlows Trigger API\n\nStart Voice Monkey Flows.\n\nEndpoint: https://api-v2.voicemonkey.io/flows\n\ncurl -X POST \"https://api-v2.voicemonkey.io/flows\" \\\n  -H \"Authorization: $VOICEMONKEY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"device\": \"YOUR_DEVICE_ID\",\n    \"flow\": 12345\n  }'\n\nParameter\tRequired\tDescription\ntoken\tYes*\tSecret token (*or use Authorization header)\ndevice\tYes\tDevice ID\nflow\tYes\tNumeric Flow ID from Voice Monkey console\nMedia Requirements\nImages\nMost common formats supported (JPG, PNG, etc.)\nNo animated GIFs\nOptimize file size for faster loading\nMust be hosted at HTTPS URL with valid SSL\nCORS must allow wildcard: Access-Control-Allow-Origin: *\nVideos\nMP4 format only (MPEG-4 Part-14)\nAudio codecs: AAC, MP3\nMax resolution: 1080p @30fps or @60fps\nMust be hosted at HTTPS URL with valid SSL\nAudio\nFormats: AAC, MP3, OGG, Opus, WAV\nBit rate: ≤ 1411.20 kbps\nSample rate: ≤ 48kHz\nFile size: ≤ 10MB\nTotal response length: ≤ 240 seconds\nSSML Examples\n\nUse SSML in the text parameter for richer announcements:\n\n<speak>\n  <amazon:emotion name=\"excited\" intensity=\"high\">\n    This is exciting news!\n  </amazon:emotion>\n</speak>\n\n<speak>\n  The time is <say-as interpret-as=\"time\">3:30pm</say-as>\n</speak>\n\nNotes\nKeep your token secure; rotate via Console → Settings → API Credentials if compromised\nUse the API Playground to test and explore options\nPremium members can upload media directly in the Voice Monkey console\nAlways confirm before sending announcements to avoid unexpected noise"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/jayakumark/voicemonkey",
    "publisherUrl": "https://clawhub.ai/jayakumark/voicemonkey",
    "owner": "jayakumark",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}