Changelog

本项目所有重大变更都将记录在此文件中。

[1.0.3] - 2026-03-02

P0 配置管理写入错误的 JSON 路径导致 Gateway 崩溃且无法恢复 (#1)
- json_set models.openai.apiKey 在 openclaw.json 创建了非法的顶层 models 键
- OpenClaw 2026.3.1 严格校验配置 schema，拒绝启动并报 Unknown config keys: models.openai
- 修复: API Key 改写入 auth-profiles.json，模型注册到 agents.defaults.models
- 影响: 所有 11 个供应商的快速配置 (OpenAI/Anthropic/Gemini/OpenRouter/DeepSeek/GitHub Copilot/Qwen/xAI/Groq/SiliconFlow/自定义)
P0 恢复默认配置 → "清除模型配置" 未清理 auth-profiles.json 认证信息
P1 健康检查新增自动修复: 检测并移除旧版错误写入的顶层 models 无效键
P1 set_active_model 手动切换模型时未注册到 agents.defaults.models

openclaw-env factory-reset 非交互式恢复出厂设置命令
auth_set_apikey 函数: 正确写入 API Key 到 auth-profiles.json
register_and_set_model 函数: 注册模型到 agents.defaults.models 并设为默认
register_custom_provider 函数: 为需要 baseUrl 的 OpenAI 兼容供应商注册 models.providers

P0 ARM64 musl: Gateway 崩溃循环 — process.execPath 返回 musl 链接器路径导致 child_process.fork() 失败
- 使用 patchelf 直接修改 node ELF 二进制的 interpreter 和 rpath，替代 ld-musl wrapper 方案
- 子进程通过 process.execPath fork 时可正确找到 node 二进制
P0 ARM64 musl: Unicode property escapes 正则失败 (\p{Emoji_Presentation}) — 缺少 NODE_ICU_DATA 环境变量
- init.d、openclaw-env、oc-config.sh 所有入口均添加 NODE_ICU_DATA 环境变量

P0 web-pty.js loadAuthToken 读取错误的 UCI key luci_token → pty_token
P0 init.d get_oc_entry() 管道子 shell 导致返回值丢失，改用临时文件重定向
P1 Gateway procd respawn 无限重试 (3600 5 0) → 限制最多 5 次 (3600 5 5)
P1 Telegram 配对流程管道子 shell 变量丢失，改用临时文件避免子 shell
P1 openclaw.lua PID 提取 sed 正则不可靠，改用 awk + split
P2 init.d 和 uci-defaults 弱 token fallback (echo "auto_$(date +%s)") → dd if=/dev/urandom
P2 oc-config.sh 恢复出厂 timeout 命令可能不存在，添加 command -v 检查和降级方案
P2 web-pty.js SIGTERM 不清理 HTTPS server，统一 shutdown() 函数

Qwen 使用 models.dashscope 键名、SiliconFlow 使用 models.siliconflow，避免 models.custom 键冲突
get_openclaw_version() 从 package.json 读取版本号，不再每次启动 Node.js 进程
PTY 终端 WebSocket 重连策略改为无限重连 (MAX_RETRY=Infinity)
Makefile PKG_VERSION 从 VERSION 文件动态读取