openclaw - 💡(How to fix) Fix feat(tts): support MiMo v2.5 TTS VoiceDesign [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#72927Fetched 2026-04-28 06:30:10
View on GitHub
Comments
0
Participants
1
Timeline
0
Reactions
0
Author
Participants

Code Example

{
  "messages": {
    "tts": {
      "auto": "tagged",
      "provider": "xiaomi",
      "providers": {
        "xiaomi": {
          "apiKey": "${XIAOMI_API_KEY}",
          "model": "mimo-v2.5-tts",
          "voice": "Mia",
          "format": "mp3"
        }
      }
    }
  }
}

---

{
  "messages": {
    "tts": {
      "provider": "xiaomi",
      "providers": {
        "xiaomi": {
          "apiKey": "${XIAOMI_API_KEY}",
          "model": "mimo-v2.5-tts",
          "voiceDesign": {
            "prompt": "A warm, natural young female Chinese voice, soft but clear, conversational, not overly dramatic"
          },
          "format": "mp3"
        }
      }
    }
  }
}
RAW_BUFFERClick to expand / collapse

Feature request

Please add support for Xiaomi MiMo v2.5 TTS VoiceDesign in OpenClaw's TTS provider configuration.

Background

OpenClaw can already use the Xiaomi TTS provider with mimo-v2.5-tts and a fixed voice value, for example:

{
  "messages": {
    "tts": {
      "auto": "tagged",
      "provider": "xiaomi",
      "providers": {
        "xiaomi": {
          "apiKey": "${XIAOMI_API_KEY}",
          "model": "mimo-v2.5-tts",
          "voice": "Mia",
          "format": "mp3"
        }
      }
    }
  }
}

However, the built-in/preset voices can sound unnatural for some use cases. MiMo v2.5 TTS appears to support a VoiceDesign style/custom voice design capability, which would allow users to describe or configure a desired voice instead of only selecting one of the preset voice IDs.

Requested behavior

Allow OpenClaw's Xiaomi TTS provider to pass through MiMo v2.5 TTS VoiceDesign parameters from config, e.g. one of these shapes or a similar schema:

{
  "messages": {
    "tts": {
      "provider": "xiaomi",
      "providers": {
        "xiaomi": {
          "apiKey": "${XIAOMI_API_KEY}",
          "model": "mimo-v2.5-tts",
          "voiceDesign": {
            "prompt": "A warm, natural young female Chinese voice, soft but clear, conversational, not overly dramatic"
          },
          "format": "mp3"
        }
      }
    }
  }
}

or, if the upstream API expects a different request field name, expose a documented config field and map it internally.

Why this is useful

  • Preset voices like Mia may sound odd or unsuitable in real chat usage.
  • VoiceDesign would let users create a voice closer to their assistant persona or product tone.
  • It avoids requiring users to wait for new preset voices or hardcode custom API payloads outside OpenClaw.

Suggested implementation notes

  • Keep existing voice behavior unchanged for backward compatibility.
  • If voiceDesign is present, pass the VoiceDesign payload to the Xiaomi MiMo v2.5 TTS API request.
  • Validate/guard this feature to models that support it, such as mimo-v2.5-tts.
  • Document the config schema in the TTS docs/config reference.

Thanks!

extent analysis

TL;DR

To add support for Xiaomi MiMo v2.5 TTS VoiceDesign in OpenClaw's TTS provider configuration, modify the configuration to include a voiceDesign field and update the API request to pass this field to the Xiaomi MiMo v2.5 TTS API.

Guidance

  • Add a voiceDesign field to the TTS provider configuration, allowing users to describe their desired voice.
  • Update the API request to pass the voiceDesign payload to the Xiaomi MiMo v2.5 TTS API when the voiceDesign field is present.
  • Validate the voiceDesign feature to ensure it only works with supported models, such as mimo-v2.5-tts.
  • Document the new voiceDesign config field in the TTS documentation and config reference.

Example

{
  "messages": {
    "tts": {
      "provider": "xiaomi",
      "providers": {
        "xiaomi": {
          "apiKey": "${XIAOMI_API_KEY}",
          "model": "mimo-v2.5-tts",
          "voiceDesign": {
            "prompt": "A warm, natural young female Chinese voice, soft but clear, conversational, not overly dramatic"
          },
          "format": "mp3"
        }
      }
    }
  }
}

Notes

The implementation should ensure backward compatibility by keeping the existing voice behavior unchanged.

Recommendation

Apply workaround by adding the voiceDesign field to the configuration and updating the API request to pass this field to the Xiaomi MiMo v2.5 TTS API, as this allows users to create a custom voice without waiting for new preset voices.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix feat(tts): support MiMo v2.5 TTS VoiceDesign [1 participants]