Files

3.0 KiB
Raw Permalink Blame History

1-h Image Providers (1h-openai-image & 1h-gemini-image)

OpenClaw 图像生成驱动模块集合,根据上游协议严格分离为两个专职驱动,彻底杜绝跨协议调用引发的 400 错配。


包含驱动一览

Provider ID 对应协议 默认模型 适用场景 / 支持模型
1h-openai-image OpenAI 标准图像协议
(POST /v1/images/generations)
gpt-image-2 专为号池/公益站的 OpenAI 协议图像生成打造:
• gpt-image-2
• gpt-image-2.5
• gpt-image-2.5-flare
• gpt-image-2.5-sunburst
1h-gemini-image Google Gemini 原生内容协议
(POST /v1beta/models/...:generateContent)
gemini-3.1-flash-image 专为渠道 87(CLI-Proxy)的原生 Gemini 图像生成打造:
• gemini-3.1-flash-image

核心特性

  1. 1h-openai-image(OpenAI 协议):

    • 尺寸安全映射:自动将 16:9 / 9:16 安全归一化为通用尺寸(1792x1024 / 1024x1792 / 1536x1024),修复 Issue #168665;
    • URL 优先与双模自适应:默认使用 response_format=url,完美契合公益站防 400 校验,并自动将链接异步下载为本地图片文件;
    • 图生图编辑:传入 inputImages 时自动切至 Multipart 表单走 /v1/images/edits。
  2. 1h-gemini-image(Gemini 协议):

    • 原生 JSON 结构:以标准的 contents[].parts 构造请求,并在返回时原生提取 inlineData Base64 流;
    • 无损回退链:作为主模型的首选备用渠道,当 OpenAI 渠道拥堵超时时,以纯正 Gemini 协议秒级接管。

配置说明

在 ~/.openclaw/openclaw.json 中配置:

{
  "plugins": {
    "entries": {
      "1h-tools": {
        "enabled": true,
        "config": {
          "openaiImage": {
            "baseUrl": "http://host.incus.internal:8080/v1",
            "defaultModel": "gpt-image-2",
            "apiKey": "1842894d437ee54443a99390f79811ba9ebb785175af340b492e3398dc317921",
            "responseFormat": "url",
            "allowPrivateNetwork": true
          },
          "geminiImage": {
            "baseUrl": "http://host.incus.internal:8080/v1beta",
            "defaultModel": "gemini-3.1-flash-image",
            "apiKey": "1842894d437ee54443a99390f79811ba9ebb785175af340b492e3398dc317921",
            "allowPrivateNetwork": true
          }
        }
      }
    }
  },
  "agents": {
    "defaults": {
      "mediaModels": {
        "image": {
          "primary": "1h-openai-image/gpt-image-2",
          "fallbacks": [
            "1h-gemini-image/gemini-3.1-flash-image"
          ]
        }
      }
    }
  }
}

使用方法

配置完成后,OpenClaw 内置的 image_generate 工具即可自动调度:

  • 正常请求:默认走 1h-openai-image/gpt-image-2;
  • 容灾回退:若主模型超时(如公益站排队超时 499),系统自动使用纯正的 1h-gemini-image/gemini-3.1-flash-image 协议回退,绝不报 400。