提供商

小米 MiMo

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

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

  • 运行新手引导

    按量付费:

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

    Token Plan:

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

    或直接传入密钥:

    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"
  • 验证模型是否可用

    bash
    openclaw models list --provider xiaomiopenclaw models list --provider xiaomi-token-plan
  • 按量付费模型目录

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

    Token Plan 模型目录

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

    身份验证选项 基础 URL
    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 131,072 默认模型
    xiaomi-token-plan/mimo-v2.5 文本、图像 1,048,576 131,072 多模态

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

    推理模型

    mimo-v2.5mimo-v2.5-pro 支持 OpenClaw 的 /think 指令,级别包括 offminimallowmediumhighxhighmax(默认值为 high)。

    文本转语音

    内置的 xiaomi 插件还将 Xiaomi MiMo 注册为 tts 的语音提供商。它调用 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
    json5
    {  tts: {    auto: "always",    provider: "xiaomi",    providers: {      xiaomi: {        apiKey: "xiaomi_api_key",        model: "mimo-v2.5-tts",        speakerVoice: "mimo_default",        format: "mp3",        style: "明亮、自然、对话式的语调。",      },    },  },}

    内置语音:mimo_defaultdefault_zhdefault_enMiaChloeMiloDean。预设语音模型 mimo-v2.5-tts 使用 audio.voice,因此 OpenClaw 会为该模型发送 speakerVoice

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

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

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

    配置示例

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

    定价和兼容性标志来自内置插件清单,因此配置示例省略了 costcompat,以避免与运行时行为不一致。

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

    相关内容

    Was this useful?
    On this page

    On this page