OpenClaw 里使用 GPT Image 2：API Key 和 Codex OAuth 怎么选

在 OpenClaw 里，图像模型值应写成 openai/gpt-image-2。真正的选择不是把模型名换来换去，而是决定认证路线：生产环境、账单归属、组织控制和可追踪日志优先时，用 OPENAI_API_KEY；只是想在已经登录 Codex 的 OpenClaw 个人环境里验证能力时，才考虑 Codex OAuth。

先不要把第一张成功生成的图片当成结论。OpenClaw 可能有 fallback provider，OAuth 资料也可能指向错误账号或过期 profile。最小验收动作是：显式指定 openai/gpt-image-2，关闭或标记 fallback，查看 provider 输出或日志，确认认证路线、模型名和返回结果互相一致。

如果 Codex OAuth 返回 HTTP 403，先停下，不要继续改 prompt。检查 OpenClaw 版本、OAuth token、当前账号、workspace、provider 输出和 fallback 配置；生产任务已经等待时，切到 OPENAI_API_KEY 往往更容易定位责任边界。若需求是透明背景，当前 gpt-image-2 不是正确工具，应改用支持透明输出或后处理的路线。

配置 openai/gpt-image-2

OpenAI 的模型 ID 是 gpt-image-2，OpenClaw 的 provider 形式是 openai/gpt-image-2。openai/ 前缀不是装饰，它告诉 OpenClaw 这次 image request 应该进入 OpenAI provider，而不是进入文本模型、Codex 文本路由或备用图像 provider。

先用最小默认配置，不要在同一次修改里同时换 provider、换模型、换 fallback 和换 prompt。配置越小，后面越容易看出失败属于认证、模型引用、工具能力还是输出参数。

hljs json复制
{
  "agents": {
    "defaults": {
      "imageGenerationModel": {
        "primary": "openai/gpt-image-2"
      }
    }
  }
}

API Key 路线需要在 OpenClaw 所在环境里设置 OPENAI_API_KEY。这条路线的价值不是“看起来更高级”，而是账号、账单、额度、项目、组织和日志都可以回到 OpenAI Platform 侧核对。

hljs bash复制
export OPENAI_API_KEY="sk-..."

Codex OAuth 路线不要伪造 API Key。它应该通过 OpenClaw 的 OAuth profile 连接当前 OpenAI/Codex 账号，然后仍然使用同一个 openai/gpt-image-2 模型引用。这里的风险是 profile 状态更隐性：token 过期、账号切换、workspace 不一致、OpenClaw 版本不匹配，都可能表现成图像调用失败。

先验证路线，再相信图片

先列出或检查 image provider。OpenClaw 的 image generation 能力是 provider-aware 的，所以不要只看最终文件是否生成，要看生成动作由谁接管。

hljs bash复制
image_generate action=list

再跑一个很小的显式模型测试。测试 prompt 要简单，避免文字渲染、透明背景、复杂编辑、超大尺寸这些会干扰判断的变量。

hljs bash复制
image_generate model=openai/gpt-image-2 prompt="A simple product icon on a white desk, no text"

看日志时按运营视角读结果：成功但 provider 不是 OpenAI，说明 fallback 生成了图；403 出现在 OAuth 路线，说明先查 profile、账号、workspace 和 token；模型不接受，说明 provider 前缀、OpenClaw 版本或模型访问状态需要重核；透明背景失败，说明参数不受支持，不该继续改 prompt。

生产任务优先选 API Key

OPENAI_API_KEY 更适合有客户、批量任务、复盘记录或团队责任边界的场景。失败时，你能把 OpenClaw 日志和 OpenAI API 响应放在一起看；成功时，也能把成本、额度和账号归属写进交付记录。

API Key 并不自动代表更便宜，也不代表所有账号都已经可用。它代表更清楚的控制面：谁付费、谁看日志、谁有权限、谁能解释失败。只要图像任务进入生产，这些问题比少配一把 key 更重要。

成本问题应该交给专门的成本页面，而不是塞进 OpenClaw 路线设置。需要比较便宜 API 路线时，可以看 GPT Image 2 API 成本路线；这里的任务只是证明 OpenClaw 是否用了你要的路线。

Codex OAuth 只在 profile 证据充足时使用

Codex OAuth 的吸引力在于轻量：已经在 OpenClaw 里登录 Codex 的用户，可能不想再维护单独的 API Key。做个人验证、低风险实验、临时流程时，这条路线确实省事。

