kkclaw

给 OpenClaw 加一个真正可长期使用的桌面身体：流体玻璃球 UI、14 情绪系统、语音播报/声音克隆、Setup Wizard、Doctor 自检、模型热切换、Gateway 守护与诊断。

kkclaw 不是“单纯的桌面宠物”，而是一套给 OpenClaw 用的 桌面可视化交互层 + 运维辅助工具箱。

适合这些场景：

• 你想让 OpenClaw 不再只是终端/聊天框，而是有状态、有情绪、有语音反馈的桌面助手
• 你希望 Agent 收到消息、开始执行、报错、完成时，能更自然地被感知到
• 你经常切换模型 / Provider，希望配置和切换过程更顺手
• 你希望 Gateway 出问题时更容易诊断、恢复和长期挂着跑
• 你想基于现成桌面壳层继续做自己的桌面 Agent / 桌面 AI 助手

核心能力

• 流体玻璃球桌面 UI：轻量、常驻、可感知 Agent 状态
• 14 情绪系统：让思考、说话、完成、异常都有明显状态差异
• 语音系统：支持语音播报、停顿控制、声音克隆/多引擎降级
• Setup Wizard：新手也能更快完成首次配置
• Doctor 自检：检查 Gateway、模型、TTS、歌词窗、端口、日志等
• 模型与 Provider 管理：更方便地切换模型、管理多 Provider
• 长期运行增强：Gateway 守护、错误恢复、诊断提示

你装上后能得到什么

1. 桌面上一直有一个能感知状态的 Agent 不用一直盯终端、日志和聊天窗口。

2. 消息和任务不再只是冷冰冰的一行字 收到消息、开始执行、完成、异常时都有更自然的反馈。

3. 更适合长期挂着跑 出问题时更容易知道是哪一层挂了，也更容易恢复。

4. 更低的上手门槛 Setup Wizard、配置向导、诊断工具会比手改配置省心很多。

5. 更适合二次开发 如果你想给自己的 Agent 做“身体”或桌面 UI，这就是现成基础层。

快速开始

先看详细安装说明：references/setup.md

最常见的源码运行方式：

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

如果你需要图形化安装包，也可以直接看 Releases：

• GitHub: https://github.com/kk43994/kkclaw
• Releases: https://github.com/kk43994/kkclaw/releases
• Demo: https://kk43994.github.io/kkclaw/

什么时候推荐读参考文件

• 想快速安装和启动：读 references/setup.md
• 想知道 v3.1.2 更新了什么：读 references/v3-1-2.md
• 想先理解定位和价值：读 references/why-kkclaw.md

注意

• kkclaw 是 OpenClaw 的桌面增强层，不是 OpenClaw 本体
• 想获得完整体验，建议先保证 OpenClaw Gateway 可正常运行
• 对长期使用来说，源码运行通常比只下载发行版更灵活