Codex Profiler 是一款专为管理 OpenAI Codex 配置文件而设计的 Telegram 机器人技能（Skill），它将原本分散的用量查询与 OAuth 令牌刷新功能整合为统一的操作入口。用户可以通过简单的命令快速查看当前配置的 Codex 账户使用情况、剩余额度以及重置时间，极大提升了多账户环境下的管理效率。该工具默认读取本地 `~/.openclaw/agents/main/agent/auth-profiles.json` 中的认证配置，并支持通过安全的 HTTPS 接口从官方后端获取实时数据。此外，其设计充分考虑了生产环境的安全边界，所有可能影响系统状态的操作均需显式确认，且禁止远程 shell 执行或系统级修改，确保操作过程可控可信。 作为对旧版独立脚本的升级替代方案，Codex Profiler 已全面取代 `codex-usage` 和 `codex-auth` 两个单独技能。它采用队列化安全应用机制处理 OAuth 令牌更新流程，在后台静默完成网关重启等耗时操作，同时避免干扰用户正在进行的任务。整个交互流程遵循 Telegram 平台规范：进度信息优先以独立消息形式发送，最终结果则通过相同通道返回，保证用户体验的一致性。对于不支持内联按钮的平台，系统会自动切换至文本提示模式，并内置防重复请求机制（约20秒内屏蔽重复指令）。 该工具特别适用于需要频繁切换多个 Codex 账号的开发者或团队，无论是日常监控 API 调用余量，还是定期刷新访问凭证都变得极为便捷。其输出格式经过优化，以清晰易读的段落结构展示每个配置文件的可用状态、5小时与周配额详情及下次重置时间，方便用户快速定位问题账号。值得一提的是，即使遇到鉴权失败（如返回401错误），系统也会明确提示‘auth_not_accepted_by_usage_endpoint’，而非简单报错，帮助用户区分是本地配置问题还是服务端限制。
核心功能特点
- 统一管理 Codex 配置文件的使用量查询与 OAuth 令牌刷新
- 支持按指定配置文件筛选显示，兼容全量扫描与自动发现模式
- 提供清晰的用量摘要与格式化输出，包含剩余时间与重置日期
- 采用队列化安全应用机制，后台静默处理敏感操作避免中断
- 严格遵循安全策略，禁止远程 shell 执行与系统级修改命令
- 适配多种交互方式，支持内联按钮与纯文本 fallback 提示
适用场景
Codex Profiler 最典型的应用场景是开发者日常维护多个 OpenAI Codex 账号时的配额监控。例如，当你在团队协作中负责协调不同项目的 API 调用权限时，只需输入 `/codex_usage all` 即可一次性查看所有已注册配置的剩余额度、是否受限以及下次重置时间。这种集中式的视图能让你迅速识别哪些账号即将耗尽资源，从而提前规划代码生成任务调度，避免因突发限流导致项目延误。 另一个高频使用场景是在部署自动化 CI/CD 流水线期间临时获取访问凭证。假设你需要在无人值守环境下更新某个长期运行的 Codex 实例的 OAuth 令牌，此时可通过 `/codex_auth ` 启动本地回调服务（默认监听 localhost:1455），然后在授权页面完成身份验证后使用 `–queue-apply` 参数将新令牌加入后台队列。这样既保证了安全性，又不会阻塞主进程运行，特别适合集成到 Jenkins、GitHub Actions 等持续交付系统中。 对于个人用户而言，若经常在不同设备间切换开发环境，Codex Profiler 也能显著简化跨平台同步难题。由于所有配置均基于标准 JSON 文件存储，配合 Telegram 的跨端消息推送能力，你可以在手机端快速检查笔记本上的 Codex 账户状态，甚至远程触发令牌刷新而不必手动登录网页端。这种无缝衔接的体验尤其适合远程办公或移动编程场景，让生产力工具始终保持在线可用状态。