但 OAuth 不是官方免费的 API Key，也不是所有账号天然支持图像路线的保证。它是一个登录 profile。profile 背后是哪一个账号、哪个 workspace、token 是否刷新、OpenClaw 是否把 image route 接到这个 profile，全部都要验证。

HTTP 403 出现时，把它当作认证和路线问题。先重新认证，清掉旧 profile，确认 OpenClaw 版本，核对模型访问，再关闭 fallback 重试。如果同样的 403 持续存在，而你又需要稳定交付，切到 OPENAI_API_KEY 更务实。

处理 403、fallback 和不支持参数

大多数失败可以分成四类：认证、provider 选择、参数不支持、环境未准备好。不要一次改很多设置，否则下一次成功也不能证明到底是哪一步修好了问题。

透明背景要硬停。当前 gpt-image-2 不支持透明背景输出，继续调整提示词没有意义。需要透明素材时，先用工作路线生成图，再使用支持透明背景的模型或后处理流程。

4K 也不要和路线验证混在一起。OpenClaw 路线验证回答“谁生成了图”，高分辨率验证回答“返回文件是否达到目标尺寸”。尺寸、保存后像素和高分辨率参数属于 GPT Image 2 4K 设置 的范围。

路线验收记录

路线验收要把“能生成图片”和“由 OpenAI GPT Image 2 生成”拆成两个结论。第一条结论只说明某个 provider 返回了图，第二条结论必须同时看到模型引用、provider 名、认证 owner 和 fallback 状态。

中文社区常把 Codex OAuth 简写成“免 API Key”，但发布正文不能这样下结论。更准确的说法是：OAuth 可以是一条认证路线，是否能跑 image route 取决于 OpenClaw 版本、账号状态、workspace 和 provider 实现。

如果团队里有人只保存了图片文件，没有保存日志或 provider 输出，这个结果不能进入验收记录。补测时要用小 prompt、关闭 fallback、保留请求时间和 profile 名称，避免把视觉质量评审当成路线证明。

API Key 路线也需要验收。设置了环境变量并不代表 OpenClaw 一定使用它；如果 OpenClaw 的默认模型或 provider 配置仍指向其他路线，图像请求可能不会进入 OpenAI provider。

Codex OAuth 路线的排障顺序应该固定：先确认当前 profile，再确认账号和 workspace，再确认 token 刷新，最后确认 OpenClaw image provider 是否把 openai/gpt-image-2 接到这条 OAuth 路线。

生产检查清单

交给同事或自动化流程之前，把路线合同写清楚。合同里至少要有模型引用、认证 owner、provider 证据、fallback 策略、失败分支和切换条件。

保留一个小型 smoke test。它不追求画质，只验证路线健康：不要文字、不要透明背景、不要超大尺寸、不要复杂编辑。smoke test 通过后，再使用相同模型引用和日志设置运行正式图像 prompt。

常见问题

OpenClaw 里模型名应该写什么？

写 openai/gpt-image-2。OpenAI 的模型 ID 是 gpt-image-2，OpenClaw 需要 provider 前缀来路由到 OpenAI 图像 provider。

Codex OAuth 等于 GPT Image 2 API 免费吗？

不等于。Codex OAuth 是认证路线，不是官方免费 API 权益。免费边界和安全测试路线应看 GPT Image 2 API 免费边界。

API Key 和 Codex OAuth 应该选哪个？

生产任务优先 OPENAI_API_KEY，因为账单、日志、组织控制和支持责任更清楚。Codex OAuth 适合 profile 已通过验证的个人或轻量测试。

Codex OAuth 为什么会返回 HTTP 403？

把 403 当成认证/profile 分支：检查 OpenClaw 版本、OAuth token、当前账号、workspace、模型访问和 fallback 配置。持续失败时切 API Key。

怎么确认不是 fallback 生成的图？

关闭 fallback，显式指定 model=openai/gpt-image-2，查看 provider 输出或日志。如果日志显示其他 provider，就不能把图片算作 OpenAI 路线成功。

GPT Image 2 能直接生成透明背景吗？

当前不要依赖 gpt-image-2 做透明背景。需要透明素材时，先生成主体图，再用支持透明背景的模型或后处理步骤。

OpenClaw 可以做 GPT Image 2 的 4K 输出吗？

先证明 OpenClaw 走了 openai/gpt-image-2，再验证尺寸参数和保存后像素。4K 的参数与文件验证应交给专门的高分辨率流程。