メインコンテンツへスキップ

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 には、chat completions、メディア理解(Voxtral バッチ文字起こし)、Voice Call 向け realtime STT(Voxtral Realtime)、memory embeddings(mistral-embed)の 4 つの契約を登録する同梱 Mistral Plugin が含まれています。
プロパティ
Provider idmistral
Plugin同梱、enabledByDefault: true
認証 env varMISTRAL_API_KEY
Onboarding flag--auth-choice mistral-api-key
直接 CLI flag--mistral-api-key <key>
APIOpenAI 互換(openai-completions
Base URLhttps://api.mistral.ai/v1
既定モデルmistral/mistral-large-latest
埋め込みモデルmistral-embed
Voxtral batchvoxtral-mini-latest(音声文字起こし)
Voxtral realtimevoxtral-mini-transcribe-realtime-2602

はじめに

1

API キーを取得する

Mistral Console で API キーを作成します。
2

オンボーディングを実行する

openclaw onboard --auth-choice mistral-api-key
または、キーを直接渡します。
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
3

既定モデルを設定する

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

モデルが利用可能であることを確認する

openclaw models list --provider mistral

組み込み LLM カタログ

Mistral Medium 3.5 は、同梱カタログ内の現在の blended Medium モデルです。128B の dense weights、 テキストと画像の入力、256K コンテキスト、関数呼び出し、構造化出力、コーディング、 Chat Completions API を通じた調整可能な推論に対応しています。既定の mistral/mistral-large-latest ではなく、Mistral の新しい統合 agentic/coding モデルを使いたい場合は mistral/mistral-medium-3-5 を使用します。 OpenClaw は現在、この同梱 Mistral カタログを出荷しています。
モデル ref入力コンテキスト最大出力注記
mistral/mistral-large-latesttext, image262,14416,384既定モデル
mistral/mistral-medium-2508text, image262,1448,192Mistral Medium 3.1
mistral/mistral-medium-3-5text, image262,1448,192Mistral Medium 3.5、調整可能な推論
mistral/mistral-small-latesttext, image128,00016,384Mistral Small 4、API reasoning_effort 経由の調整可能な推論
mistral/pixtral-large-latesttext, image128,00032,768Pixtral
mistral/codestral-latesttext256,0004,096コーディング
mistral/devstral-medium-latesttext262,14432,768Devstral 2
mistral/magistral-smalltext128,00040,000推論対応
オンボーディング後、Gateway を起動せずに Medium 3.5 をスモークテストします。
openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Reply with exactly: mistral-ok" \
  --json
設定を変更する前に、同梱カタログの行を確認するには次を実行します。
openclaw models list --all --provider mistral --plain

音声文字起こし(Voxtral)

メディア理解パイプラインを通じたバッチ音声文字起こしには Voxtral を使用します。
{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
      },
    },
  },
}
メディア文字起こしパスは /v1/audio/transcriptions を使用します。Mistral の既定の音声モデルは voxtral-mini-latest です。

Voice Call ストリーミング STT

同梱の mistral Plugin は、Voxtral Realtime を Voice Call ストリーミング STT provider として登録します。
設定設定パス既定値
API キーplugins.entries.voice-call.config.streaming.providers.mistral.apiKeyMISTRAL_API_KEY にフォールバック
モデル...mistral.modelvoxtral-mini-transcribe-realtime-2602
エンコーディング...mistral.encodingpcm_mulaw
サンプルレート...mistral.sampleRate8000
目標遅延...mistral.targetStreamingDelayMs800
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}
OpenClaw は Mistral realtime STT の既定を 8 kHz の pcm_mulaw にしているため、Voice Call は Twilio メディアフレームを直接転送できます。上流のストリームがすでに raw PCM の場合にのみ、 encoding: "pcm_s16le" と一致する sampleRate を使用してください。

高度な設定

Mistral は /v1/embeddings 経由で memory embeddings を提供できます(既定モデル: mistral-embed)。
{
  memorySearch: { provider: "mistral" },
}
  • Mistral 認証は MISTRAL_API_KEY(Bearer header)を使用します。
  • Provider base URL の既定は https://api.mistral.ai/v1 で、標準の OpenAI 互換 chat-completions request shape を受け付けます。
  • オンボーディングの既定モデルは mistral/mistral-large-latest です。
  • Mistral が必要な regional endpoint を明示的に公開している場合にのみ、models.providers.mistral.baseUrl で base URL を上書きしてください。

関連

モデル選択

providers、model refs、failover behavior の選択。

メディア理解

音声文字起こしの設定と provider 選択。