OpenClaw imageModel 配置指南一、什么是 imageModelimageModel是 OpenClaw 中专门用于视觉理解的模型配置独立于主对话模型model。当对话涉及图片或视觉内容时OpenClaw 会自动切换到imageModel指定的模型来处理。二、为什么需要单独配置主模型model.primary不一定支持视觉输入。例如MiniMax-M2.5-highspeed是纯文本模型无法处理图片moonshot/kimi-k2.5支持多模态文本图片单独配置imageModel可以做到文本走快模型图片走多模态模型兼顾速度和能力。三、配置方式在 OpenClaw 配置文件中openclaw config edit{ agents: { defaults: { model: { primary: minimax-portal/MiniMax-M2.5-highspeed, fallbacks: [moonshot/kimi-k2.5, anthropic/claude-opus-4-6] }, imageModel: { primary: moonshot/kimi-k2.5, fallbacks: [openrouter/qwen/qwen-2.5-vl-72b-instruct:free] } } } }两种写法都支持// 简写只设主模型无回退 imageModel: moonshot/kimi-k2.5 // 完整写法主模型 回退链 imageModel: { primary: moonshot/kimi-k2.5, fallbacks: [openrouter/google/gemini-2.0-flash-vision:free] }四、CLI 管理命令# 查看当前 imageModel 状态openclaw models status# 设置 imageModel 主模型openclaw models set-image moonshot/kimi-k2.5# 管理 imageModel 回退链openclaw models image-fallbacks list openclaw models image-fallbacksaddopenrouter/qwen/qwen-2.5-vl-72b-instruct:free openclaw models image-fallbacks remove openrouter/qwen/qwen-2.5-vl-72b-instruct:free openclaw models image-fallbacksclear五、触发场景场景说明用户发送图片照片、截图等图片附件agent 需要看图说话时用户发送 PDFPDF 含扫描页/图片需视觉分析时先查pdfModel未配则回退到imageModel媒体理解管线收到的图片/视频截帧经过自动媒体理解流程时agent 工具调用agent 使用内置的image工具分析图片时六、回退逻辑imageModel.primary → imageModel.fallbacks[0] → fallbacks[1] → ...逐个尝试第一个成功即返回。全部失败则报错“No image model configured. Set agents.defaults.imageModel.primary or agents.defaults.imageModel.fallbacks.”七、与 pdfModel 的关系PDF 处理优先级pdfModel → imageModel → 内置 provider 默认值如果没有配置pdfModelPDF 工具会自动回退到imageModel的配置。八、内置默认图像模型无配置时当未配置imageModel且系统检测到对应 provider 的 API key 时会使用内置默认Provider默认模型OpenAIgpt-5-miniAnthropicclaude-opus-4-6Googlegemini-3-flash-previewMiniMaxMiniMax-VL-01ZAIglm-4.6v九、完整配置示例{ agents: { defaults: { model: { primary: minimax-portal/MiniMax-M2.5-highspeed, fallbacks: [moonshot/kimi-k2.5, anthropic/claude-opus-4-6] }, imageModel: { primary: moonshot/kimi-k2.5, fallbacks: [openrouter/google/gemini-2.0-flash-vision:free] }, pdfModel: { primary: anthropic/claude-opus-4-6 }, models: { moonshot/kimi-k2.5: { alias: kimi }, minimax-portal/MiniMax-M2.5-highspeed: { alias: mm } } } } }效果纯文本对话 →MiniMax-M2.5-highspeed发图片 →moonshot/kimi-k2.5失败则 →gemini-2.0-flash-vision发 PDF →claude-opus-4-6未配则回退到 imageModel 链