核心功能
codex-profiler 是一个面向 OpenAI Codex 的多账户管理技能,整合了用量查询(/codex_usage)和认证管理(/codex_auth)两大功能模块,替代已废弃的独立 codex-usage 和 codex-auth 技能。
显著优点
1. 统一入口:单一技能处理配置、认证、用量监控全流程,降低多技能切换的认知负担
2. 安全优先设计:
3. 严格的防漂移工作流:强制要求"预检→应用→验证"三步流程,杜绝配置与实际运行状态的偏差
4. 多账户支持:内置账户轮换策略参考文档,支持故障自动切换场景
5. UX 优化:进度消息与最终结果分离发送,支持按钮/文本双模态交互
- 用量查询默认为只读操作,无数据变更风险
- 认证变更强制使用网关原生命令(
openclaw models auth ...),禁止直接文件编辑 - 敏感信息(回调 URL、Token)禁止完整回显
潜在局限
- 依赖 OpenClaw 网关环境,无法独立运行于裸机
- 硬删除功能受网关版本限制,旧版本需维护窗口流程
- OAuth 回调固定在 localhost:1455,网络隔离环境需特殊处理
- 用量端点限制于
chatgpt.com域名白名单
适合人群
- 需要同时管理多个 Codex 账户的开发者/团队
- 对配置一致性有高要求的企业环境
- 需要用量监控与配额预警的运维场景
常规风险
- 401 认证失败:用量端点拒绝时标记为
auth_not_accepted_by_usage_endpoint,需检查网关状态 - 运行时状态覆盖:直接编辑
auth-profiles.json文件会被内存/冷却状态覆盖,必须使用网关命令 - 重复请求:20 秒内同一用户重复请求需抑制,避免操作冲突
- 混合交付风险:进度消息与最终结果必须使用同一通道,禁止工具消息+纯文本回复的混合模式
技术细节
- 配置文件路径:
~/.openclaw/agents/main/agent/auth-profiles.json - 用量端点:
https://chatgpt.com/backend-api/wham/usage - OAuth 流程:OpenAI 端点 + localhost:1455 回调
- 输出格式:单行状态指示(🟢正常/🟠受限/🔴不可用)+ 配额余量 + 重置时间