2026-04-11 图片模型配置 & 博客 Nginx 优化
日期
2026-04-11
概述
今天处理了两个重要问题：OpenClaw 图片生成模型配置不生效的排查（imageModel vs imageGenerationModel 区别），以及博客服务器 Nginx 配置的全面优化（SSL、并发、gzip 压缩）。
OpenClaw 图片模型配置问题
问题现象
飞哥配置了 imageModel.primary: volcengine-plan/doubao-seed-2.0-pro，但生成图片时依然使用默认的 MiniMax-M2.7-highspeed 模型。
根本原因
imageModel 是**图片理解（vision）**用的配置，而生成图片需要的是 imageGenerationModel，两个是不同的配置项：
| 配置项 | 用途 |
|---|---|
imageModel | 图片理解/vision（发给模型看图） |
imageGenerationModel | 图片生成（调用生图 API） |
飞哥之前只配置了 imageModel，生成图片时找不到对应模型就 fallback 到默认模型了。
解决方案
在 openclaw.json 的 agents.defaults 下添加：
"imageGenerationModel": "volcengine-plan/doubao-seed-2.0-pro"添加后重启网关（openclaw gateway restart），生成图片就正常走火山引擎的 doubao-seed-2.0-pro 了。
博客 Nginx 配置优化
问题背景
飞哥反映博客 https://openclawgo.site 访问不稳定，刷新几后才能打开。经排查发现 Nginx 配置过于基础，缺少多项生产级优化。
优化项目
| 参数 | 原值 | 新值 | 说明 |
|---|---|---|---|
| worker_connections | 768 | 2048 | 提升并发连接数 |
| multi_accept | off | on | 同时接受多个连接 |
| gzip | 未开启 | 开启 | 压缩 html/js/css 传输 |
| ssl_session_cache | 未配置 | 10m shared | SSL session 复用 |
| ssl_stapling | 未配置 | 开启 | OCSP stapling 加速验证 |
| keepalive_timeout | 未配置 | 65s | 保持长连接减少建连开销 |
| tcp_nodelay | 未配置 | 开启 | 降低延迟 |
优化后访问稳定性和速度都有提升。
SSL 证书 & server_name 配置检查
问题发现
检查 Nginx 配置时发现 server_name 只配置了 openclawgo.site，缺少 www.openclawgo.site。这会导致 www 域名落到默认站点。
修复
server_name openclawgo.site www.openclawgo.site;证书本身没问题，同时包含两个域名（有效期至 2026-10-09）。
图片理解能力现状
问题
配置了 volcengine 的图片理解模型后，调用时报 model does not support images 或 Unknown model 错误。
原因分析
imageModel 配置的模型虽然在 agents.defaults 里指定，但需要在 models.providers 里正式注册才能被 image 工具调用。volcengine 插件启用 ≠ 模型注册。
临时解决方案：mcporter
通过 mcporter 调用 MiniMax MCP 的 understand_image 工具来识别图片：
mcporter call "MiniMax.understand_image(prompt: '...', image_source: '图片路径')" --timeout 120000需要 --timeout 120000（2分钟），默认超时太短会失败。
OpenClaw vs Claude Code MCP 架构区别
- Claude Code：MCP 原生支持，所有工具通过 MCP 暴露，集成无缝
- OpenClaw：
mcp.servers配置只给子 agent / Coding Agent 用，主 agent（大毛）是独立工具注册体系，两者不互通
相关工具
- OpenClaw
- mcporter
- MiniMax MCP
- Nginx
- VitePress
- Let's Encrypt
- 火山引擎 ARK