KKClaw v3.7.1 — Hermes Readiness Patch

KKClaw v3.7.1 — Hermes Readiness Patch

Release date: 2026-04-14

A focused patch release for Hermes compatibility.

Fixed

• Hermes startup and desktop chat now fail fast when API_SERVER_ENABLED=true is missing, instead of entering a half-working state
• Hermes is no longer marked as installed when only ~/.hermes exists but the Hermes CLI is missing

Added

• Regression coverage for the “leftover config directory, missing Hermes CLI” false-positive case

KKClaw v3.7.0 — Hermes Compatibility & Dual Backend Launcher

KKClaw v3.7.0 — Hermes Compatibility & Dual Backend Launcher

Release date: 2026-04-11

_{Hermes Agent banner adapted from NousResearch/hermes-agent}

KKClaw is now officially compatible with Hermes.

This release turns KKClaw from an OpenClaw-only desktop companion into a more flexible desktop shell that can drive OpenClaw, Hermes, or automatically choose between them while keeping the same animated console, health checks, voice layer, and desktop presence.

Highlights

• Hermes compatibility mode via KKCLAW_COMPAT_MODE or pet-config.json.compatMode
• OpenClaw / Hermes / Auto launcher before entering the animated terminal
• External Hermes Gateway reuse instead of false port-conflict warnings
• Backend-aware status, doctor, gateway status, dashboard, and startup banners
• Clearer voice playback docs: TTS works only when the agent actively triggers desktop-bridge.js

Added

• Hermes-compatible backend resolver with openclaw, hermes, and auto modes
• Launcher flow that remembers the last backend choice
• Example config support for compatMode: "auto"
• Release docs and README visuals for Hermes compatibility

Improved

• Diagnostics now expose backend label, CLI path, probe source, log paths, API server readiness, and reuse hints
• Startup and ready banners now reflect the active backend theme
• Gateway host, dashboard target, token usage, and lifecycle operations now follow the active backend
• README now more clearly separates TTS issues from "agent never triggered bridge" issues

Fixed

• Hermes services already running outside KKClaw are no longer treated as ownership conflicts
• Console launch helpers now route through the same backend-aware entrypoint
• Regression coverage added for Hermes mode, launcher defaults, and reusable external services

v3.6.0 — Native KKClaw CLI gateway workflow

Highlights

• Added a native kkclaw CLI entrypoint for the desktop companion workflow
• kkclaw gateway now opens the same animated terminal experience as npm start
• Added kkclaw doctor, kkclaw gateway status, kkclaw gateway logs, kkclaw gateway open, kkclaw gateway restart, and kkclaw gateway stop
• Improved gateway observability with Dashboard URL output, log path output, and ownership diagnostics

Included in this release

• Gateway-oriented KKClaw CLI workflow
• Setup automation and terminal launcher improvements

Notes

• This release is intended to work with the installed OpenClaw CLI on your machine
• See CHANGELOG.md in the repository for full release history and upgrade context

v3.5.2 — 一键安装依赖 + Wizard 稳定性

⚡ v3.5.2 功能更新

🆕 一键安装缺失依赖

• ⚡ 一键安装按钮 — 环境检测页新增「一键安装缺失依赖」，自动安装 edge-tts / sqlite3 / node_modules
• 📊 实时进度反馈 — 每个依赖显示 ⏳等待 → 🔄安装中 → ✅成功/❌失败
• 🌐 跨平台支持 — Windows (winget/choco)、macOS (brew)、Linux (apt/yum)

🐛 Setup Wizard 稳定性修复

• 🔧 白屏修复 — 修复 updateSmartEnvSummary 和 onPersonalityPresetChange 函数声明缺失导致的 SyntaxError
• 🔧 HTML 修复 — 补全 Gateway 状态检测项的 env-gateway div 开标签
• 🔧 错误可视化 — init() try-catch 白屏时显示具体报错，渲染进程错误转发到主进程日志

📝 依赖说明优化

• 🔧 sqlite3 说明改进 — 从模糊的"数据缓存"改为明确的"CC-Switch Provider 同步"，未安装时显示 winget 安装命令

---

📖 完整更新日志 → CHANGELOG.md

🌐 GitHub Pages → kk43994.github.io/kkclaw — 全新动态演示窗口上线！

v3.5.1 — 双声音修复 + 桌面快捷方式优化

🐛 v3.5.1 修复更新

🔇 双声音问题修复

• 🔧 通知静音 — 所有 new Notification() 添加 silent: true，阻止 Windows 系统朗读通知内容导致的第二个机器人声音
• 🔧 移除调试日志 — 清理双声音排查时添加的 stack trace 调试代码

🖥️ 桌面快捷方式优化

• 🔧 快捷方式改进 — 指向 start.cmd，启动时显示 CMD 控制台 + Gateway 日志
• 🔧 WindowStyle 修正 — 从 7（隐藏）改为 1（正常显示），用户可以看到启动过程

---

📖 完整更新日志 → CHANGELOG.md

v3.5.0 — 彩色终端 + 智能守护 + 桌面快捷方式

🎨 v3.5.0 重大更新

全局彩色终端日志系统

