通过 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。
档案移除策略(强制要求)
- 推荐方式(默认):操作性停用,非硬删除
- 将目标档案从活跃提供方顺序中移除(
openclaw models auth order set ...),确保其永不被选中。 - 除非用户明确要求永久删除,否则保留档案数据完整。
- 将目标档案从活跃提供方顺序中移除(
- 仅在用户明确指令下执行硬删除
- 仅当用户清晰表达“硬删除”或“永久移除”意图时,才执行永久档案删除。
- 若当前安装的 OpenClaw 版本不支持网关原生删除功能,请勿自行设计高风险的实时文件编辑;应改用受控的维护窗口流程(controlled maintenance window flow)。
严格防漂移认证变更流程(强制要求)
针对认证/档案/顺序变更,必须严格遵循以下三步流程:
- 预检(只读)
openclaw models status --json openclaw models auth order get --provider openai-codex --agent
- 应用(网关原生命令)
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
- 验证(变更后执行,不作任何假设)
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。
热门AI工具
相关专题
PHP中文网为您提供Codex Agent编程与自主开发能力调优专题。针对AI Agent全权委托开发模式,我们为您系统梳理了Harness Engineering(驾驭工程)核心理念,以及涵盖AGENTS.md规范编写、Skills技能配置、Worktree沙盒隔离与多Agent协作架构的实战指南。
128
2026.06.10
全面解析Codex AI编程工具的核心原理、功能特点与实际用途,提供适合新手的Codex入门教程、环境配置方法、代码生成演示与常见问题解答,帮助开发者快速掌握AI自动写代码能力,提升编程学习与开发效率。
270
2026.05.27
Codex 是基于通用大模型底座,通过海量代码语料与真实 Pull Request 进行专项微调的代码专用模型,能深度理解代码语法树与跨文件依赖,实现从自然语言到高质量工程代码的精准转化。在 AI 软件工程进阶中,Codex 推动了从提示词工程向“驾驭工程(Harness Engineering)”的范式跃迁。
117
2026.05.26
Codex API 集成是构建下一代 AI 编程生态的核心基石,能通过 API 将强大的代码生成与推理能力无缝接入 VS Code、JetBrains 等主流 IDE 插件,还能将其深度嵌入 CI/CD 流水线,实现自动化的代码审查、单元测试生成与 Bug 修复。结合 Amazon Bedrock 等云平台的托管服务,企业可以灵活打造符合内部安全规范的专属 AI 编程助手。
144
2026.05.26
Codex 是一款超越传统代码生成的 AI 编程代理,致力于构建全生命周期的智能开发工作流。通过持久线程保留上下文,支持多智能体并行协作与后台自动化运维。借助沙箱权限控制、Plan/Steer 任务管理机制,Codex 既能自主拆解并执行复杂工程任务,又能让开发者牢牢掌控项目进程。从需求分析、编码测试到代码审查与部署,Codex 将 AI 深度融入研发全链路,极大提升了软件工程的交付效率与质量标准。
234
2026.05.26
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。
0
2026.11.17
SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。
0
2026.11.17
热门下载
相关下载
精品课程
共0课时 | 189人学习
共0课时 | 0人学习
最新文章