OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Mistral

Plugin mistral đi kèm đăng ký bốn hợp đồng: hoàn tất trò chuyện, nhận hiểu nội dung đa phương tiện (phiên âm hàng loạt bằng Voxtral), STT thời gian thực cho Voice Call (Voxtral Realtime) và embedding bộ nhớ (mistral-embed).

Thuộc tính Giá trị
ID nhà cung cấp mistral
Plugin đi kèm, được bật theo mặc định
Biến môi trường xác thực MISTRAL_API_KEY
Cờ hướng dẫn thiết lập --auth-choice mistral-api-key
Cờ CLI trực tiếp --mistral-api-key <key>
API tương thích với OpenAI (openai-completions)
URL cơ sở https://api.mistral.ai/v1
Mô hình mặc định mistral/mistral-large-latest
Mô hình embedding mistral-embed
Voxtral hàng loạt voxtral-mini-latest (phiên âm thanh)
Voxtral thời gian thực voxtral-mini-transcribe-realtime-2602

Bắt đầu

  • Lấy khóa API

    Tạo khóa API trong Mistral Console.

  • Chạy quy trình hướng dẫn thiết lập

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

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

    bash
    openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"

  • Đặt mô hình mặc định

    json5
    {  env: { MISTRAL_API_KEY: "sk-..." },  agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },}

  • Xác minh mô hình khả dụng

    bash
    openclaw models list --provider mistral

    • Danh mục LLM tích hợp sẵn

    Tham chiếu mô hình Đầu vào Ngữ cảnh Đầu ra tối đa Ghi chú
    mistral/mistral-large-latest văn bản, hình ảnh 262,144 16,384 Mô hình mặc định
    mistral/mistral-medium-2508 văn bản, hình ảnh 262,144 8,192 Mistral Medium 3.1
    mistral/mistral-medium-3-5 văn bản, hình ảnh 262,144 8,192 Mistral Medium 3.5; có thể điều chỉnh suy luận
    mistral/mistral-small-latest văn bản, hình ảnh 262,144 16,384 Mistral Small 4 mới nhất; có thể điều chỉnh reasoning_effort
    mistral/mistral-small-2603 văn bản, hình ảnh 262,144 16,384 Mistral Small 4 phiên bản cố định; có thể điều chỉnh reasoning_effort
    mistral/pixtral-large-latest văn bản, hình ảnh 128,000 32,768 Pixtral
    mistral/codestral-latest văn bản 256,000 4,096 Lập trình
    mistral/devstral-medium-latest văn bản 262,144 32,768 Devstral 2
    mistral/magistral-small văn bản 128,000 40,000 Hỗ trợ suy luận

    Xem hàng tương ứng trong danh mục tích hợp sẵn trước khi thay đổi cấu hình:

    bash
    openclaw models list --all --provider mistral --plain

    Kiểm thử nhanh một mô hình mà không cần khởi động Gateway:

    bash
    openclaw infer model run --local \  --model mistral/mistral-medium-3-5 \  --prompt "Reply with exactly: mistral-ok" \  --json

    Phiên âm thanh (Voxtral)

    Dùng Voxtral để phiên âm thanh hàng loạt thông qua quy trình nhận hiểu nội dung đa phương tiện:

    json5
    {  tools: {    media: {      audio: {        enabled: true,        models: [{ provider: "mistral", model: "voxtral-mini-latest" }],      },    },  },}

    STT truyền phát cho Voice Call

    Plugin mistral đi kèm đăng ký Voxtral Realtime làm nhà cung cấp STT truyền phát cho Voice Call.

    Cài đặt Đường dẫn cấu hình Mặc định
    Khóa API plugins.entries.voice-call.config.streaming.providers.mistral.apiKey Dùng MISTRAL_API_KEY làm phương án dự phòng
    Mô hình ...mistral.model voxtral-mini-transcribe-realtime-2602
    Mã hóa ...mistral.encoding pcm_mulaw
    Tần số lấy mẫu ...mistral.sampleRate 8000
    Độ trễ mục tiêu ...mistral.targetStreamingDelayMs 800
    json5
    {  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "mistral",            providers: {              mistral: {                apiKey: "${MISTRAL_API_KEY}",                targetStreamingDelayMs: 800,              },            },          },        },      },    },  },}

    Cấu hình nâng cao

    Suy luận có thể điều chỉnh

    mistral/mistral-small-latest, mistral/mistral-small-2603 và mistral/mistral-medium-3-5 hỗ trợ suy luận có thể điều chỉnh trên API Chat Completions thông qua reasoning_effort (none giảm thiểu phần suy nghĩ bổ sung trong đầu ra; high hiển thị đầy đủ dấu vết suy nghĩ trước câu trả lời cuối cùng).

    OpenClaw ánh xạ mức độ suy nghĩ của phiên sang API của Mistral:

    Mức độ suy nghĩ của OpenClaw reasoning_effort của Mistral
    tắt / tối thiểu none
    thấp / trung bình / cao / rất cao / thích ứng / tối đa high

    Ví dụ cấu hình theo phạm vi mô hình cho suy luận của Medium 3.5:

    json5
    {  agents: {    defaults: {      model: { primary: "mistral/mistral-medium-3-5" },      models: {        "mistral/mistral-medium-3-5": {          params: { thinking: "high" },        },      },    },  },}
    Embedding bộ nhớ

    Mistral có thể cung cấp embedding bộ nhớ qua /v1/embeddings (mô hình mặc định: mistral-embed):

    json5
    {  agents: {    defaults: {      memorySearch: { provider: "mistral" },    },  },}
    Xác thực và URL cơ sở
    • Xác thực Mistral sử dụng MISTRAL_API_KEY (tiêu đề Bearer).
    • URL cơ sở của nhà cung cấp mặc định là https://api.mistral.ai/v1 và chấp nhận cấu trúc yêu cầu hoàn tất trò chuyện tiêu chuẩn tương thích với OpenAI.
    • Mô hình mặc định khi hướng dẫn thiết lập là mistral/mistral-large-latest.
    • Chỉ ghi đè URL cơ sở tại models.providers.mistral.baseUrl khi Mistral công bố rõ ràng một điểm cuối theo khu vực mà bạn cần.

    Liên quan

    Lựa chọn mô hình

    Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.
    Nhận hiểu nội dung đa phương tiện

    Thiết lập phiên âm thanh và lựa chọn nhà cung cấp.
    Was this useful?
    On this page

    On this page