讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

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。
目录

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

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

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

128

2026.06.10

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

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

270

2026.05.27

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

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

117

2026.05.26

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

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

144

2026.05.26

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

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

234

2026.05.26

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

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

0

2026.11.17

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

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

0

2026.11.17

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

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

0

2026.11.17

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

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

0

2026.11.17

热门下载

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

精品课程

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

共0课时 | 189人学习

Codex官方文档
Codex官方文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn