codex技能包更新失败需手动修复：先用codexctl list --installed检查状态，再根据“no skills installed”“-dirty”或[broken]等提示选择强制重装、离线安装或禁用证书验证方式；回退则需通过codexctl list --available选非-dirty版本执行安装并验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex技能包更新失败时，界面卡在“正在下载”或提示“校验失败”，说明自动更新机制已中断，必须通过命令行手动干预才能恢复功能。
确认当前技能包状态
打开终端（Windows用PowerShell，macOS/Linux用bash），执行：
codexctl list --installed
查看输出中是否有带[broken]或[missing]标记的技能项。若显示“no skills installed”，说明技能目录已被清空，需从头安装；若显示版本号但后缀为-dirty，代表本地修改未提交，不可回退。
【注意】不要直接删除~/.codex/skills目录——这会丢失所有自定义配置和本地修改记录。
手动安装最新技能包
方法一：使用codexctl自动拉取（推荐）
执行 codexctl install --force latest
该命令会强制清除缓存、重连官方源、跳过本地校验，适合网络正常但更新卡住的场景。
方法二：离线安装指定包
1. 访问 https://codexdown.cn/skills/ 获取最新技能包ZIP文件（如 codex-skills-v2.8.3.zip）
2. 解压到临时文件夹，确保内部结构为 skills/xxx/manifest.json 形式
3. 执行 codexctl install --path ./skills
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
方法三：绕过HTTPS证书验证（企业内网/代理环境专用）
codexctl install --insecure --force latest
【警告】仅限可信局域网使用，禁用证书验证会暴露API密钥传输过程。
回退到上一个稳定版本
第一步：列出可回退版本
codexctl list --available
第二步：识别目标版本
在返回列表中找到倒数第二个非-dirty版本，例如 v2.7.9（不是 v2.7.9-dirty 或 v2.8.0-beta）
第三步：执行回退
codexctl install v2.7.9
第四步：验证回退结果
codexctl status | grep "skills version"
若输出显示 skills version: v2.7.9 且无报错，说明回退成功。此时可重新启用自动更新：
codexctl config set auto_update true
