1. 一台能跑 OpenClaw 的机器#

官方当前建议：

• Node 24 推荐
• Node 22.14+ 也支持
• Windows、macOS、Linux 都可以

如果你是 Windows 用户，PowerShell 或 WSL2 都能跑。
官方文档提到 WSL2 通常更稳定，但原生 Windows 也在支持范围内。

2. 已安装 OpenClaw#

如果你还没装，最省事的是直接走官方安装脚本。

Windows PowerShell 可用：

1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1)))

如果你已经自己管好了 Node，也可以直接：

1
npm install -g openclaw@latest
2
openclaw onboard --install-daemon

3. 可用的 ChatGPT / Codex 登录授权#

这是本文方案的关键。
因为我们不是走 OPENAI_API_KEY，而是走 OpenAI Codex OAuth。

换句话说，你至少要满足下面一点：

• 已经能正常使用 ChatGPT / Codex 登录
• 愿意在 OpenClaw 里完成一次 OpenAI Codex OAuth 登录

路线 1：API Key#

• 走 openai/*
• 典型是 OPENAI_API_KEY
• 对应 OpenAI Platform 按量计费

路线 2：Codex 订阅 OAuth#

• 走 openai-codex/*
• 用 ChatGPT / Codex 登录授权
• 不需要单独配置 OPENAI_API_KEY

而图片生成这块，OpenClaw 的最新文档已经把它打通了：

• 图片生成默认模型可以设为 openai/gpt-image-2
• 当本机已配置 openai-codex OAuth 时，图片请求可以通过这个 OAuth 路线转发

这正是本文主题成立的原因。

第一步：完成 OpenAI Codex OAuth 登录#

如果你已经安装好了 OpenClaw，先执行：

1
openclaw onboard --auth-choice openai-codex

如果你不想重新跑 onboarding，也可以直接登录：

1
openclaw models auth login --provider openai-codex

完成后，OpenClaw 就会拿到 openai-codex 这条认证路线。

建议你顺手验证一下：

1
openclaw models list --provider openai-codex

如果这里能看到可用模型，说明 OAuth 这一步基本已经打通。

第二步：把默认聊天模型设好#

如果你平时也想在 OpenClaw 里直接聊天，可以顺手设一下默认模型：

1
openclaw config set agents.defaults.model.primary openai-codex/gpt-5.4

这一步不是图片生成的必需项，但很推荐。
因为后面你让代理一边理解需求、一边直接出图时，整个工作流会更顺。

第三步：把图片生成模型设成 openai/gpt-image-2#

这一句才是本文最关键的配置：

1
openclaw config set agents.defaults.imageGenerationModel.primary openai/gpt-image-2

如果你希望图片请求更稳一点，也可以顺手加上超时：

1
{
2
  "agents": {
3
    "defaults": {
4
      "imageGenerationModel": {
5
        "primary": "openai/gpt-image-2",
6
        "timeoutMs": 180000
7
      }
8
    }
9
  }
10
}

配置好以后，OpenClaw 在检测到你的 openai-codex OAuth 已经存在时，就可以把图片生成请求通过这条授权路线发出去，而不是强制要求你填写 OPENAI_API_KEY。

第四步：确认 image_generate 工具已经可用#

你可以直接在 OpenClaw 里发一句测试请求，比如：

1
生成一张适合博客封面的海报：深色科技背景，一只极简风格的小龙虾，带一点未来感，标题区域留白。

或者更明确一点：

1
请用 image_generate 生成一张 16:9 封面图：
2
- 主题：OpenClaw 接入 ChatGPT Images 2.0
3
- 风格：科技感、简洁、适合博客头图
4
- 元素：小龙虾、对话气泡、图片画框
5
- 颜色：深蓝、青色、少量暖橙点缀

如果一切正常，OpenClaw 会自动调用 image_generate。
你不需要自己手动再去拼 OpenAI Images API 请求。

1. 不用单独创建和保存 OPENAI_API_KEY#

少一套密钥管理，少一层泄露风险，也少一个环境变量配置步骤。

2. 不走 OpenAI Platform 的 API 充值逻辑#

如果你本来就是订阅用户，这条路的心理门槛低很多。
至少你不用先开 API、绑卡、充值、再盯着按量消耗。

3. 更适合放进个人工作流#

OpenClaw 的好处本来就是把聊天、代理、工具调用、图片生成统一起来。
如果聊天走一套授权，出图又走另一套 API，管理体验会变碎。

1. “无需 Token”不等于完全无限制#

更准确地说，这里是不走 OpenAI Platform API 的按量 Token 计费。
你的可用性仍然取决于：

• 账号本身是否具备可用的 Codex / ChatGPT OAuth 权限
• OpenClaw 当前版本是否已支持这条图片路由
• 你的本地 OAuth 状态有没有过期

2. 有些旧教程还停留在 gpt-image-1#

截至 2026 年 5 月 2 日，OpenClaw 官方文档里已经明确把 openai/gpt-image-2 作为默认 OpenAI 图片生成模型。
如果你看到旧文章还在教你优先用 gpt-image-1，最好重新核对一遍。

3. 透明背景并不一定默认走 gpt-image-2#

OpenClaw 文档提到，透明背景场景下，旧的 gpt-image-1.5 仍然有它的意义。
所以如果你做的是：

• PNG 透明背景图标
• WebP 透明背景素材
• 需要干净抠图边缘的素材

就别死磕默认模型，按场景切换会更稳。

4. 登录成功不代表图片一定马上可用#

有时聊天模型可用，但图片模型还没被设为默认。
这时候通常不是认证坏了，而是你少做了这一步：

1
openclaw config set agents.defaults.imageGenerationModel.primary openai/gpt-image-2

组合一：写作配图#

• 聊天模型：openai-codex/gpt-5.4
• 图片模型：openai/gpt-image-2
• 用途：文章封面、插图、社媒配图

组合二：改图优化#

• 先让代理帮你整理提示词
• 再用 image_generate 生成第一版
• 最后继续基于参考图改结构、改材质、改风格

组合三：博客自动化#

• 让 OpenClaw 帮你写标题
• 帮你生成封面提示词
• 直接调用图片生成
• 再回填到文章 frontmatter

这时候 OpenClaw 才真正体现出“小龙虾工作流”的价值。
它不是单纯替代一个出图网站，而是把出图并进你的内容生产链路。

1. 没有 OPENAI_API_KEY，真的能在 OpenClaw 里做图吗？#

可以。
前提是你已经完成 openai-codex 的 OAuth 登录，并把图片生成模型设成 openai/gpt-image-2。

2. 这是不是完全免费？#

不建议这样理解。
更准确地说，是不用单独开 OpenAI API Key，也不走 OpenAI Platform 的按量 Token 计费。是否“免费”，取决于你当前账号本身具备什么订阅和权限。

3. 图片生成为什么没反应？#

优先检查这几项：

• openai-codex 是否登录成功
• agents.defaults.imageGenerationModel.primary 是否已经设成 openai/gpt-image-2
• 当前 OpenClaw 版本是否足够新

4. 我能不能继续用 API Key？#

当然可以。
如果你更重视稳定的 API 工作流、预算管理和程序化调用，API Key 路线依然完全成立。

5. 这条路适合长期用吗？#

如果你本来就是 ChatGPT / Codex 用户，而且主要是个人内容创作、轻量代理和工作流整合，我觉得很适合。
因为它真的能少掉很多 API 层面的折腾。