OpenClaw imageModel 配置指南
我要評(píng)論一、什么是 imageModel
imageModel 是 OpenClaw 中專(zhuān)門(mén)用于視覺(jué)理解的模型配置，獨(dú)立于主對(duì)話模型（model）。當(dāng)對(duì)話涉及圖片或視覺(jué)內(nèi)容時(shí)，OpenClaw 會(huì)自動(dòng)切換到 imageModel 指定的模型來(lái)處理。
二、為什么需要單獨(dú)配置
主模型（model.primary）不一定支持視覺(jué)輸入。例如：
- MiniMax-M2.5-highspeed 是純文本模型，無(wú)法處理圖片
- moonshot/kimi-k2.5 支持多模態(tài)（文本+圖片）
單獨(dú)配置 imageModel 可以做到：文本走快模型，圖片走多模態(tài)模型，兼顧速度和能力。
三、配置方式
在 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"]
}
}
}
}兩種寫(xiě)法都支持：
// 簡(jiǎn)寫(xiě)（只設(shè)主模型，無(wú)回退）
"imageModel": "moonshot/kimi-k2.5"
// 完整寫(xiě)法（主模型 + 回退鏈）
"imageModel": {
"primary": "moonshot/kimi-k2.5",
"fallbacks": ["openrouter/google/gemini-2.0-flash-vision:free"]
}四、CLI 管理命令
# 查看當(dāng)前 imageModel 狀態(tài) openclaw models status # 設(shè)置 imageModel 主模型 openclaw models set-image moonshot/kimi-k2.5 # 管理 imageModel 回退鏈 openclaw models image-fallbacks list openclaw models image-fallbacks add openrouter/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-fallbacks clear
五、觸發(fā)場(chǎng)景
| 場(chǎng)景 | 說(shuō)明 |
|---|---|
| 用戶(hù)發(fā)送圖片 | 照片、截圖等圖片附件，agent 需要"看圖說(shuō)話"時(shí) |
| 用戶(hù)發(fā)送 PDF | PDF 含掃描頁(yè)/圖片，需視覺(jué)分析時(shí)（先查 pdfModel，未配則回退到 imageModel） |
| 媒體理解管線 | 收到的圖片/視頻截幀經(jīng)過(guò)自動(dòng)媒體理解流程時(shí) |
| agent 工具調(diào)用 | agent 使用內(nèi)置的 image 工具分析圖片時(shí) |
六、回退邏輯
imageModel.primary → imageModel.fallbacks[0] → fallbacks[1] → ...
逐個(gè)嘗試，第一個(gè)成功即返回。全部失敗則報(bào)錯(cuò)：
“No image model configured. Set agents.defaults.imageModel.primary or agents.defaults.imageModel.fallbacks.”
七、與 pdfModel 的關(guān)系
PDF 處理優(yōu)先級(jí)：pdfModel → imageModel → 內(nèi)置 provider 默認(rèn)值
如果沒(méi)有配置 pdfModel，PDF 工具會(huì)自動(dòng)回退到 imageModel 的配置。
八、內(nèi)置默認(rèn)圖像模型（無(wú)配置時(shí)）
當(dāng)未配置 imageModel 且系統(tǒng)檢測(cè)到對(duì)應(yīng) provider 的 API key 時(shí)，會(huì)使用內(nèi)置默認(rèn)：
| Provider | 默認(rèn)模型 |
|---|---|
| OpenAI | gpt-5-mini |
| Anthropic | claude-opus-4-6 |
| gemini-3-flash-preview | |
| MiniMax | MiniMax-VL-01 |
| ZAI | glm-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" }
}
}
}
}效果：
- 純文本對(duì)話 → MiniMax-M2.5-highspeed
- 發(fā)圖片 → moonshot/kimi-k2.5，失敗則 → gemini-2.0-flash-vision
- 發(fā) PDF → claude-opus-4-6，未配則回退到 imageModel 鏈
到此這篇關(guān)于OpenClaw imageModel 配置指南的文章就介紹到這了,更多相關(guān)OpenClaw imageModel 配置內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！
相關(guān)文章
這篇文章主要介紹了OpenClaw CLI 和配置文件參考完整指南,本指南全面涵蓋了這兩方面,首先介紹配置文件：格式、結(jié)構(gòu)以及每個(gè)主要部分的示例，需要的朋友可以參考下2026-03-23
本文介紹如何在 OpenClaw 中配置 DeepSeek API，通過(guò) OpenAI 兼容接口使用 deepseek-reasoner（R1 推理模型）,配置完成后，OpenClaw 的 Agent 將默認(rèn)調(diào)用 DeepSeek 進(jìn)行推2026-03-20
OpenClaw配置Tavily 搜索 Skill 完整指南教程
本文記錄為 OpenClaw 2026.3.8 + 飛書(shū) Agent 添加 Tavily 搜索能力的完整過(guò)程，包括安裝方式、安全配置、搜索優(yōu)先級(jí)調(diào)整，以及踩過(guò)的所有坑和最終結(jié)論，本文給大家介紹的2026-03-19
本文檔詳細(xì)介紹了在Mac本地環(huán)境配置OpenClaw與QQ機(jī)器人對(duì)接的完整流程,文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨2026-03-18
文章講述了作者在配置環(huán)境變量時(shí)遇到的問(wèn)題,以及如何通過(guò)在shell配置文件和systemd服務(wù)配置中雙重設(shè)置環(huán)境變量來(lái)解決這個(gè)問(wèn)題,作者還分享了常見(jiàn)的錯(cuò)誤及解決方法,并提出了2026-03-17
OpenClaw多Agent配置實(shí)戰(zhàn)及踩坑指南
本文主要介紹了OpenClaw多Agent配置實(shí)戰(zhàn)及踩坑指南，包括創(chuàng)建Agent、設(shè)置模型、定義角色、測(cè)試Agent以及Telegram多賬號(hào)配置等,具有一定的參考價(jià)值，感興趣的可以了解一下2026-03-17
本文詳細(xì)介紹了配置項(xiàng)"tools"的各個(gè)部分,包括profile、allow、deny和exec,以及approval配置，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的2026-03-13
OpenClaw 從零配置指南并接入飛書(shū) + 常用命令 + 原理全解析
本文介紹了如何從零配置OpenClaw并接入飛書(shū),包括安裝、配置、權(quán)限設(shè)置、模型切換、技能管理等步驟,以及常用命令和配置文件說(shuō)明，感興趣的朋友跟隨小編一起看看吧2026-03-12
