feat: OpenClaw 4.9 全面适配 (v0.12.0)

- 推荐内核统一升级至 2026.4.9 / 2026.4.9-zh.2 - standalone 安装兼容 edition 格式 latest.json + openclaw-zh- 文件名前缀 - standalone 三级降级: R2 CDN → GitHub Releases → npm - pre_install_cleanup 所有命令加 10s 超时保护（修复安装卡死） - npm uninstall 加 30s 超时保护 - wmic 全部迁移到 PowerShell（兼容 Windows 11） - standalone 下载增加文字进度显示
2026-05-07 06:12:58 +08:00 · 2026-04-11 04:42:36 +08:00
parent 70d768be17
commit 271dc93b08
18 changed files with 706 additions and 145 deletions
--- a/docs/index.html
+++ b/docs/index.html
@@ -34,7 +34,7 @@
    "description": "OpenClaw AI Agent 可视化管理面板，基于 Tauri v2 的跨平台桌面应用。内置晴辰助手支持工具调用，晴辰云 AI 接口一键接入。支持仪表盘监控、多模型配置、消息渠道管理、内置 QQ 机器人、实时 AI 聊天、记忆管理、Agent 管理、网关配置、内网穿透等功能。支持 11 种语言。",
    "url": "https://claw.qt.cool/",
    "downloadUrl": "https://github.com/qingchencloud/clawpanel/releases/latest",
