Codex Profiler

核心功能概述

codex-profiler 是 OpenAI Codex CLI 的配套运维技能，将原先独立的 codex-usage 与 codex-auth 合并为统一入口。主要覆盖两大场景：

1. 用量监控（`/codex_usage`）

• 支持 default / all / 指定 profile 三种查询模式
• 实时读取 https://chatgpt.com/backend-api/wham/usage 端点
• 输出包含 5 小时窗口与周度限额的双重计量，附带格式化剩余时间与重置倒计时
• 默认只读，删除操作需显式确认并自动备份

2. 认证管理（`/codex_auth`）

• 完整的 OAuth 2.0 流程：start → 浏览器授权 → finish → 后台 apply
• finish 支持 --queue-apply 模式，将配置变更写入 staging 后通过生成脚本异步重启网关，避免阻塞交互会话
• 对 openai-codex:default 设有硬性保护，必须加 --allow-default 才能修改，防止误操作主账户

显著优点

• 统一入口：告别多技能记忆负担，单路径覆盖读/写/认证三类操作
• 安全设计：
• 禁止远程管道执行（curl|bash 等）
• 敏感 token 不回显，callback URL 截断处理
• 20 秒重复请求去重，防止按钮误触双发
• 多账户友好：内置 rotation 指引文档，支持平滑切换与故障兜底
• UX 优化：进度与结果分开发送，避免长轮询超时；自动适配按钮或文本交互环境

局限与风险

| 项目 | 说明 |

|------|------|

| 端点依赖 | 用量查询强依赖 `chatgpt.com` 后端，若 OpenAI 调整接口可能瞬时失效 |

| 认证窗口 | OAuth 回调固定 `localhost:1455`，端口冲突或 headless 环境需手动处理 |

| 异步盲区 | `queue-apply` 后状态需额外 `status` 命令轮询，非即时反馈 |

| 401 模糊性 | 远端返回 401 时区分「凭证无效」与「端点拒绝」依赖本地提示文本，调试略繁 |

适合人群

• 日常需监控多 Codex 账户用量的团队管理员
• 追求「零 SSH、零 sudo」安全基线的企业环境
• 希望将 OAuth 流程集成到聊天机器人/Slack/Discord 的自动化运维场景

常规风险提示

• 数据残留：staging token 文件在重启验证通过前不会自动清理，需关注 /tmp/openclaw/ 目录权限
• 网关重启：queue-apply 会触发网关进程重启，长任务会话需提前预警用户
• profile 误删：delete 默认仅安全 detach，真正移除需二次确认，但仍建议操作前手动导出备份

核心用法

codex-profiler 是一款面向 OpenAI Codex 用户的统一配置管理技能，整合了用量查询（codex_usage）与认证管理（codex_auth）两大功能模块。用户可通过 /codex_usage 命令快速查看默认配置、全部配置或指定配置文件的用量配额，包括 5 小时滚动窗口与周度限额的剩余量、重置时间及倒计时。对于多账号场景，支持 delete <profile> 实现配置的安全分离（默认仅脱钩不删除，需显式确认才会彻底移除）。

认证流程采用标准 OAuth 2.0 PKCE 协议：/codex_auth <profile> 启动授权请求，生成 code_verifier 与 code_challenge，引导用户至 OpenAI 授权页；完成后通过 /codex_auth finish <profile> <callback_url> 接收授权码并交换访问令牌。--queue-apply 模式支持后台异步应用配置，自动完成 OpenClaw Gateway 的重启切换，避免阻塞当前会话。

所有命令均提供交互式选择器（支持按钮或文本回退）与结构化输出，兼容跨平台路径处理，配置文件默认位于 ~/.openclaw/agents/main/agent/auth-profiles.json。

显著优点

1. 零依赖轻量架构：纯 Python 标准库实现（urllib、hashlib、pathlib 等），无第三方包引入，彻底消除供应链攻击面。

2. 军工级数据保护：敏感字段（token、api_key、authorization）通过 scrub_sensitive() 自动脱敏；所有网络通信强制 HTTPS 并限定于 OpenAI 官方白名单端点（chatgpt.com、auth.openai.com）。

3. 防御性操作设计：默认保护 openai-codex:default 主配置，需显式 --allow-default 才允许变更；突变操作前强制创建时间戳备份，并生成一键回滚命令；--dry-run 预览模式降低误操作风险。

4. 多账号运维友好：支持配置文件级别的独立管理，内置多账号轮换策略指引文档，适合团队共享环境或个人多身份切换场景。

5. UX 细节完备：进度消息与最终结果通过同一路径投递，避免混合交付；20 秒重复请求抑制；回调 URL 绝不完整回显。

潜在缺点与局限性

• 平台生态锁定：专为 OpenClaw/OpenAI 生态设计，无法直接迁移至其他 AI 编码助手（如 GitHub Copilot、Cursor）。
• 本地网关依赖：认证应用需重启 OpenClaw Gateway，若网关异常可能导致配置生效延迟或需手动介入。
• 无 GUI 支持：纯命令行交互，对非技术用户存在学习门槛。
• 许可证未明：当前未声明开源许可证，商业场景集成需谨慎评估合规性。
• 审计日志有限：仅保留应用状态快照，缺乏细粒度操作审计（何人、何时、变更何配置）。

适合的目标群体

• 多账号 OpenAI Codex 用户：需在不同组织或个人账号间快速切换的开发者。
• DevOps/平台工程师：负责团队级 Codex 接入配置、配额监控与权限管控的运维人员。
• 安全敏感型企业：对 OAuth 流程、敏感数据脱敏、配置变更可追溯有严格合规要求的组织。

使用风险

• 性能风险：用量查询默认 25 秒超时、1 次重试，网络波动时可能返回部分降级数据；后台 apply 任务依赖 /tmp/openclaw/ 持久化，异常中断需手动清理残留脚本。
• 依赖项风险：虽无第三方包，但依赖 Python 3.x 标准库完整实现，嵌入式或裁剪环境可能缺失 urllib 等模块。
• 配置漂移风险：多用户共享同一配置文件路径时，缺乏并发写入锁（仅 Unix 有 fcntl），极端并发场景可能产生竞态。
• 令牌生命周期：OAuth Token 刷新逻辑未在文档中详述，长期无人值守运行可能面临令牌过期导致的服务中断。