mirror of
https://github.com/openclaw/openclaw.git
synced 2026-06-07 04:52:52 +00:00
f94512cd7f
Adds Xiaomi MiMo voicedesign TTS support by registering the v2.5 voicedesign model and omitting audio.voice for that model's prompt-driven voice design flow.
Also accepts generic TTS aliases modelId, speakerVoice, and speakerVoiceId for Xiaomi provider config and request overrides.
Fixes exec timeout classification so a process that exits after a missed timeout callback is still reported as timed out, using monotonic deadlines to avoid wall-clock skew.
Verification:
- node scripts/run-vitest.mjs extensions/xiaomi/speech-provider.test.ts
- node scripts/run-vitest.mjs src/process/supervisor/supervisor.test.ts
- node scripts/run-vitest.mjs src/agents/bash-tools.exec-foreground-failures.test.ts
- git diff --check
- autoreview --mode local
- live Xiaomi MiMo voicedesign call returned wav RIFF/WAVE output, 169004 bytes
- GitHub CI success on fb3018ef31: CI 26708919072, CodeQL Critical Quality 26708919082, CodeQL 26708919091, OpenGrep PR Diff 26708919089, Workflow Sanity 26708919083, Dependency Guard 26708918574, Real behavior proof 26708921767
Thanks @GimingRao.
Co-authored-by: Raoyu <2425198313@qq.com>
Co-authored-by: giming <53329020+GimingRao@users.noreply.github.com>
287 lines
11 KiB
Markdown
287 lines
11 KiB
Markdown
---
|
|
summary: "Use Xiaomi MiMo pay-as-you-go and Token Plan models with OpenClaw"
|
|
read_when:
|
|
- You want Xiaomi MiMo models in OpenClaw
|
|
- You need Xiaomi MiMo auth or Token Plan setup
|
|
title: "Xiaomi MiMo"
|
|
---
|
|
|
|
Xiaomi MiMo is the API platform for **MiMo** models. OpenClaw includes a bundled Xiaomi plugin with two text-provider presets:
|
|
|
|
- `xiaomi` for pay-as-you-go keys (`sk-...`)
|
|
- `xiaomi-token-plan` for Token Plan keys (`tp-...`) with regional endpoint presets
|
|
|
|
The same plugin also registers the `xiaomi` speech (TTS) provider.
|
|
|
|
| Property | Value |
|
|
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| Provider ids | `xiaomi` (pay-as-you-go), `xiaomi-token-plan` (Token Plan) |
|
|
| Plugin | bundled, `enabledByDefault: true` |
|
|
| Auth env vars | `XIAOMI_API_KEY`, `XIAOMI_TOKEN_PLAN_API_KEY` |
|
|
| Onboarding flags | `--auth-choice xiaomi-api-key`, `--auth-choice xiaomi-token-plan-cn`, `--auth-choice xiaomi-token-plan-sgp`, `--auth-choice xiaomi-token-plan-ams` |
|
|
| Direct CLI flags | `--xiaomi-api-key <key>`, `--xiaomi-token-plan-api-key <key>` |
|
|
| Contracts | chat completions + `speechProviders` |
|
|
| API | OpenAI-compatible (`openai-completions`) |
|
|
| Base URLs | Pay-as-you-go: `https://api.xiaomimimo.com/v1`; Token Plan presets: `token-plan-{cn,sgp,ams}...` |
|
|
| Default models | `xiaomi/mimo-v2-flash`, `xiaomi-token-plan/mimo-v2.5-pro` |
|
|
| TTS default | `mimo-v2.5-tts`, voice `mimo_default`; voicedesign model `mimo-v2.5-tts-voicedesign` |
|
|
|
|
## Getting started
|
|
|
|
<Steps>
|
|
<Step title="Get the right key">
|
|
Create a pay-as-you-go key in the [Xiaomi MiMo console](https://platform.xiaomimimo.com/#/console/api-keys), or open your Token Plan subscription page and copy the regional OpenAI-compatible base URL plus the matching `tp-...` key.
|
|
</Step>
|
|
|
|
<Step title="Run onboarding">
|
|
Pay-as-you-go:
|
|
|
|
```bash
|
|
openclaw onboard --auth-choice xiaomi-api-key
|
|
```
|
|
|
|
Token Plan:
|
|
|
|
```bash
|
|
openclaw onboard --auth-choice xiaomi-token-plan-sgp
|
|
```
|
|
|
|
Or pass the keys directly:
|
|
|
|
```bash
|
|
openclaw onboard --auth-choice xiaomi-api-key --xiaomi-api-key "$XIAOMI_API_KEY"
|
|
openclaw onboard --auth-choice xiaomi-token-plan-sgp --xiaomi-token-plan-api-key "$XIAOMI_TOKEN_PLAN_API_KEY"
|
|
```
|
|
|
|
</Step>
|
|
<Step title="Verify the model is available">
|
|
```bash
|
|
openclaw models list --provider xiaomi
|
|
openclaw models list --provider xiaomi-token-plan
|
|
```
|
|
</Step>
|
|
</Steps>
|
|
|
|
## Pay-as-you-go catalog
|
|
|
|
| Model ref | Input | Context | Max output | Reasoning | Notes |
|
|
| ---------------------- | ----------- | --------- | ---------- | --------- | ------------- |
|
|
| `xiaomi/mimo-v2-flash` | text | 262,144 | 8,192 | No | Default model |
|
|
| `xiaomi/mimo-v2-pro` | text | 1,048,576 | 32,000 | Yes | Large context |
|
|
| `xiaomi/mimo-v2-omni` | text, image | 262,144 | 32,000 | Yes | Multimodal |
|
|
|
|
<Tip>
|
|
The default model ref is `xiaomi/mimo-v2-flash`. The provider is injected automatically when `XIAOMI_API_KEY` is set or an auth profile exists.
|
|
</Tip>
|
|
|
|
## Token Plan catalog
|
|
|
|
Choose the Token Plan auth choice that matches the regional base URL shown in Xiaomi's subscription UI:
|
|
|
|
- `xiaomi-token-plan-cn` -> `https://token-plan-cn.xiaomimimo.com/v1`
|
|
- `xiaomi-token-plan-sgp` -> `https://token-plan-sgp.xiaomimimo.com/v1`
|
|
- `xiaomi-token-plan-ams` -> `https://token-plan-ams.xiaomimimo.com/v1`
|
|
|
|
| Model ref | Input | Context | Max output | Reasoning | Notes |
|
|
| --------------------------------- | ----------- | --------- | ---------- | --------- | ------------- |
|
|
| `xiaomi-token-plan/mimo-v2.5-pro` | text | 1,048,576 | 32,000 | Yes | Default model |
|
|
| `xiaomi-token-plan/mimo-v2.5` | text, image | 1,048,576 | 32,000 | Yes | Multimodal |
|
|
|
|
<Tip>
|
|
Token Plan onboarding validates the key shape and warns when a `tp-...` key is entered into the pay-as-you-go path, or an `sk-...` key is entered into the Token Plan path.
|
|
</Tip>
|
|
|
|
## Text-to-speech
|
|
|
|
The bundled `xiaomi` plugin also registers Xiaomi MiMo as a speech provider for
|
|
`messages.tts`. It calls Xiaomi's chat-completions TTS contract with the text as
|
|
an `assistant` message and optional style guidance as a `user` message.
|
|
|
|
| Property | Value |
|
|
| -------- | ---------------------------------------- |
|
|
| TTS id | `xiaomi` (`mimo` alias) |
|
|
| Auth | `XIAOMI_API_KEY` |
|
|
| API | `POST /v1/chat/completions` with `audio` |
|
|
| Default | `mimo-v2.5-tts`, voice `mimo_default` |
|
|
| Output | MP3 by default; WAV when configured |
|
|
|
|
```json5
|
|
{
|
|
messages: {
|
|
tts: {
|
|
auto: "always",
|
|
provider: "xiaomi",
|
|
providers: {
|
|
xiaomi: {
|
|
apiKey: "xiaomi_api_key",
|
|
model: "mimo-v2.5-tts",
|
|
speakerVoice: "mimo_default",
|
|
format: "mp3",
|
|
style: "Bright, natural, conversational tone.",
|
|
},
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
Supported built-in voices include `mimo_default`, `default_zh`, `default_en`,
|
|
`Mia`, `Chloe`, `Milo`, and `Dean`. Preset-voice models use `audio.voice`, so
|
|
OpenClaw sends `speakerVoice` for `mimo-v2.5-tts` and `mimo-v2-tts`.
|
|
|
|
Xiaomi's voicedesign model, `mimo-v2.5-tts-voicedesign`, generates the voice
|
|
from a natural-language style prompt instead of a preset voice id. Configure
|
|
`style` with the desired voice description; OpenClaw sends it as the `user`
|
|
message, sends the spoken text as the `assistant` message, and omits
|
|
`audio.voice` for this model.
|
|
|
|
```json5
|
|
{
|
|
messages: {
|
|
tts: {
|
|
provider: "xiaomi",
|
|
providers: {
|
|
xiaomi: {
|
|
model: "mimo-v2.5-tts-voicedesign",
|
|
format: "wav",
|
|
style: "Warm, natural female voice with clear pronunciation.",
|
|
},
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
For voice-note targets such as Feishu and Telegram, OpenClaw transcodes Xiaomi
|
|
output to 48kHz Opus with `ffmpeg` before delivery.
|
|
|
|
## Config example
|
|
|
|
```json5
|
|
{
|
|
env: { XIAOMI_API_KEY: "your-key" },
|
|
agents: { defaults: { model: { primary: "xiaomi/mimo-v2-flash" } } },
|
|
models: {
|
|
mode: "merge",
|
|
providers: {
|
|
xiaomi: {
|
|
baseUrl: "https://api.xiaomimimo.com/v1",
|
|
api: "openai-completions",
|
|
apiKey: "XIAOMI_API_KEY",
|
|
models: [
|
|
{
|
|
id: "mimo-v2-flash",
|
|
name: "Xiaomi MiMo V2 Flash",
|
|
reasoning: false,
|
|
input: ["text"],
|
|
contextWindow: 262144,
|
|
maxTokens: 8192,
|
|
},
|
|
{
|
|
id: "mimo-v2-pro",
|
|
name: "Xiaomi MiMo V2 Pro",
|
|
reasoning: true,
|
|
input: ["text"],
|
|
contextWindow: 1048576,
|
|
maxTokens: 32000,
|
|
},
|
|
{
|
|
id: "mimo-v2-omni",
|
|
name: "Xiaomi MiMo V2 Omni",
|
|
reasoning: true,
|
|
input: ["text", "image"],
|
|
contextWindow: 262144,
|
|
maxTokens: 32000,
|
|
},
|
|
],
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
Pricing and compat flags come from the bundled plugin manifest, so the config example omits `cost` and `compat` to avoid diverging from runtime behavior.
|
|
|
|
Token Plan:
|
|
|
|
```json5
|
|
{
|
|
env: { XIAOMI_TOKEN_PLAN_API_KEY: "tp-your-key" },
|
|
agents: { defaults: { model: { primary: "xiaomi-token-plan/mimo-v2.5-pro" } } },
|
|
models: {
|
|
mode: "merge",
|
|
providers: {
|
|
"xiaomi-token-plan": {
|
|
baseUrl: "https://token-plan-sgp.xiaomimimo.com/v1",
|
|
api: "openai-completions",
|
|
apiKey: "XIAOMI_TOKEN_PLAN_API_KEY",
|
|
models: [
|
|
{
|
|
id: "mimo-v2.5-pro",
|
|
name: "Xiaomi MiMo V2.5 Pro",
|
|
reasoning: true,
|
|
input: ["text"],
|
|
contextWindow: 1048576,
|
|
maxTokens: 32000,
|
|
},
|
|
{
|
|
id: "mimo-v2.5",
|
|
name: "Xiaomi MiMo V2.5",
|
|
reasoning: true,
|
|
input: ["text", "image"],
|
|
contextWindow: 1048576,
|
|
maxTokens: 32000,
|
|
},
|
|
],
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
Pricing comes from the bundled manifest (Token Plan models include tiered cache-read pricing), so the config example omits `cost`.
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="Auto-injection behavior">
|
|
The `xiaomi` provider is injected automatically when `XIAOMI_API_KEY` is set in your environment or an auth profile exists. `xiaomi-token-plan` needs a regional base URL, so the supported path is the bundled Token Plan onboarding choice or an explicit `models.providers.xiaomi-token-plan` config block.
|
|
</Accordion>
|
|
|
|
<Accordion title="Model details">
|
|
- **mimo-v2-flash** — lightweight and fast, ideal for general-purpose text tasks. No reasoning support.
|
|
- **mimo-v2-pro** — supports reasoning with a 1M token context window for long-document workloads.
|
|
- **mimo-v2-omni** — reasoning-enabled multimodal model that accepts both text and image inputs.
|
|
- **mimo-v2.5-pro** — Token Plan default with Xiaomi's current V2.5 reasoning stack.
|
|
- **mimo-v2.5** — Token Plan multimodal V2.5 route.
|
|
|
|
<Note>
|
|
Pay-as-you-go models use the `xiaomi/` prefix. Token Plan models use the `xiaomi-token-plan/` prefix.
|
|
</Note>
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="Troubleshooting">
|
|
- If models do not appear, confirm the relevant key env var or auth profile is present and valid.
|
|
- For Token Plan, confirm the chosen onboarding region matches the subscription page base URL and that the key starts with `tp-`.
|
|
- When the Gateway runs as a daemon, ensure the key is available to that process (for example in `~/.openclaw/.env` or via `env.shellEnv`).
|
|
|
|
<Warning>
|
|
Keys set only in your interactive shell are not visible to daemon-managed gateway processes. Use `~/.openclaw/.env` or `env.shellEnv` config for persistent availability.
|
|
</Warning>
|
|
|
|
</Accordion>
|
|
</AccordionGroup>
|
|
|
|
## Related
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="Model selection" href="/concepts/model-providers" icon="layers">
|
|
Choosing providers, model refs, and failover behavior.
|
|
</Card>
|
|
<Card title="Configuration reference" href="/gateway/configuration-reference" icon="gear">
|
|
Full OpenClaw configuration reference.
|
|
</Card>
|
|
<Card title="Xiaomi MiMo console" href="https://platform.xiaomimimo.com" icon="arrow-up-right-from-square">
|
|
Xiaomi MiMo dashboard and API key management.
|
|
</Card>
|
|
</CardGroup>
|