Codex Profiler

Polar Sponsor
爱发电 赞助
.NET 9.0

通过 Telegram 命令管理 OpenAI Codex 配置文件,支持用量查询与 OAuth Token 刷新,并提供队列化安全应用(queued safe apply)及进度更新。

QQ 维护路径: 对所有 Codex 配置操作使用代码解析器.

功能概述

QQ 维护路径: 对所有 Codex 配置操作使用代码解析器.是一项面向实际任务的技能,主要用于Standone codex-usage 和 codex-auth 技能被贬损;此技能将两个脚本合并:. . scripts/codex usage.py.。

核心要点

  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
  • 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
  • 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;

结果检查与注意事项

涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。

✅ 维护路径:所有 Codex 档案操作统一使用 codex-profiler。 独立的 codex-usage 和 codex-auth 技能已弃用。

该技能整合了以下两个脚本:

  • scripts/codex_usage.py(用量/配额检查)
  • scripts/codex_auth.py(用于启动/状态查询的 OAuth 辅助工具)

对于认证/档案变更操作,本技能现统一采用网关原生命令:openclaw models auth ...。

安全默认行为

  • 用量检查默认为只读操作。
  • 认证状态由运行时动态管理;一次性直接编辑文件不可靠,可能被内存中或冷却期(cooldown)状态覆盖。
  • 请将 auth-profiles.json 视为网关托管状态,在常规操作中禁止直接修改。
  • 优先使用网关原生命令进行认证变更(如 openclaw models auth ...、openclaw models auth order ...),而非脚本级的文件写入。
  • 执行变更前,务必先以 dry-run / 只读模式预检(preflight),再应用变更,最后验证结果(详见下方严格防漂移流程)。
  • 允许/禁止操作边界详见 RISK.md。

命令列表

用量检查

  • /codex_usage → 选择器(默认 / 全部 / 已发现的档案)
  • /codex_usage

认证操作

  • /codex_auth → 选择器(档案列表)
  • /codex_auth
  • /codex_auth finish (仅限辅助用途;档案/顺序变更必须使用网关原生命令)

跨渠道 UX 要求

对于 /codex_usage,需首先单独发送一条即时进度消息:

  • “正在运行 Codex 用量检查……”

交付规则:

  • 若进度消息通过通道消息工具路径(channel message tool path)发送,则最终结果也必须经由同一路径(相同目标/会话)返回,并返回 NO_REPLY。
  • 禁止混合交付(例如:工具路径发进度 + 普通文本回复发结果)。

对于认证/档案/顺序变更操作,须明确提示用户:写入由网关统一管理,并强制执行“先应用、后验证”流程:

  • “我将通过 openclaw models auth ... 执行此操作,并随后使用 models status 和 auth order get 进行验证。”
  • “我不会直接手动编辑认证文件,因为运行时状态可能发生漂移,导致一次性编辑被覆盖。”

交互适配器

  • 若支持内联按钮(inline buttons):使用选择器按钮。
  • 若不支持内联按钮:使用文本回退提示(text fallback prompts)。
  • 对同一用户的重复请求实施约 20 秒的抑制机制(duplicate-request suppression)。
  • 响应中严禁回显完整 callback URL。

档案移除策略(强制要求)

  1. 推荐方式(默认):操作性停用,非硬删除
    • 将目标档案从活跃提供方顺序中移除(openclaw models auth order set ...),确保其永不被选中。
    • 除非用户明确要求永久删除,否则保留档案数据完整。
  2. 仅在用户明确指令下执行硬删除
    • 仅当用户清晰表达“硬删除”或“永久移除”意图时,才执行永久档案删除。
    • 若当前安装的 OpenClaw 版本不支持网关原生删除功能,请勿自行设计高风险的实时文件编辑;应改用受控的维护窗口流程(controlled maintenance window flow)。

严格防漂移认证变更流程(强制要求)

针对认证/档案/顺序变更,必须严格遵循以下三步流程:

  1. 预检(只读)
openclaw models status --json
openclaw models auth order get --provider openai-codex --agent 
  1. 应用(网关原生命令)
openclaw models auth order set --provider openai-codex --agent   
# 或
openclaw models auth order clear --provider openai-codex --agent 
# 或提供方登录流程
openclaw models auth login --provider openai-codex
  1. 验证(变更后执行,不作任何假设)
openclaw models status --json
openclaw models auth order get --provider openai-codex --agent 

验证步骤严禁跳过。若结果与预期不符,禁止手动编辑文件;应诊断问题并重新通过网关原生命令执行变更。

如何运行

# 用量检查(只读)
python3 skills/codex-profiler/scripts/codex_usage.py --profile all --timeout-sec 25 --retries 1 --debug
python3 skills/codex-profiler/scripts/codex_usage.py --profile all --format text

# OAuth 辅助工具(仅解析 callback / 查询状态)
python3 skills/codex-profiler/scripts/codex_auth.py start --profile default
python3 skills/codex-profiler/scripts/codex_auth.py status