-    "softwareVersion": "0.11.6",
+    "softwareVersion": "0.12.0",
    "author": {
      "@type": "Organization",
      "name": "晴辰云 QingchenCloud",
@@ -1155,7 +1155,7 @@
    <div class="orb orb-2" style="top:auto;bottom:-100px"></div>
    <div class="container-sm" style="position:relative;z-index:10">
      <div class="section-header">
-        <div class="reveal download-version"><span class="pulse"></span> <span id="dl-badge" data-i18n="dl.badge">v0.11.6 最新版</span></div>
+        <div class="reveal download-version"><span class="pulse"></span> <span id="dl-badge" data-i18n="dl.badge">v0.12.0 最新版</span></div>
        <h2 class="reveal section-title" data-i18n="dl.title"><span class="gradient-text">下载安装</span></h2>
        <p class="reveal section-desc" data-i18n="dl.desc">选择你的操作系统，一键下载安装</p>
      </div>
@@ -1165,11 +1165,11 @@
          <h3>macOS</h3>
          <p class="dl-desc" data-i18n="dl.mac.d">支持 Apple Silicon 和 Intel 芯片</p>
          <div class="dl-links">
-            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.11.6_aarch64.dmg" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.12.0_aarch64.dmg" target="_blank" rel="noopener">
              Apple Silicon (M1/M2/M3/M4)
              <span class="dl-format">.dmg</span>
            </a>
-            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.11.6_x64.dmg" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.12.0_x64.dmg" target="_blank" rel="noopener">
              <span data-i18n="dl.mac.intel">Intel 芯片</span>
              <span class="dl-format">.dmg</span>
            </a>
@@ -1187,15 +1187,15 @@
          <h3>Windows</h3>
          <p class="dl-desc" data-i18n="dl.win.d">支持 Windows 10 及以上版本</p>
          <div class="dl-links">
-            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.11.6_x64-setup.exe" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.12.0_x64-setup.exe" target="_blank" rel="noopener">
              <span data-i18n="dl.win.exe">安装程序</span>
              <span class="dl-format">.exe</span>
            </a>
-            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.11.6_x64-setup-full.exe" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.12.0_x64-setup-full.exe" target="_blank" rel="noopener">
              <span data-i18n="dl.win.full">完整包（含 WebView2）</span>
              <span class="dl-format">.exe</span>
            </a>
-            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.11.6_x64_en-US.msi" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.12.0_x64_en-US.msi" target="_blank" rel="noopener">
              <span data-i18n="dl.win.msi">MSI 安装包</span>
              <span class="dl-format">.msi</span>
            </a>
@@ -1206,11 +1206,11 @@
          <h3>Linux</h3>
          <p class="dl-desc" data-i18n="dl.linux.d">支持主流 Linux 发行版</p>
          <div class="dl-links">
-            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.11.6_amd64.AppImage" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.12.0_amd64.AppImage" target="_blank" rel="noopener">
              <span data-i18n="dl.linux.ai">通用版</span>
              <span class="dl-format">.AppImage</span>
            </a>
-            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.11.6_amd64.deb" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.12.0_amd64.deb" target="_blank" rel="noopener">
              Debian / Ubuntu
              <span class="dl-format">.deb</span>
            </a>
--- a/docs/v2026.4.9-adaptation-plan.md
+++ b/docs/v2026.4.9-adaptation-plan.md
@@ -0,0 +1,114 @@
+# OpenClaw v2026.4.9 适配计划
+
+> ClawPanel 当前绑定 `2026.3.28`，上游已达 `v2026.4.9`（5991 commits）
+> 本文档列出所有需要适配的功能点，按优先级排列
+
+---
+
+## ✅ 已完成
+
+### 1. version-policy 绑定更新
+- `openclaw-version-policy.json` 已更新
+- 0.9.x → 3.13, 0.10.x-0.11.2 → 3.28, 0.11.3+ → 4.9
+- default fallback 也更新到 4.9
+- **向下兼容**：旧面板版本仍绑定旧内核
+
+### 2. 梦境页（dreaming.js）
+- 已有完整 Dream Diary UI：日记查看器、分段解析、原始 Markdown
+- 已调用 4.9 新 RPC：`doctor.memory.dreamDiary`, `backfillDreamDiary`, `resetDreamDiary`, `resetGroundedShortTerm`
+- 已有三阶段状态：light / deep / rem
+- 已有向下兼容：`isUnsupportedError()` 检测，旧版本优雅降级
+
+---
+
+## ✅ P0 — 已完成
+
+### 3. Skills 页增强：接入 Gateway `skills.search` + `skills.detail`
+
+- `ws-client.js` 新增 `skillsSearch()` / `skillsDetail()` 方法
+- `skills.js` 商店搜索优先走 Gateway RPC，回退 Tauri
+- `skills.js` 详情查看优先走 Gateway RPC，回退 Tauri
+- Web 模式下也可搜索/查看技能详情
+
+---
+
+## ✅ P1 — 已完成
+
+### 4. Sessions Compaction UI（会话压缩历史/恢复）
+
+- `ws-client.js` 新增 4 个方法：`sessionsCompactionList/Get/Branch/Restore`
+- `chat.js` 会话卡片显示压缩检查点计数徽章（⇳N）
+- 点击弹出检查点列表弹窗（时间、token 变化）
+- 每个检查点提供“分支”和“恢复”操作，恢复需 confirm
+- 旧版本优雅降级：显示“不支持”提示
+- i18n 已增加 9 个新 key
+
+### 5. exec/plugin Approval 管理增强
+
+- `ws-client.js` 新增 3 个方法：`execApprovalList/Get`, `pluginApprovalList`
+- `communication.js` 审批 Tab 新增“待处理审批队列”面板
+- 主动拉取 exec + plugin 审批列表（并行请求）
+- Gateway 未连接 / RPC 不支持时优雅降级
+- i18n 已增加 6 个新 key
+
+---
+
+## ✅ P2 — 已完成
+
+经审查，以下变更均不涉及 ClawPanel 现有 UI：
+
+| 项 | 原因 |
+|------|------|
+| TTS `talk` 字段迁移 | ClawPanel 无 TTS 配置编辑器 |
+| MCP `headers` 新字段 | ClawPanel 无 MCP 服务器配置编辑器（仅 dashboard 显示计数） |
+| Provider fallback 新参数 | 内核侧有默认值，面板无需暴露 |
+| ACP bindings 校验放宽 | ClawPanel route-map 仅读取显示，无硬编码渠道限制 |
+| `operator.talk_secrets` 新权限 | 方法列表为空，暂无实际影响 |
+
+---
+
+## 📡 渠道模块审查（channels.js — 无需适配）
+
+**审查范围**：全量 2198 行 `channels.js` + 上游 180 文件 channels diff
+
+| 审查项 | 4.9 变更 | 面板影响 |
+|--------|----------|----------|
+| Gateway RPC `channels.ts` | `normalizeOptionalString` 内部重构 | 无 — API 无变化 |
+| Config schema `zod-schema.agents.ts` | ACP binding 校验放宽 | 无 — 面板不做校验 |
+| 渠道插件基础设施 | module-loader/registry/contracts 重构 | 无 — 内核内部 |
+| Setup wizard `setup-helpers.ts` | 账号提升逻辑重构 | 无 — 内部迁移 |
+| 新渠道类型 | 未新增 | 无 |
+| LINE/Matrix/Slack/Teams/Telegram | 内部增强（draft streaming/outbound media/status reactions/thread isolation/polling watchdog） | 无 — 内核自动生效 |
+
+**结论**：`channels.js` 的 18 个 `api.*` 调用均为面板自有后端 API，未受上游影响。`wsClient.request('web.login.start/wait')` WhatsApp QR 登录亦无变化。完全兼容 4.9。
+
+## 🔒 安全修复（内核侧，面板无需适配）
+
+- exec 审批绕过修复
+- SSRF 硬化（浏览器重定向）
+- auth 令牌轮换后旧 WebSocket 失效
+- 媒体 base64 大小限制
+- 运行时事件信任标记
+- 宿主 exec/env 环境变量消毒
+
+---
+
+## 执行状态
+
+```
+Phase 1: ✅ version-policy 绑定 4.9
+Phase 2: ✅ dreaming 页已有完整 4.9 支持
+Phase 3: ✅ Skills Gateway RPC 接入
+Phase 4: ✅ Sessions Compaction UI
+Phase 5: ✅ Approval 管理增强
+Phase 6: ✅ P2 审查完毕，均无需适配
+Phase 7: ✅ channels.js 全量审查（2198 行 + 上游 180 文件 diff），完全兼容 4.9
+
+全部适配工作已完成。Build 通过。
+```
+
+## 注意事项
+
+1. **所有新功能必须向下兼容**：用户可能运行 3.13/3.28 内核，新 RPC 调用必须 catch `isUnsupportedError` 并优雅降级
+2. **Web 模式适配**：新 RPC 通过 WebSocket 调用，Web 模式（dev-api.js）如需支持需增加转发
+3. **i18n**：所有新 UI 文本需同步 zh-CN 和 en 两套翻译