OpenClaw Codex GPT-5.4 Enable

OpenClaw Codex GPT-5.4 Enable 技能

把 openAI-codex/gpt-5.4 用“配置层补丁”方式接入 OpenClaw，避免直接改安装目录或整包重编译。

适用场景

当你遇到下面这种情况时使用：

openAI/gpt-5.4 已经在 OpenClaw 中可见 但 openAI-codex/gpt-5.4 仍然显示 not allowed / missing 想快速验证 GPT-5.4 Codex 通道，而不是先改 Homebrew 安装产物 希望把 提供者、模型、别名、fallback 一次补齐 核心思路

优先改 ~/.OpenClaw/OpenClaw.json：

在 模型s.提供者s 中新增 openAI-codex 设置： baseUrl: https://chatgpt.com/backend-API API: openAI-codex-响应s 为该 提供者 补上模型 gpt-5.4 在 代理s.defaults.模型s 和 代理s.defaults.模型.fallbacks 中补上 openAI-codex/gpt-5.4 给它加一个别名，例如 GPT54Codex 用 OpenClaw 模型s 列出 和 会话_状态(模型='openAI-codex/gpt-5.4') 验证 为什么优先走配置层 风险更低：不碰安装目录内打包 JS 回滚更简单：只需恢复一份 JSON 配置 更适合快速试验和迁移 对已经在跑的 OpenClaw 实例更友好 目标文件 ~/.OpenClaw/OpenClaw.json

建议操作前先备份：

cp ~/.OpenClaw/OpenClaw.json ~/.OpenClaw/OpenClaw.json.bak.$(date +%Y%m%d-%H%M%S)

参考配置结构

字段名可能随 OpenClaw 版本略有变化，请以你当前 OpenClaw.json 结构为准，把下面内容合并进去。

{ "模型s": { "提供者s": { "openAI-codex": { "APIKey": "$OPENAI_API_KEY", "baseUrl": "https://chatgpt.com/backend-API", "API": "openAI-codex-响应s", "模型s": { "gpt-5.4": { "label": "GPT-5.4 Codex", "上下文令牌s": 400000, "max输出令牌s": 128000, "modalities": ["text", "image"], "supportsReasoning": true } } } } }, "代理s": { "defaults": { "模型s": { "GPT54Codex": "openAI-codex/gpt-5.4" }, "模型": { "fallbacks": [ "openAI-codex/gpt-5.4" ] } } } }

实战流程 1) 先确认当前支持面 OpenClaw 模型s 列出 --plAIn | grep 'gpt-5.4'

判断点：

如果 openAI/gpt-5.4 已经存在，说明基础支持大概率已经在 如果只有 OpenAI 版本，没有 Codex 版本，就继续补配置 2) 备份配置 cp ~/.OpenClaw/OpenClaw.json ~/.OpenClaw/OpenClaw.json.bak.$(date +%Y%m%d-%H%M%S)

3) 编辑 提供者

在 模型s.提供者s 里新增：

提供者 id：openAI-codex baseUrl: https://chatgpt.com/backend-API API: openAI-codex-响应s 4) 补模型定义

给 openAI-codex 提供者 增加 gpt-5.4 模型定义，至少补：

label 上下文/max 令牌s text/image modality reasoning 支持 5) 补 代理 默认映射

在 代理s.defaults.模型s 里补别名：

{ "GPT54Codex": "openAI-codex/gpt-5.4" }

在 代理s.defaults.模型.fallbacks 里补：

[ "openAI-codex/gpt-5.4" ]

6) 验证模型注册 OpenClaw 模型s 列出 --plAIn | grep 'openAI-codex/gpt-5.4'

7) 验证网关是否真正接受

用 OpenClaw 的状态能力做快速实测：

# 在 OpenClaw 会话内 会话_状态(模型='openAI-codex/gpt-5.4')

成功标准：

不再报 not allowed 模型可被选中 提供者 认证链路走 openAI-codex:default（视环境展示而定） 经验结论 已验证有效的判断逻辑 先看官方 PR / 改动方向，确认是不是“版本已支持、只是本地没放开” 如果核心 提供者 能力已在，优先尝试配置层补齐 用 会话_状态 验证，比只看静态配置更靠谱 改完后如果上下文上限没有立刻刷新，优先开新会话再测 这套方法特别适合 想快速上手新模型 不想改安装目录 想沉淀成可复用 SOP 多机器迁移 OpenClaw 配置 排障 not allowed 检查 代理s.defaults.模型s 是否已补别名 检查 fallbacks 是否已包含目标模型 检查 提供者 id 是否与模型前缀一致：openAI-codex/... 模型存在但调用失败 检查 baseUrl 和 API 是否正确 检查对应认证是否已就绪 检查是否需要重启 OpenClaw Gateway / 新建会话 模型列表看不到 检查 JSON 是否写坏 检查 提供者 是否放在正确层级 执行： OpenClaw 模型s 列出 --plAIn | grep codex

回滚 cp ~/.OpenClaw/OpenClaw.json.bak.YYYYMMDD-HHMMSS ~/.OpenClaw/OpenClaw.json

然后重新启动或刷新相关服务。

推荐验证清单 openAI/gpt-5.4 已可见 openAI-codex 提供者 已加入 gpt-5.4 模型定义已加入 GPT54Codex 别名已加入 fallbacks 已加入 openAI-codex/gpt-5.4 OpenClaw 模型s 列出 能看到目标模型 会话_状态(模型='openAI-codex/gpt-5.4') 成功 新会话验证通过 一句话版本

如果 openAI/gpt-5.4 已经支持，而 openAI-codex/gpt-5.4 还没放开，别急着重编译：先用 ~/.OpenClaw/OpenClaw.json 做 提供者 + 模型 + alias + fallback 的配置层补丁，再用 会话_状态 验证。"