OpenClaw 接入 Codex 的完整配置记录

本文目标

把本机现有的 Codex / ChatGPT 登录态接入 OpenClaw，让 OpenClaw 默认使用 Codex 模型。

本次配置结果

截至 2026-03-09，本机已完成：

• OpenClaw 默认模型切换为 openai-codex/gpt-5.3-codex
• OpenClaw 已识别 openai-codex OAuth 认证
• 认证来源为本机已有的 Codex 登录态

实际处理方式

1. 修改默认模型

openclaw models set openai-codex/gpt-5.3-codex

2. 复用本机 Codex 登录态

本机存在：

%USERPROFILE%\.codex\auth.json

其中包含：

• access_token
• refresh_token
• account_id

将其转换为 OpenClaw 使用的 OAuth profile 后，写入：

C:\Users\PC\.openclaw\agents\main\agent\auth-profiles.json

Warning

该文件属于敏感文件，不要公开任何 token 内容。

3. 固定认证顺序

openclaw models auth order set --provider openai-codex openai-codex:codex-cli

验证结果

执行：

openclaw models status --json

关键结果：

• defaultModel 为 openai-codex/gpt-5.3-codex
• providersWithOAuth 包含 openai-codex (1)
• missingProvidersInUse 为空
• openai-codex:codex-cli 状态为 ok

本次踩到的问题

1. models auth login 需要交互式 TTY

直接执行：

openclaw models auth login --provider openai-codex --set-default

在当前自动化环境中会失败，因为它要求交互式终端。

2. auth-profiles.json 的 BOM 编码问题

第一次写入 auth-profiles.json 后，OpenClaw 没有识别到 OAuth profile。

原因：

• 文件被写成了 UTF-8 with BOM

处理：

• 改写为 UTF-8 without BOM

3. 已识别 OAuth，但 Dashboard 仍提示没有 API key

现象：

• openclaw models status --json 已识别 openai-codex
• 但 Dashboard 发消息仍报 No API key found for provider "openai-codex"

原因：

• Gateway 进程仍在使用旧的认证快照

处理：

openclaw gateway restart

然后重新打开 Dashboard。

当前限制

Codex 默认模型已经接好，但这不等于 embedding / memory search 已经配置完成。

目前仍未单独配置：

• OPENAI_API_KEY
• GEMINI_API_KEY
• VOYAGE_API_KEY
• MISTRAL_API_KEY

因此：

• OpenClaw 的默认聊天模型已经可走 Codex OAuth
• 但 memory search 相关检查仍可能提示未配置 embedding provider

使用建议

1. 重新打开 OpenClaw Dashboard
2. 如果浏览器里有旧缓存，优先使用无痕窗口
3. 以 openclaw dashboard --no-open 输出的完整链接为准
4. 如果刚改过 Codex 认证文件，先执行一次 openclaw gateway restart

分类：OpenClaw