跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

小米 MiMo

通过 OpenClaw 使用小米 MiMo 按量付费和 Token Plan 模型

Xiaomi MiMo 是 MiMo 模型的 API 平台。内置的 xiaomi 插件(enabledByDefault: true,无需安装)注册了两个文本 提供商和一个语音(TTS)提供商:

  • xiaomi - 按量付费密钥(sk-...)
  • xiaomi-token-plan - Token Plan 密钥(tp-...),提供区域端点预设
属性值
提供商 IDxiaomi(按量付费)、xiaomi-token-plan(Token Plan)
身份验证环境变量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>
APIOpenAI 兼容的聊天补全(openai-completions)
语音契约speechProviders: ["xiaomi"]
基础 URL按量付费:https://api.xiaomimimo.com/v1;Token Plan:token-plan-{cn,sgp,ams}.xiaomimimo.com/v1
默认模型xiaomi/mimo-v2.5、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

新手引导会验证密钥格式,并在将 tp-... 密钥输入按量付费流程,或将 sk-... 密钥输入 Token Plan 流程时发出警告。

按量付费模型目录

模型引用输入上下文最大输出推理备注
xiaomi/mimo-v2.5文本、图像1,048,576131,072是默认模型
xiaomi/mimo-v2.5-pro文本1,048,576131,072是旗舰模型

Token Plan 模型目录

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

身份验证选项基础 URL
xiaomi-token-plan-cnhttps://token-plan-cn.xiaomimimo.com/v1
xiaomi-token-plan-sgphttps://token-plan-sgp.xiaomimimo.com/v1
xiaomi-token-plan-amshttps://token-plan-ams.xiaomimimo.com/v1
模型引用输入上下文最大输出推理备注
xiaomi-token-plan/mimo-v2.5-pro文本1,048,576131,072是默认模型
xiaomi-token-plan/mimo-v2.5文本、图像1,048,576131,072是多模态

xiaomi-token-plan 需要区域基础 URL 才能解析。支持的方式 是选择内置的 Token Plan 新手引导选项,或使用显式的 models.providers.xiaomi-token-plan 配置块并设置 baseUrl; 如果没有其中任何一种配置,则不会提供该提供商。

推理模型

mimo-v2.5 和 mimo-v2.5-pro 支持 OpenClaw 的 /think 指令,级别包括 off、 minimal、low、medium、high、xhigh 和 max(默认值为 high)。

文本转语音

内置的 xiaomi 插件还将 Xiaomi MiMo 注册为 tts 的语音提供商。它调用 Xiaomi 的聊天补全 TTS 契约,将 文本作为 assistant 消息,并将可选的风格指导作为 user 消息。

属性值
TTS IDxiaomi(别名 mimo)
身份验证XIAOMI_API_KEY
APIPOST /v1/chat/completions,使用 audio
默认值mimo-v2.5-tts,语音 mimo_default
输出默认为 MP3;配置后可使用 WAV
{
  tts: {
    auto: "always",
    provider: "xiaomi",
    providers: {
      xiaomi: {
        apiKey: "xiaomi_api_key",
        model: "mimo-v2.5-tts",
        speakerVoice: "mimo_default",
        format: "mp3",
        style: "明亮、自然、对话式的语调。",
      },
    },
  },
}

内置语音:mimo_default、default_zh、default_en、Mia、Chloe、 Milo、Dean。预设语音模型 mimo-v2.5-tts 使用 audio.voice,因此 OpenClaw 会为该模型发送 speakerVoice。

语音设计模型 mimo-v2.5-tts-voicedesign 根据 自然语言风格提示生成语音,而不是使用预设语音 ID。将 style 设置为 所需的语音描述;OpenClaw 将其作为 user 消息发送,将 要朗读的文本作为 assistant 消息发送,并为此 模型省略 audio.voice。

{
  tts: {
    provider: "xiaomi",
    providers: {
      xiaomi: {
        model: "mimo-v2.5-tts-voicedesign",
        format: "wav",
        style: "温暖、自然、发音清晰的女性声音。",
      },
    },
  },
}

对于请求语音消息合成目标的渠道(Discord、Feishu、 Matrix、Telegram 和 WhatsApp),OpenClaw 会在交付前使用 ffmpeg 将 Xiaomi 输出转码为 48kHz 单声道 Opus。

配置示例

{
  env: { XIAOMI_API_KEY: "your-key" },
  agents: { defaults: { model: { primary: "xiaomi/mimo-v2.5" } } },
  models: {
    mode: "merge",
    providers: {
      xiaomi: {
        baseUrl: "https://api.xiaomimimo.com/v1",
        api: "openai-completions",
        apiKey: "XIAOMI_API_KEY",
        models: [
          {
            id: "mimo-v2.5",
            name: "Xiaomi MiMo V2.5",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1048576,
            maxTokens: 131072,
          },
          {
            id: "mimo-v2.5-pro",
            name: "Xiaomi MiMo V2.5 Pro",
            reasoning: true,
            input: ["text"],
            contextWindow: 1048576,
            maxTokens: 131072,
          },
        ],
      },
    },
  },
}

定价和兼容性标志来自内置插件清单,因此配置示例省略了 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: 131072,
          },
          {
            id: "mimo-v2.5",
            name: "Xiaomi MiMo V2.5",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1048576,
            maxTokens: 131072,
          },
        ],
      },
    },
  },
}

定价来自内置清单(Token Plan 模型包含分级缓存读取定价),因此配置示例省略了 cost。

自动注入行为

当环境中设置了 XIAOMI_API_KEY 或存在身份验证配置文件时,会自动启用 xiaomi 提供商。xiaomi-token-plan 需要区域基础 URL,因此支持的方式是选择内置的 Token Plan 新手引导选项,或使用显式的 models.providers.xiaomi-token-plan 配置块。

模型详情
  • mimo-v2.5 - 按量付费默认模型和 Token Plan 多模态 V2.5 路由。
  • mimo-v2.5-pro - 旗舰推理模型和 Token Plan 默认模型。

按量付费模型使用 xiaomi/ 前缀。Token Plan 模型使用 xiaomi-token-plan/ 前缀。

故障排除
  • 如果模型未显示,请确认相关密钥环境变量或身份验证配置文件存在且有效。
  • 对于 Token Plan,请确认所选的新手引导区域与订阅页面的基础 URL 匹配,并且密钥以 tp- 开头。
  • 当 Gateway 网关以守护进程形式运行时,请确保该进程可以使用密钥(例如在 ~/.openclaw/.env 中或通过 env.shellEnv)。

仅在交互式 shell 中设置的密钥对守护进程管理的 Gateway 网关进程不可见。使用 ~/.openclaw/.env 或 env.shellEnv 配置以确保密钥持久可用。

相关内容