# Send mmEasyVoice 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": "mm-easy-voice",
    "name": "mmEasyVoice",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/BLUE-coconut/mm-easy-voice",
    "canonicalUrl": "https://clawhub.ai/BLUE-coconut/mm-easy-voice",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/mm-easy-voice",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mm-easy-voice",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "check_environment.py",
      "mmvoice.py",
      "reference/audio-guide.md",
      "reference/getting-started.md",
      "reference/troubleshooting.md"
    ],
    "downloadMode": "redirect",
    "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/mm-easy-voice"
    },
    "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/mm-easy-voice",
    "downloadUrl": "https://openagent3.xyz/downloads/mm-easy-voice",
    "agentUrl": "https://openagent3.xyz/skills/mm-easy-voice/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mm-easy-voice/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mm-easy-voice/agent.md"
  }
}
```
## Documentation

### MiniMax Easy Voice

Simple text-to-speech skill powered by MiniMax Voice API. Converts any text into natural-sounding audio with customizable voice selection.

### [Step 1] Preparation

IMPORTANT: Before using this skill, always verify the environment:

python check_environment.py

If API key is not set:

export MINIMAX_VOICE_API_KEY="your-api-key-here"

Requirements:

Python 3.8+
MINIMAX_VOICE_API_KEY environment variable (required)
FFmpeg (optional, for audio merging/conversion)

### [Step 2] Generate speech audio from text

Convert any text to speech in one command:

# Default voice (male-qn-qingse)
python mmvoice.py tts "Hello, this is a test." -o test.mp3

# Chinese text
python mmvoice.py tts "你好，这是一个测试。" -o test_cn.mp3

# Specify a different voice by "-v voice_id"
python mmvoice.py tts "Hello world" -v female-shaonv -o hello.mp3

# Specify output path
python mmvoice.py tts "Your text" -o /path/to/output.mp3

Required parameters:

text: The text you want to convert to speech
-o OUTPUT: Output audio file path (required)

Optional parameters:

-v VOICE_ID: Voice to use (default: male-qn-qingse)

### Usage Details

Text length limits:

Up to 10,000 characters per request
For longer text, split into multiple requests and merge later

Pause insertion: Use <#x#> where x = pause duration in seconds

Example: "Hello<#1.5#>world" = 1.5 second pause between words
Range: 0.01 to 99.99 seconds

Emotion matching: speech-2.8 models automatically match emotions to your text content

### Voice Selection

Choose the right voice for your content by consulting the voice catalog:

# List all available voices
python mmvoice.py list-voices

Voice catalog: reference/voice_catalog.md

Contains:

All available system voices (male, female)
Voice characteristics and recommended use cases
How to select the right voice for your content

### Voice Management

List available voices:

python mmvoice.py list-voices

Clone a voice from audio sample:

python mmvoice.py clone audio_file.mp3 --voice-id my-custom-voice

Design a voice from description:

python mmvoice.py design "A warm, gentle female voice" --voice-id designed-voice

### Audio Processing

Merge multiple audio files:

python mmvoice.py merge file1.mp3 file2.mp3 file3.mp3 -o combined.mp3

Convert audio format:

python mmvoice.py convert input.wav -o output.mp3 --format mp3

### Reference Documents

Open these when needed for more details:

|| Document | When to Use |
||----------|-------------|
|| reference/voice_catalog.md | Choosing a voice_id |
|| reference/getting-started.md | Environment setup |
|| reference/audio-guide.md | Audio processing |
|| reference/voice-guide.md | Voice cloning and design |
|| reference/troubleshooting.md | Common issues and solutions |

### Troubleshooting

Common issues:

API key not set: Run export MINIMAX_VOICE_API_KEY="your-key"
FFmpeg missing: Install with brew install ffmpeg (macOS) or sudo apt install ffmpeg (Ubuntu)
Voice not found: Use python mmvoice.py list-voices to see available voices

Run environment check:

python check_environment.py

See reference/troubleshooting.md for more solutions.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: BLUE-coconut
- Version: 1.0.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-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/mm-easy-voice)
- [Send to Agent page](https://openagent3.xyz/skills/mm-easy-voice/agent)
- [JSON manifest](https://openagent3.xyz/skills/mm-easy-voice/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/mm-easy-voice/agent.md)
- [Download page](https://openagent3.xyz/downloads/mm-easy-voice)