Xiaomi MiMo

Xiaomi MiMo 是 MiMo 模型的 API 平台。OpenClaw 包含一个捆绑的 Xiaomi 插件，其中包含两个文本提供商预设：

xiaomi 用于按需付费密钥 (sk-...)
xiaomi-token-plan 用于 Token Plan 密钥 (tp-...)，附带区域端点预设

同一插件也注册了 xiaomi 语音 (TTS) 提供商。

属性	值
提供商 ID	`xiaomi` (按需付费)，`xiaomi-token-plan` (Token Plan)
插件	捆绑，`enabledByDefault: true`
认证环境变量	`XIAOMI_API_KEY`，`XIAOMI_TOKEN_PLAN_API_KEY`
新手引导标志	`--auth-choice xiaomi-api-key`，`--auth-choice xiaomi-token-plan-cn`，`--auth-choice xiaomi-token-plan-sgp`，`--auth-choice xiaomi-token-plan-ams`
直接 CLI 标志	`--xiaomi-api-key <key>`，`--xiaomi-token-plan-api-key <key>`
合约	聊天补全 + `speechProviders`
API	OpenAI 兼容 (`openai-completions`)
基础 URL	按需付费：`https://api.xiaomimimo.com/v1`；Token Plan 预设：`token-plan-{cn,sgp,ams}...`
默认模型	`xiaomi/mimo-v2-flash`，`xiaomi-token-plan/mimo-v2.5-pro`
TTS 默认	`mimo-v2.5-tts`，语音 `mimo_default`；语音设计模型 `mimo-v2.5-tts-voicedesign`

入门指南

获取正确的密钥
在 Xiaomi MiMo 控制台中创建按需付费密钥，或打开您的 Token Plan 订阅页面并复制区域 OpenAI 兼容的基础 URL 以及匹配的 tp-... 密钥。

运行新手引导

按需付费：

openclaw onboard --auth-choice xiaomi-api-key

Token Plan：

openclaw onboard --auth-choice xiaomi-token-plan-sgp

或直接传递密钥：

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"

验证模型是否可用

openclaw models list --provider xiaomi
openclaw models list --provider xiaomi-token-plan

按量付费目录

模型参考	输入	上下文	最大输出	推理	备注
`xiaomi/mimo-v2-flash`	文本	262,144	8,192	否	默认模型
`xiaomi/mimo-v2-pro`	文本	1,048,576	32,000	是	大上下文
`xiaomi/mimo-v2-omni`	文本, 图像	262,144	32,000	是	多模态

Token Plan 目录

选择与 Xiaomi 订阅界面中显示的区域基础 URL 相匹配的 Token Plan 身份验证选项：

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

模型引用	输入	上下文	最大输出	推理	备注
`xiaomi-token-plan/mimo-v2.5-pro`	文本	1,048,576	32,000	是	默认模型
`xiaomi-token-plan/mimo-v2.5`	文本、图像	1,048,576	32,000	是	多模态

文本转语音

捆绑的 xiaomi 插件还将 Xiaomi MiMo 注册为 messages.ttsXiaomi 的语音提供商。它调用 Xiaomi 的聊天补全 TTS 合同，将文本作为 assistant 消息，并将可选的风格指导作为 user 消息。

属性	值
TTS ID	`xiaomi` (`mimo` 别名)
身份验证	`XIAOMI_API_KEY`
API	`POST /v1/chat/completions` 配合 `audio`
默认	`mimo-v2.5-tts`，语音 `mimo_default`
输出	默认为 MP3；配置后为 WAV

{
  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.",
        },
      },
    },
  },
}

支持的内置语音包括 mimo_default、default_zh、default_en、 Mia、Chloe、Milo 和 Dean。预设语音模型使用 audio.voice，因此 OpenClaw 会为 mimo-v2.5-tts 发送 speakerVoice 以及 mimo-v2-tts。

Xiaomi 的 voicedesign 模型 Xiaomimimo-v2.5-tts-voicedesign 根据自然语言风格的提示词生成语音，而不是使用预设的语音 ID。使用所需的语音描述配置 styleOpenClaw；OpenClaw 将其作为 user 消息发送，将口语文本作为 assistant 消息发送，并针对此模型省略 audio.voice。

{
  messages: {
    tts: {
      provider: "xiaomi",
      providers: {
        xiaomi: {
          model: "mimo-v2.5-tts-voicedesign",
          format: "wav",
          style: "Warm, natural female voice with clear pronunciation.",
        },
      },
    },
  },
}

对于语音笔记目标（如飞书和 Telegram），OpenClaw 会在交付前使用 TelegramOpenClawXiaomiffmpeg 将 Xiaomi 输出转码为 48kHz Opus 格式。

配置示例

{
  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,
          },
        ],
      },
    },
  },
}

定价和兼容性标志来自捆绑的插件清单，因此配置示例省略了 cost 和 compat，以避免与运行时行为不一致。

Token Plan：

{
  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,
          },
        ],
      },
    },
  },
}

定价来自捆绑的清单（Token Plan 模型包括分层缓存读取定价），因此配置示例省略了 cost。

Auto-injection behavior

当在您的环境中设置了 XIAOMI_API_KEY 或存在身份验证配置文件时，xiaomi 提供商会自动注入。xiaomi-token-plan 需要区域性基础 URL，因此支持的路径是捆绑的 Token Plan 新手引导选择或显式的 models.providers.xiaomi-token-plan 配置块。

Model details

mimo-v2-flash — 轻量且快速，非常适合通用文本任务。不支持推理。
mimo-v2-pro — 支持推理，具有 1M token 上下文窗口，适用于长文档工作负载。
mimo-v2-omni — 支持推理的多模态模型，接受文本和图像输入。
mimo-v2.5-pro — Token Plan 默认选项，采用 Xiaomi 当前的 V2.5 推理堆栈。
mimo-v2.5 — Token Plan 多模态 V2.5 路由。

故障排除

如果模型未显示，请确认相关的 key 环境变量或 auth profile 存在且有效。
对于 Token Plan，请确认所选的新手引导区域与订阅页面的基础 URL 匹配，并且 key 以 tp-Gateway(网关) 开头。
当 Gateway(网关) 作为守护进程运行时，请确保该进程可以访问该 key（例如在 ~/.openclaw/.env 中或通过 env.shellEnv）。