WebP或HEIC转JPG需用兼容工具：金舟HEIC转换器选JPG（非JPEG）、XnConvert设输出至/assets/img、iMazing处理HEIC元数据、CloudConvert剥离ICC配置、命令行webp -q 85转换。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要把WebP或HEIC图片放进Codex项目里，但系统报错“不支持的图像格式”——这不是图片坏了，而是Codex默认只认JPG、PNG这类传统格式，WebP和HEIC必须先转成兼容格式才能正常加载、解析或嵌入代码注释中。
本地软件批量转换WebP→JPG
方法一：用金舟HEIC图片转换器（实测v3.6.5）
Step1、启动软件→点击【添加文件】→选中全部WebP图片（支持拖拽）；
Step2、在底部格式栏点击下拉箭头→【务必选中JPG而非JPEG】（二者参数不同，JPEG选项会强制启用CMYK色彩空间，Codex解析时可能丢色）；
Step3、点击右下角【开始转换】→等待进度条走完→点击【前往导出文件夹】直接取文件。
方法二：用XnConvert（免费开源，Windows/macOS/Linux全平台）
① 打开软件→切换到【输入】选项卡→点击【添加文件】导入WebP；
② 切换到【输出】选项卡→在【格式】下拉菜单中选择JPEG→勾选【保持原始比例】；
③ 点击【转换】→弹出保存窗口时，【输出目录必须设为Codex项目根目录下的/assets/img子文件夹】，否则后续路径引用会失效。
HEIC转JPG：绕过苹果生态限制
iMazing HEIC Converter是目前唯一能正确处理iOS 17+生成的HEIC深度元数据的工具。其他软件常把Live Photo的视频轨误判为损坏而丢弃。
第一步：运行iMazing HEIC Converter→点击【Add Files】→选中HEIC文件；
第二步：在Output Format中选JPG→关键操作：点击【Options】→将Quality滑块拖到92（低于90会触发有损重压缩，高于95则文件体积暴涨，Codex构建时卡顿）；
第三步：点击【Convert】→转换完成后，软件自动在输出目录生成同名.jpg文件，原HEIC文件保留不动。
配置 OpenClaw 多提供商认证与 OpenAI Codex OAuth 备用方案，实现自动模型切换，适用于多 OpenAI Codex 账户设置。
注意：不要用修改后缀名法（把.heic改成.jpg）——HEIC是容器格式，内部含AV1编码图像帧+EXIF+XMP多层数据，强行改后缀会导致Codex读取时崩溃并清空缓存。
在线工具应急转换（限非敏感图）
CloudConvert适合临时处理单张截图类WebP，它能在转换时自动剥离WebP的ICC配置文件（Codex不识别该配置，会报错）。
① 打开cloudconvert.com→点击【Select File】上传WebP；
② 在“Convert to”中选JPEG→展开Advanced Settings→关闭【Preserve color profile】；
③ 点击【Convert】→下载ZIP包→解压后取其中.jpg文件；
这一步不能跳过，否则Codex加载时会出现偏色或白屏。
Convertio对HEIC支持不稳定，上传后常返回“Unsupported file type”，建议直接放弃。
命令行极速转换（开发者首选）
安装libwebp工具集后，一行命令搞定：
webp -quiet -q 85 input.webp -o output.jpg
参数-q 85是经过实测的平衡点：低于80，Codex渲染文字边缘出现锯齿；高于90，生成文件比原WebP还大，违背压缩初衷。
HEIC暂无稳定跨平台CLI工具，macOS可用sips命令：sips -s format jpeg IMG_1234.HEIC --out out.jpg，但无法批量处理带Live Photo的文件。