• 🆕 color-log.js 中心化模块 — 统一 ANSI 颜色常量 + 自动关键词高亮
• ✨ 12+ 模块全覆盖 — main / service-manager / gateway-guardian / smart-voice / message-sync / pet-config / screenshot / log-rotation / performance-monitor / desktop-notifier
• 🎯 Gateway 日志高亮增强 — 模型名(cyan)、URL(green)、路径(dim)、渠道(magenta)、@botName(magenta)、key=value(yellow)、端口号(yellow)、协议(cyan)、错误(red)、成功(green)、警告(yellow)

🛡️ Gateway 智能自启动

• 🆕 首次启动主动拉起 — Guardian 连续 3 次检测不到 Gateway 后自动执行 startGateway()，不再永远等待
• 🆕 启动状态语音播报 — 启动中/成功/失败分别语音通知
• 🔧 二次确认防误判 — 与 ServiceManager 探活交叉校验

🔇 日志去重降噪

• 🔧 修复 Gateway 日志重复 — 根因：log() 方法二次打印；gateway-std* 服务跳过控制台输出
• 🔧 stderr 智能过滤 — 仅显示含 error/fatal/panic/exception 的真错误行

🖥️ 首次启动自动创建桌面快捷方式

• 🆕 自动创建 .lnk — 首次启动自动在桌面创建"Claw 桌面宠物"快捷方式
• 🎙️ 语音播报 — 创建成功后播报确认

🐛 修复

• 修复语音双响（移除 messageSync 重复 speak）
• 修复通知日志重复
• DashScope TTS 引擎移除，降级链简化为 MiniMax → Edge TTS

---

📖 完整更新日志 → CHANGELOG.md

v3.1.2 — Edge TTS 修复 & macOS 透明度修复

v3.1.2 修复更新

🐛 Bug Fixes

• Edge TTS 语音播报修复：修正 --text-file → --file 参数，修复语音播报全部失败的问题
• macOS 托盘图标修复：使用 22×22 Template PNG 替换原 128×121 RGB 图标，消除黑色方框
• macOS 球体透明度修复：添加 backgroundColor: '#00000000'，仅在 Windows 上禁用硬件加速
• 外部链接修复：open-external IPC 调用改为直接 shell.openExternal，修复链接无法打开
• Preload 白名单补全：添加 wizard-save-voice-id 通道，修复语音克隆 ID 保存失败

📦 下载

• Windows x64 安装包：KKClaw Desktop Pet-3.1.2-Setup.exe (93MB)

🦞 Generated with Claude Code

v3.1.1 - Security fixes & model management upgrades

What's New in v3.1.1

🔒 Security Fixes

• Fix command injection in audio playback (_playAudioFile, _playAudio) — replaced exec() shell string interpolation with execFile()/spawn() + argument arrays
• Fix command injection in Edge TTS — text now passed via temp file (--text-file) instead of inline --text
• Token security — dynamic config reading instead of module-level cache; added SecureStorage, LogSanitizer, IpcValidator modules

🛠️ Improvements

• Model management upgrades — hot-swap AI models with state machine, strategy pattern, and switch history
• Gateway monitoring — anomaly detection, health scoring, metrics collection, smart detector
• Session management — SessionLockManager for safe concurrent access
• Path resolution — openclaw-path-resolver eliminates hardcoded paths
• stop() now kills playback — properly terminates running audio process

📦 Build

• Windows x64 NSIS installer (unsigned)
• macOS builds not included in this release (cross-compile not available)

---

Full Changelog: v3.0.0...v3.1.1

v3.0.0 - Voice Configuration Fix

Warning

推荐使用方式：克隆仓库，而非下载发行版

发行版为打包封装版本，部分配置已硬编码在包内，自定义修改需解包，不适合新手；且小版本更新不会单独推发行版，克隆仓库后 \git pull\ 即可同步最新改动。

\\�ash
git clone https://github.com/kk43994/kkclaw.git
cd kkclaw
npm install
npm start
\\

发行版适合只想快速体验的用户，长期使用推荐源码运行。

---

Voice configuration improvements

v2.2.1 - 诊断工具箱 & CMD屏闪修复

🆕 v2.2.1 更新内容

新增

• 🔧 诊断工具箱 — 全新独立窗口，一键查看 Gateway 状态、日志、连接诊断
• 🔇 CMD 屏闪彻底修复 — 全部 exec/spawn 调用添加 windowsHide + shell:false

优化

• 🎤 smart-voice 所有 PowerShell 播放命令静默化
• 🔄 openclaw-updater 全流程（版本检查/安装/doctor）静默执行
• 📸 截图系统进程隐藏，不再弹出黑框
• 🔔 auto-notify 桌面通知静默化
• 🛡️ service-manager Gateway 进程管理改用 shell:false

下载

• Windows: KKClaw-Desktop-Pet-2.2.1-Setup.exe
• macOS Intel: KKClaw-Desktop-Pet-2.2.1-x64.dmg
• macOS Apple Silicon: KKClaw-Desktop-Pet-2.2.1-arm64.dmg

---

完整更新日志: https://github.com/kk43994/kkclaw/blob/master/README.md#-更新日志