Providers

Xiaomi MiMo

Xiaomi MiMo là nền tảng API dành cho các mô hình MiMo. Plugin xiaomi được tích hợp sẵn (enabledByDefault: true, không cần cài đặt) đăng ký hai nhà cung cấp văn bản cùng một nhà cung cấp giọng nói (TTS):

  • xiaomi - khóa trả phí theo mức sử dụng (sk-...)
  • xiaomi-token-plan - khóa Gói Token (tp-...) với các cấu hình sẵn điểm cuối theo khu vực
Thuộc tính Giá trị
ID nhà cung cấp xiaomi (trả phí theo mức sử dụng), xiaomi-token-plan (Gói Token)
Biến môi trường xác thực XIAOMI_API_KEY, XIAOMI_TOKEN_PLAN_API_KEY
Cờ thiết lập ban đầu --auth-choice xiaomi-api-key, --auth-choice xiaomi-token-plan-cn, --auth-choice xiaomi-token-plan-sgp, --auth-choice xiaomi-token-plan-ams
Cờ CLI trực tiếp --xiaomi-api-key <key>, --xiaomi-token-plan-api-key <key>
API Hoàn thành trò chuyện tương thích với OpenAI (openai-completions)
Hợp đồng giọng nói speechProviders: ["xiaomi"]
URL cơ sở Trả phí theo mức sử dụng: https://api.xiaomimimo.com/v1; Gói Token: token-plan-{cn,sgp,ams}.xiaomimimo.com/v1
Mô hình mặc định xiaomi/mimo-v2.5, xiaomi-token-plan/mimo-v2.5-pro
TTS mặc định mimo-v2.5-tts, giọng nói mimo_default; mô hình thiết kế giọng nói mimo-v2.5-tts-voicedesign

