Mistral

Mistral 是一个很聪明的朋友，你的小助手 OpenClaw 可以请它来帮忙。它能做三件主要的事情：第一，像聊天一样处理文字和图片；第二，把你说的话录下来，然后变成文字（这个功能叫“音频转录”）；第三，帮你记住东西（这个功能叫“记忆嵌入”）。

要开始和 Mistral 朋友玩，你需要先拿到一把叫 MISTRAL_API_KEY 的“钥匙”。这把钥匙就像进游乐园的门票，没有它就不能进去。你可以把它保存在一个安全的地方。

第一步：给你的小助手介绍这位新朋友 打开你的电脑，找到那个可以输入命令的地方（我们叫它“命令行”）。然后，你需要告诉小助手：“嘿，我认识一位叫 Mistral 的新朋友，这是它的钥匙。” 你可以用两种方法告诉它：

1. 一种是有问有答的方法。输入 openclaw onboard --auth-choice mistral-api-key，然后小助手会问你钥匙是什么，你告诉它就行了。
2. 另一种是直接告诉它。输入 openclaw onboard --mistral-api-key “你的钥匙”，记得把“你的钥匙”换成你真正的那把钥匙。

第二步：告诉小助手，以后聊天就找这位朋友 你需要写一个小小的“使用说明”给小助手看。在一个叫配置文件的地方，写下这些话：

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

这就像在说：“小助手，这是 Mistral 朋友的钥匙（MISTRAL_API_KEY）。以后我找你聊天时，默认就请这位叫 mistral-large-latest 的 Mistral 朋友来回答我吧。”

第三步：如果你想让它“听懂”你的声音 Mistral 朋友里有一位叫 Voxtral 的，特别擅长把声音变成文字。如果你想让小助手也有这个本领，就在刚才的“使用说明”里再加一段话：

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

这就像在说：“小助手，请把‘听声音’这个工具打开（enabled: true）。当有声音需要听懂时，就去找 Mistral 朋友家的 voxtral-mini-latest 来帮忙。”

一些重要的小提醒

• 记住，那把最重要的钥匙名字是 MISTRAL_API_KEY，一个字母都不能错哦。
• 小助手默认会去 https://api.mistral.ai/v1 这个地址找 Mistral 朋友玩。
• 当你用“有问有答”的方法介绍朋友时，小助手默认会记住 mistral/mistral-large-latest 这位朋友。
• 当你要“听懂声音”时，小助手默认会找 voxtral-mini-latest 来帮忙。
• 小助手会用不同的“小路”去找 Mistral 朋友做不同的事：把声音变文字走 /v1/audio/transcriptions 这条路；帮你记住东西走 /v1/embeddings 这条路，并且默认会请 mistral-embed 这位朋友来负责记忆。