QClaw 问题反馈（两则）

环境信息

问题一：升级安装后程序消失（严重）

标题

QClaw 升级安装后，整个程序消失，快捷方式失效，找不到 QClaw

严重程度

🔴 严重（阻断性问题，用户无法使用）

问题描述

每次升级 QClaw 后，会出现以下情况：

• 桌面快捷方式和开始菜单快捷方式点击后提示"原文件已不存在"
• 整个 C:\Program Files\QClaw\ 目录被清空或删除
• 用户完全找不到 QClaw 程序

根因分析

从安装日志 (install.log) 可见升级流程：

[T0 -> T1] Init + Uninstall old + Extract 7z to temp:  71391 ms
[T1 -> T2] Decompress + Copy + Registry + Shortcuts:   1125 ms
[T2 -> T3] OpenClaw tar extraction:                    31062 ms

关键发现： 安装器采用"先装后删"策略，但这导致了更严重的问题：

1. 新版本解压到临时目录
2. 运行"卸载旧版本"逻辑
3. 卸载逻辑使用通配符或固定路径清理 C:\Program Files\QClaw\
4. 不区分版本，把刚装好的新版本也一起删了
5. 结果：旧的没了，新的也被删了 → QClaw 彻底消失

用户观察到的现象

"不只是快捷方式消失了，直接就找不到 qclaw 了"

这与传统的"先删后装"问题不同——"先装后删"本应是更安全的做法，但卸载逻辑不够精确，把新版本也清理了。

注册表问题

InstallLocation : （空）

安装器没有正确写入 InstallLocation，Windows 的"应用和功能"无法正确追踪安装位置。

建议修复方案

1. 隔离卸载目标： 卸载逻辑应精确匹配旧版本路径（如 C:\Program Files\QClaw\0.2.12\），而非清理整个父目录
2. 版本化安装路径： 每个版本安装到独立子目录，卸载旧版本时只清理对应子目录
3. 原子化替换： 先完成新版本安装并验证，再执行旧版本清理
4. 正确注册安装路径： 写入 InstallLocation 注册表项

问题二：Control UI Agent 自定义名称不显示

标题

Control UI 左侧 Agent 列表不读取 agents.list[].name 配置，始终显示硬编码的 "QClaw"

严重程度

🟡 中等（不影响功能，影响用户体验和品牌定制）

复现步骤

1. 编辑 ~/.qclaw/openclaw.json，在 agents.list 中设置自定义名称：

   {
     "agents": {
       "list": [
         {
           "id": "main",
           "name": "小五"
         }
       ]
     }
   }

2. 同时在工作区 workspace/IDENTITY.md 中配置：

   - Name: 小五
   - Emoji: 🤖
   - Vibe: 随时随地，帮您高效干活

3. 保存配置，重启 Gateway
4. 刷新 Control UI 页面（F5）

预期结果

左侧 Agent 列表应显示 "小五"

实际结果

左侧 Agent 列表仍显示 "QClaw"

但以下内容已正确生效：

• ✅ Agent 副标题正确显示 IDENTITY.md 中的 Vibe
• ✅ 运行时配置确认 name: "小五" 已生效
• ✅ config.schema.lookup 确认 agents.list.*.name 是合法字段
• ✅ 对话记录、消息收发等核心功能完全正常

推测根因

Control UI（Electron 前端）渲染 Agent 列表时：

• 未从 agents.list[].name 读取用户配置的名称
• 可能使用了硬编码默认值 "QClaw"

期望修复方案

1. Control UI 读取 openclaw.json → agents.list[].name 作为 Agent 显示名
2. 若 name 未配置，fallback 到 IDENTITY.md → Name: 字段
3. 若两者都未配置，才使用默认值 "QClaw"

补充说明

问题一为阻断性问题，建议优先修复。

如有需要进一步排查，可随时联系。