Bắt đầu

  • Lấy đúng khóa

    Tạo khóa trả phí theo mức sử dụng trong bảng điều khiển Xiaomi MiMo, hoặc mở trang đăng ký Gói Token và sao chép URL cơ sở tương thích với OpenAI theo khu vực cùng khóa tp-... tương ứng.

  • Chạy thiết lập ban đầu

    Trả phí theo mức sử dụng:

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

    Gói Token:

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

    Hoặc truyền trực tiếp các khóa:

    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"
  • Xác minh mô hình khả dụng

    bash
    openclaw models list --provider xiaomiopenclaw models list --provider xiaomi-token-plan
  • Danh mục trả phí theo mức sử dụng

    Tham chiếu mô hình Đầu vào Ngữ cảnh Đầu ra tối đa Suy luận Ghi chú
    xiaomi/mimo-v2.5 văn bản, hình ảnh 1,048,576 131,072 Mô hình mặc định
    xiaomi/mimo-v2.5-pro văn bản 1,048,576 131,072 Chủ lực

    Danh mục Gói Token

    Chọn phương thức xác thực Gói Token khớp với URL cơ sở theo khu vực hiển thị trong giao diện đăng ký của Xiaomi:

    Phương thức xác thực URL cơ sở
    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
    Tham chiếu mô hình Đầu vào Ngữ cảnh Đầu ra tối đa Suy luận Ghi chú
    xiaomi-token-plan/mimo-v2.5-pro văn bản 1,048,576 131,072 Mô hình mặc định
    xiaomi-token-plan/mimo-v2.5 văn bản, hình ảnh 1,048,576 131,072 Đa phương thức

    xiaomi-token-plan cần URL cơ sở theo khu vực để phân giải. Luồng được hỗ trợ là một lựa chọn thiết lập ban đầu Gói Token được tích hợp sẵn hoặc một khối cấu hình models.providers.xiaomi-token-plan tường minh có đặt baseUrl; nhà cung cấp không được cung cấp nếu thiếu một trong hai điều kiện đó.

    Mô hình suy luận

    mimo-v2.5mimo-v2.5-pro hỗ trợ chỉ thị /think của OpenClaw với các mức off, minimal, low, medium, high, xhighmax (mặc định high).

    Chuyển văn bản thành giọng nói

    Plugin xiaomi được tích hợp sẵn cũng đăng ký Xiaomi MiMo làm nhà cung cấp giọng nói cho messages.tts. Plugin gọi hợp đồng TTS hoàn thành trò chuyện của Xiaomi với văn bản dưới dạng thông điệp assistant và hướng dẫn phong cách tùy chọn dưới dạng thông điệp user.

    Thuộc tính Giá trị
    ID TTS xiaomi (bí danh mimo)
    Xác thực XIAOMI_API_KEY
    API POST /v1/chat/completions với audio
    Mặc định mimo-v2.5-tts, giọng nói mimo_default
    Đầu ra MP3 theo mặc định; WAV khi được cấu hình
    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.",        },      },    },  },}

    Các giọng nói tích hợp sẵn: mimo_default, default_zh, default_en, Mia, Chloe, Milo, Dean. Mô hình giọng nói đặt sẵn mimo-v2.5-tts sử dụng audio.voice, vì vậy OpenClaw gửi speakerVoice cho mô hình đó.

    Mô hình thiết kế giọng nói mimo-v2.5-tts-voicedesign tạo giọng nói từ một lời nhắc phong cách bằng ngôn ngữ tự nhiên thay vì ID giọng nói đặt sẵn. Đặt style thành mô tả giọng nói mong muốn; OpenClaw gửi mô tả đó dưới dạng thông điệp user, gửi văn bản cần đọc dưới dạng thông điệp assistant và bỏ qua audio.voice đối với mô hình này.

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

    Đối với các kênh yêu cầu đích tổng hợp ghi chú thoại (Discord, Feishu, Matrix, Telegram và WhatsApp), OpenClaw chuyển mã đầu ra Xiaomi thành Opus đơn âm 48kHz bằng ffmpeg trước khi gửi.

    Ví dụ cấu hình

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

    Thông tin giá và các cờ tương thích đến từ bản kê khai Plugin được tích hợp sẵn, vì vậy ví dụ cấu hình bỏ qua costcompat để tránh sai lệch so với hành vi thời gian chạy.

    Gói Token:

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

    Thông tin giá đến từ bản kê khai được tích hợp sẵn (các mô hình Gói Token bao gồm giá đọc bộ nhớ đệm theo bậc), vì vậy ví dụ cấu hình bỏ qua cost.

    Hành vi tự động chèn

    Nhà cung cấp xiaomi được tự động bật khi XIAOMI_API_KEY được đặt trong môi trường của bạn hoặc có hồ sơ xác thực. xiaomi-token-plan cần URL cơ sở theo khu vực, vì vậy luồng được hỗ trợ là lựa chọn thiết lập ban đầu Gói Token được tích hợp sẵn hoặc một khối cấu hình models.providers.xiaomi-token-plan tường minh.

    Chi tiết mô hình
    • mimo-v2.5 - mô hình mặc định trả phí theo mức sử dụng và tuyến V2.5 đa phương thức của Gói Token.
    • mimo-v2.5-pro - mô hình suy luận chủ lực và mô hình mặc định của Gói Token.
    Khắc phục sự cố
    • Nếu các mô hình không xuất hiện, hãy xác nhận biến môi trường khóa hoặc hồ sơ xác thực tương ứng có tồn tại và hợp lệ.
    • Đối với Gói Token, hãy xác nhận khu vực thiết lập ban đầu đã chọn khớp với URL cơ sở trên trang đăng ký và khóa bắt đầu bằng tp-.
    • Khi Gateway chạy dưới dạng daemon, hãy bảo đảm khóa khả dụng cho tiến trình đó (ví dụ trong ~/.openclaw/.env hoặc thông qua env.shellEnv).

    Liên quan

    Was this useful?
    On this page

    On this page