Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw hỗ trợ Mistral cho cả định tuyến mô hình văn bản/hình ảnh (mistral/...) và phiên âm âm thanh qua Voxtral trong nhận hiểu phương tiện. Mistral cũng có thể được dùng cho nhúng bộ nhớ (memorySearch.provider = "mistral").
  • Nhà cung cấp: mistral
  • Xác thực: MISTRAL_API_KEY
  • API: Mistral Chat Completions (https://api.mistral.ai/v1)

Bắt đầu

1

Lấy khóa API của bạn

Tạo khóa API trong Mistral Console.
2

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

openclaw onboard --auth-choice mistral-api-key
Hoặc truyền khóa trực tiếp:
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
3

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

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

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

openclaw models list --provider mistral

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

OpenClaw hiện đi kèm danh mục Mistral tích hợp này:
Tham chiếu mô hìnhĐầu vàoNgữ cảnhĐầu ra tối đaGhi chú
mistral/mistral-large-latestvăn bản, hình ảnh262,14416,384Mô hình mặc định
mistral/mistral-medium-2508văn bản, hình ảnh262,1448,192Mistral Medium 3.1
mistral/mistral-small-latestvăn bản, hình ảnh128,00016,384Mistral Small 4; suy luận có thể điều chỉnh qua API reasoning_effort
mistral/pixtral-large-latestvăn bản, hình ảnh128,00032,768Pixtral
mistral/codestral-latestvăn bản256,0004,096Lập trình
mistral/devstral-medium-latestvăn bản262,14432,768Devstral 2
mistral/magistral-smallvăn bản128,00040,000Hỗ trợ suy luận

Phiên âm âm thanh (Voxtral)

Dùng Voxtral để phiên âm âm thanh theo lô thông qua quy trình nhận hiểu phương tiện.
{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
      },
    },
  },
}
Đường dẫn phiên âm phương tiện dùng /v1/audio/transcriptions. Mô hình âm thanh mặc định cho Mistral là voxtral-mini-latest.

STT phát trực tuyến cho Voice Call

Plugin mistral đi kèm đăng ký Voxtral Realtime làm nhà cung cấp STT phát trực tuyến cho Voice Call.
Thiết lậpĐường dẫn cấu hìnhMặc định
Khóa APIplugins.entries.voice-call.config.streaming.providers.mistral.apiKeyDự phòng về MISTRAL_API_KEY
Mô hình...mistral.modelvoxtral-mini-transcribe-realtime-2602
Mã hóa...mistral.encodingpcm_mulaw
Tốc độ lấy mẫu...mistral.sampleRate8000
Độ trễ mục tiêu...mistral.targetStreamingDelayMs800
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}
OpenClaw đặt STT thời gian thực của Mistral mặc định là pcm_mulaw ở 8 kHz để Voice Call có thể chuyển tiếp trực tiếp các khung phương tiện Twilio. Chỉ dùng encoding: "pcm_s16le"sampleRate tương ứng nếu luồng thượng nguồn của bạn đã là PCM thô.

Cấu hình nâng cao

mistral/mistral-small-latest ánh xạ tới Mistral Small 4 và hỗ trợ suy luận có thể điều chỉnh trên API Chat Completions 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 vào API của Mistral:
Mức suy nghĩ của OpenClawreasoning_effort của Mistral
off / minimalnone
low / medium / high / xhigh / adaptive / maxhigh
Các mô hình khác trong danh mục Mistral đi kèm không dùng tham số này. Tiếp tục dùng các mô hình magistral-* khi bạn muốn hành vi ưu tiên suy luận gốc của Mistral.
Mistral có thể phục vụ nhúng bộ nhớ qua /v1/embeddings (mô hình mặc định: mistral-embed).
{
  memorySearch: { provider: "mistral" },
}
  • Xác thực Mistral dùng MISTRAL_API_KEY.
  • URL cơ sở của nhà cung cấp mặc định là https://api.mistral.ai/v1.
  • Mô hình thiết lập ban đầu mặc định là mistral/mistral-large-latest.
  • Z.AI dùng xác thực Bearer với khóa API của bạn.

Liên quan

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 phương tiện

Thiết lập phiên âm âm thanh và chọn nhà cung cấp.