什么是 VoiceMonkey？

VoiceMonkey 是一款强大的技能，专为希望将 Amazon Alexa 功能集成到自动化工作流中的开发人员而设计。通过利用 VoiceMonkey API v2，此 Openclaw Skills 集成允许用户发送 TTS 公告、在 Echo Show 设备上播放高质量音频或视频，甚至以编程方式触发复杂的 Alexa 常规操作。它充当外部应用程序与 Alexa 生态系统之间的关键链路，提供了一种无缝的方式来广播通知或管理智能家居环境，而无需手动干预。

无论您是构建自定义监控仪表板还是自动化家庭通知系统，此技能都提供了与 Echo 设备交互所需的端点。通过利用 Openclaw Skills，开发人员可以轻松地将基于语音的反馈包含到其 CLI 工具和代理工作流中，从而比以往任何时候都更容易为数字触发器带来物理存在感。

下载入口:https://github.com/openclaw/skills/tree/main/skills/jayakumark/voicemonkey

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

VoiceMonkey 应用场景

• 为服务器警报或 CI/CD 构建状态发送自动语音通知。
• 根据外部 API 事件触发智能家居常规操作（例如，开灯）。
• 在 Echo Show 设备上显示实时安全摄像头画面或静态图像。
• 直接从终端或脚本广播“晚餐准备好了”或其他家庭公告。
• 在特定触发期间在启用 Alexa 的屏幕上自动打开特定网站或仪表板。

1. 用户通过 Openclaw Skills 环境提供 VoiceMonkey API 令牌和目标设备 ID 进行身份验证。
2. 向 VoiceMonkey API v2 端点（如 /announcement、/trigger 或 /flows）发送请求。
3. API 验证安全令牌并将命令路由到与用户帐户关联的指定 Amazon Echo 设备。
4. Echo 设备执行请求的操作，其中可以包括朗读 TTS、播放媒体文件或启动 Alexa 常规操作。
5. 对于 Echo Show 设备，该技能处理图像、视频和网站的特定媒体渲染要求，以确保兼容播放。

VoiceMonkey 配置指南

1. 从 Voice Monkey 控制台 的 设置 > API 凭据 下获取您的秘密令牌。
2. 配置您的环境变量以允许 Openclaw Skills 访问 API：

export VOICEMONKEY_TOKEN="your-secret-token"

3. 或者，将配置添加到本地 clawdbot.json 文件中：

{
  "skills": {
    "entries": {
      "voicemonkey": {
        "env": { "VOICEMONKEY_TOKEN": "your-secret-token" }
      }
    }
  }
}

4. 在 Voice Monkey 控制台的 设置 > 设备 下找到您的设备 ID，以定位特定的 Echo 硬件。

VoiceMonkey 数据架构与分类体系

该技能利用结构化参数集与 VoiceMonkey API 进行交互。数据组织如下：

name: voicemonkey
description: Control Alexa devices via VoiceMonkey API v2 - make announcements, trigger routines, start flows, and display media.
homepage: https://voicemonkey.io
metadata: {"clawdbot":{"emoji":"??","requires":{"env":["VOICEMONKEY_TOKEN"]},"primaryEnv":"VOICEMONKEY_TOKEN"}}

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

1. Get your secret token from Voice Monkey Console → Settings → API Credentials
2. Set environment variable:

   export VOICEMONKEY_TOKEN="your-secret-token"
   

   Or add to ~/.clawdbot/clawdbot.json:

   {
     "skills": {
       "entries": {
         "voicemonkey": {
           "env": { "VOICEMONKEY_TOKEN": "your-secret-token" }
         }
       }
     }
   }
   

3. 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" r
  -H "Authorization: $VOICEMONKEY_TOKEN" r
  -H "Content-Type: application/json" r
  -d '{
    "device": "YOUR_DEVICE_ID",
    "text": "Hello from Echo the Fox!"
  }'

With Voice and Chime

curl -X POST "https://api-v2.voicemonkey.io/announcement" r
  -H "Authorization: $VOICEMONKEY_TOKEN" r
  -H "Content-Type: application/json" r
  -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" r
  -H "Authorization: $VOICEMONKEY_TOKEN" r
  -H "Content-Type: application/json" r
  -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" r
  -H "Authorization: $VOICEMONKEY_TOKEN" r
  -H "Content-Type: application/json" r
  -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" r
  -H "Authorization: $VOICEMONKEY_TOKEN" r
  -H "Content-Type: application/json" r
  -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" r
  -H "Authorization: $VOICEMONKEY_TOKEN" r
  -H "Content-Type: application/json" r
  -d '{
    "device": "YOUR_DEVICE_ID",
    "website": "https://example.com",
    "no_bg": "true"
  }'

Announcement Parameters

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" r
  -H "Authorization: $VOICEMONKEY_TOKEN" r
  -H "Content-Type: application/json" r
  -d '{
    "device": "YOUR_TRIGGER_DEVICE_ID"
  }'

Flows Trigger API

Start Voice Monkey Flows.

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

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

Media Requirements

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:

  
    This is exciting news!
  

  The time is 3:30pm

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