OpenClaw AI 完全兼容 Mistral 模型，支持 API 密钥直连官方服务并调用全部公开模型及语音转录能力；提供 onboard 交互配置、openclaw.json 静态声明、统一模型 ID 格式、环境变量注入及 Ollama 本地协同五种使用方式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw AI 完全兼容 Mistral 模型，支持通过 API 密钥直连 Mistral AI 官方服务，并可调用其全部公开模型与语音转录能力。以下是具体配置与使用方式：
一、通过 onboard 命令配置 Mistral API 密钥
该方法利用 OpenClaw 内置的交互式引导工具完成认证，密钥以加密形式安全存储于本地凭证库中，避免硬编码风险。
1、在终端执行 openclaw onboard 命令。
2、在提供商选择界面中，输入 mistral 并按回车确认。
3、系统提示输入 API 密钥时，粘贴以 sk- 开头的有效 Mistral 密钥。
4、完成验证后，密钥将自动写入凭证管理模块，无需手动编辑配置文件。
二、在 openclaw.json 中声明 Mistral 为默认模型提供商
此方式适用于 CI/CD 流程或容器化部署，通过静态配置文件指定模型来源与行为参数，确保环境一致性。
1、打开项目根目录下的 openclaw.json 文件。
2、在 "agents.defaults.model.primary" 字段中填入 "mistral/mistral-large-latest"。
3、若需启用记忆或 TTS 功能，需在 "providers.mistral.features" 下显式设为 true。
4、保存文件后，所有未显式指定模型的 Agent 将自动使用 Mistral 服务。
三、使用 Mistral 专属模型 ID 格式调用
OpenClaw 强制要求所有模型引用必须遵循 provider/model-id 统一命名规范，Mistral 模型必须以 mistral/ 为前缀，否则解析失败。
1、在 Agent 配置中设置 "model": "mistral/mixtral-8x7b" 以调用 MoE 架构模型。
PC控制工具，远程操控Windows主机，实现截屏、键鼠、文件、进程、浏览器自动化及Shell命令等操作。触发词：控制电脑、操作PC、截图、键盘、鼠标、文件管理、浏览器。
2、如需轻量级响应，可改用 "mistral/mistral-7b"。
3、语音转录任务必须使用 "mistral/voxtral-2b"（若已发布）或对应 Voxtral 系列 ID。
4、嵌入向量生成需明确指定 "mistral/e5-mistral-7b-instruct" 类嵌入模型 ID。
四、通过环境变量注入 Mistral 密钥（非交互式部署）
适用于 Docker 容器、Kubernetes 或自动化脚本场景，密钥不落地、不写入版本控制，满足安全审计要求。
1、在运行 OpenClaw 前，设置环境变量 MISTRAL_API_KEY=sk-xxx。
2、启动命令中加入 --mistral-api-key "$MISTRAL_API_KEY" 参数。
3、若同时配置了 openclaw.json 与环境变量，环境变量优先级更高，将覆盖配置文件中的密钥值。
4、验证是否生效：执行 openclaw status --providers，输出中应包含 mistral: connected。
五、与 Ollama 本地 Mistral 模型协同运行
OpenClaw 支持将本地 Ollama 托管的 Mistral 开源模型（如 mistral:7b、mixtral:8x7b）作为备用推理后端，实现混合云-边部署。
1、确保 Ollama 已安装并运行，执行 ollama list 查看已加载的 Mistral 相关模型。
2、在 openclaw.json 的 "providers" 区块中添加 "ollama" 条目，并指定 "base_url": "http://localhost:11434"。
3、为特定 Agent 设置 "model": "ollama/mistral:7b"，注意此处 provider 名为 ollama 而非 mistral。
4、启动时添加 --provider ollama 参数，强制该 Agent 使用本地模型而非云端 Mistral 服务。
