OpenClaw 接入 openai-codex/gpt-5.5 与 gpt-image-2:文本和生图统一走起来-夜雨聆风

OpenClaw 接入 openai-codex/gpt-5.5 与 gpt-image-2:文本和生图统一走起来

记录在 OpenClaw 中新增 openai-codex/gpt-5.5、复用 Codex OAuth，并验证 openai/gpt-image-2 图像生成链路的完整配置过程。

日期：2026-04-25场景：在本机 OpenClaw 中接入 Codex OAuth 文本模型，并验证最新 OpenAI 图像生成能力

我是 AI灵感闪现，使用 OpenClaw 小龙虾让 AI 自主管理工作和生活上的问题；使用 Claude Code + BMAD AI 驱动敏捷开发框架，让 AI 自主开发和交付软件来表达想法和灵感。是 MoneyMind 省钱思维 App 和 HeartPetBond 心宠纽带 App 开发者。正在实践和分享让 AI 自主解决健康、生活、投资和等方面的问题。我尽可能让 AI 自己完成从目标到交付以及演进的闭环，以最少的人为交互与监督，让 AI 自己跑流程。我只给 AI 想法或目标，全程不陪跑，让 AI 自主运行类似 Tesla FSD 自动驾驶。

背景

本机 Codex 模型已经支持 gpt-5.5。OpenClaw 可以通过 openai-codex provider 复用 Codex OAuth 认证，从而使用 ChatGPT / Codex 订阅套餐内的模型能力，而不需要单独配置传统 OpenAI API Key。

同时，OpenClaw 的图像生成工具已接入最新一代 OpenAI 图像模型，当前实际调用模型为：

openai/gpt-image-2

本文记录本次配置、验证和注意事项。

目标

参考既有 openai-codex/gpt-5.4 配置，新增 openai-codex/gpt-5.5。
使用 Codex OAuth auth profile 认证。
验证文本模型可正常工作。
验证 OpenAI 图像生成模型可正常出图。

当前认证方式

OpenClaw 配置中已有 Codex OAuth 认证 profile：

{"openai-codex:default":{"provider":"openai-codex","mode":"oauth"}}

这意味着 openai-codex/* 模型走的是 Codex OAuth 认证链路，可复用订阅套餐能力。

新增 gpt-5.5 模型别名

在 ~/.openclaw/openclaw.json 的 agents.defaults.models 中，参考已有的 openai-codex/gpt-5.4，加入：

"openai-codex/gpt-5.5":{"alias":"openai-codex/gpt-5.5"}

配置后相关片段类似：

{"openai-codex/gpt-5.4":{"alias":"openai-codex/gpt-5.4"},"openai-codex/gpt-5.5":{"alias":"openai-codex/gpt-5.5"},"openai-codex/gpt-5.4-mini":{"alias":"openai-codex/gpt-5.4-mini"}}

注：当前本机配置里 openai-codex 是内置 OAuth provider，并不一定需要在 models.providers 里显式声明 provider 配置；关键是 auth profile 和 agent model alias 能正确解析。

重启 Gateway

修改配置后，需要重启 OpenClaw Gateway 让配置生效：

openclaw gateway restart

或在 macOS LaunchAgent 场景下：

launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

文本模型验证

重启后，当前会话模型状态显示：

Model: openai-codex/gpt-5.5Auth: oauth (openai-codex:default)Fallbacks: openai-codex/gpt-5.4, mrkdeyte/claude-opus-4-7, quotio-local/claude-opus-4-7

这说明 openai-codex/gpt-5.5 已被 OpenClaw 正确识别，并通过 Codex OAuth profile 工作。

图像生成模型验证

随后测试生图请求：

生成一张猫抓老鼠的图片

OpenClaw 图像生成工具返回：

Generated 1 image with openai/gpt-image-2.

生成文件：

/Users/blogbin/.openclaw/media/tool-image-generation/cat-catching-mouse---215fc1bb-9b51-46fc-a556-51aa673304c1.png

这确认当前生图链路调用的是：

openai/gpt-image-2

也就是当前 OpenAI 最新、最强的图像生成模型线路之一。

最终状态

文本模型：openai-codex/gpt-5.5
认证方式：Codex OAuth，profile 为 openai-codex:default
使用方式：复用 ChatGPT / Codex 订阅套餐能力
图像模型：openai/gpt-image-2
验证结果：文本模型和图像生成均可正常使用

注意事项

OAuth 依赖订阅状态openai-codex/* 模型依赖 Codex OAuth 登录状态和对应订阅额度。如果订阅过期或 OAuth token 失效，需要重新认证。
修改模型配置后要重启 Gatewayopenclaw.json 修改不会自动被所有运行中的 gateway/session 立即读取，建议重启 gateway 后再测试。
模型名以工具实际返回为准本次图像生成工具返回的模型名是 openai/gpt-image-2，不是 chatgpt-image-2。
Fallback 链保留旧模型保留 openai-codex/gpt-5.4 作为 fallback，有助于在新模型不可用时快速回退。