安全立场

  • 本技能禁止执行远程 shell 命令(如 curl|bash、wget|sh)。
  • 本技能路径中不含任何 sudo / SSH / 系统级主机变更命令。
  • 用量检查仅限访问可信 HTTPS 终端节点白名单(chatgpt.com)。
  • callback URL 与令牌材料均属敏感信息,严禁在响应中完整回显。

多账号轮换指南

当被问及运行多个 Codex 账号/档案、轮换策略或备用方案时,请查阅:

  • references/multi-account-rotation.md

快速聊天回答请使用简版模板;配置/排障请求请使用深度模板。

备注

  • 默认使用位于 ~/.openclaw/agents/main/agent/auth-profiles.json 的认证档案。
  • 当前唯一可信来源为 auth-profiles.json;auth.json 仅为向后兼容遗留文件,不应作为主状态源使用。
  • 若档案路由行为异常,请先排查混合状态问题(如缺失/陈旧的 auth-profiles.json、残留的遗留文件、或陈旧的运行时冷却状态),再判断是否为模型回退缺陷。
  • 两个不同档案标签(profile labels)共用同一 accountId 并非自动视为缺陷。在此环境中,多个标签可映射至同一 workspace/account 身份且仍正常运作。只要两个档案均通过认证验证并在 /codex_usage 中可用,即视为健康状态;仅当出现认证失败或路由失败时才需进一步排查。
  • Codex 用量终端节点:https://chatgpt.com/backend-api/wham/usage。
  • 用量脚本现将 401 错误归类为 auth_not_accepted_by_usage_endpoint 并给出清晰提示,同时仍返回本地档案健康状态。
  • 用量输出现包含顶层字段 summary、formatted_profiles 和 suggested_user_message,便于更整洁地格式化 slash 命令响应。
  • /codex_usage 的首选严格输出格式(每档案单行):
    • 🟢 %profile%` — 5h **%5h_left%** | week **%week_left%** | r5 **%5h_reset%** | rw **%week_reset%**`
    • 用量受限时使用 🟠,不可用或认证无效时使用 🔴。
    • 不添加前导说明、不使用表格、不附加结尾摘要(除非用户明确要求)。
  • OAuth 流程:OpenAI 认证终端节点 + 本地回环(localhost)回调,端口为 1455。
  • 首选变更路径为网关原生命令(openclaw models auth ... / openclaw models auth order ...),且必须配合强制预检 + 验证流程。
  • codex_auth.py status --profile 仍适用于按档案粒度的辅助状态检查。
  • 临时载荷(payload)/令牌(token)等中间产物仅在验证成功前保留,验证完成后立即清理。
  • 本技能路径中执行用量终端节点读取操作时,无需安装 Codex CLI。

相关专题

更多
Codex Agent编程与自主开发能力调优专题
Codex Agent编程与自主开发能力调优专题

PHP中文网为您提供Codex Agent编程与自主开发能力调优专题。针对AI Agent全权委托开发模式,我们为您系统梳理了Harness Engineering(驾驭工程)核心理念,以及涵盖AGENTS.md规范编写、Skills技能配置、Worktree沙盒隔离与多Agent协作架构的实战指南。

2026.06.10

128

7

Codex AI编程工具新手指南
Codex AI编程工具新手指南

全面解析Codex AI编程工具的核心原理、功能特点与实际用途,提供适合新手的Codex入门教程、环境配置方法、代码生成演示与常见问题解答,帮助开发者快速掌握AI自动写代码能力,提升编程学习与开发效率。

2026.05.27

270

10

Codex 模型原理与AI软件工程进阶
Codex 模型原理与AI软件工程进阶

Codex 是基于通用大模型底座,通过海量代码语料与真实 Pull Request 进行专项微调的代码专用模型,能深度理解代码语法树与跨文件依赖,实现从自然语言到高质量工程代码的精准转化。在 AI 软件工程进阶中,Codex 推动了从提示词工程向“驾驭工程(Harness Engineering)”的范式跃迁。

2026.05.26

117

10

Codex API集成与AI编程生态开发
Codex API集成与AI编程生态开发

Codex API 集成是构建下一代 AI 编程生态的核心基石,能通过 API 将强大的代码生成与推理能力无缝接入 VS Code、JetBrains 等主流 IDE 插件,还能将其深度嵌入 CI/CD 流水线,实现自动化的代码审查、单元测试生成与 Bug 修复。结合 Amazon Bedrock 等云平台的托管服务,企业可以灵活打造符合内部安全规范的专属 AI 编程助手。

2026.05.26

144

10

Codex AI 编程代理与智能开发工作流
Codex AI 编程代理与智能开发工作流

Codex 是一款超越传统代码生成的 AI 编程代理,致力于构建全生命周期的智能开发工作流。通过持久线程保留上下文,支持多智能体并行协作与后台自动化运维。借助沙箱权限控制、Plan/Steer 任务管理机制,Codex 既能自主拆解并执行复杂工程任务,又能让开发者牢牢掌控项目进程。从需求分析、编码测试到代码审查与部署,Codex 将 AI 深度融入研发全链路,极大提升了软件工程的交付效率与质量标准。

2026.05.26

234

10

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Codex 应用程序简介
Codex 应用程序简介

共0课时 | 192人学习

Codex官方文档
Codex官方文档

共0课时 | 0人学习