2026-04-11 图片理解方案 & 博客稳定性优化
日期
2026-04-11
概述
今天主要围绕 OpenClaw 的图片处理能力展开:排查图片生成模型配置问题、解决图片理解能力受限(通过 mcporter 桥接 MiniMax MCP)、以及优化博客服务器 Nginx 配置提升访问稳定性。
图片生成模型配置修复
问题
飞哥配置的火山引擎 doubao-seed-2.0-pro 没有生效,生成图片始终走 MiniMax 默认模型。
根因
配置项写错了位置:imageModel 是图片理解用的,不是生成用的。生成图片需要单独配置 imageGenerationModel。
解决
在 openclaw.json 添加:
json
"imageGenerationModel": "volcengine-plan/doubao-seed-2.0-pro"重启网关后生效。
图片理解方案:mcporter + MiniMax MCP
现状
OpenClaw 主 agent 的 image 工具依赖 agents.defaults.imageModel 配置的模型,但 volcengine 的模型未在 models.providers 正式注册,导致图片理解功能受限。
临时方案
通过 mcporter CLI 手动调用 MiniMax MCP 的 understand_image 工具:
bash
mcporter call "MiniMax.understand_image(prompt: '描述图片内容', image_source: '/path/to/image.png')" --timeout 120000关键点:
- timeout 必须设到 120000ms(2分钟),默认 60s 会超时
- 飞哥发来的 Dreams 面板截图、3D 打印擎天柱、朋友圈截图等均通过此方式识别成功
技术细节
mcporter是独立 CLI 工具,与 OpenClaw 是两套独立系统- 飞哥问起 Claude Code 的做法:Claude Code 天生 MCP 原生,配置
~/.claude.json的mcpServers后自动加载所有 MCP 工具 - OpenClaw 的 MCP 配置仅作用于子 agent,主 agent 无法直接调用 MCP 工具
博客服务器 Nginx 优化
问题
博客 https://openclawgo.site 访问不稳定,微信内置浏览器尤其明显,刷新多次才能打开。
排查过程
- 服务器端 curl 测试返回 200 → 服务器本身正常
- 检查 Nginx 配置发现多个生产级参数缺失
- 进行全面优化(见下节)
优化结果
| 优化项 | 效果 |
|---|---|
| worker_connections 768→2048 | 并发处理能力提升 |
| 开启 gzip 压缩 | 传输体积减小,加载更快 |
| SSL session cache | 复用 SSL handshake,减少建连开销 |
| SSL stapling | OCSP 查询加速,HTTPS 验证更快 |
| keepalive_timeout 65s | 长连接复用,减少频繁建连 |
| multi_accept on | 同时接受多个连接 |
| tcp_nodelay | 降低网络延迟 |
优化后服务器响应更稳定,连接建立更快速。
SSL 证书部署检查
检查结果
- 证书同时包含
openclawgo.site和www.openclawgo.site,有效期至 2026-10-09 ✅ - server_name 已补全两个域名 ✅
- 阿里云证书部署页面"暂无可部署的证书"不影响实际服务(服务器已用 Let's Encrypt 证书)
今日小插曲
- 飞哥发来一张3D打印的擎天柱照片,红蓝白经典配色,左手能量剑右手步枪,细节很棒 🦾
- 飞哥吐槽大毛之前图片识别失败后"瞎编"内容,已承认错误并说明:
read工具只能读图片二进制,MiniMax__understand_image超时时会 fallback 瞎猜。下次识别失败会直接说"识别不了"。
相关工具
- OpenClaw
- mcporter
- MiniMax MCP
- Nginx
- VitePress
- Let's Encrypt
- 火山引擎 ARK