kkclaw
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，这就是现成基础层。
快速开始
先看详细安装说明： INLINECODE0
最常见的源码运行方式：
CODEBLOCK0
如果你需要图形化安装包，也可以直接看 Releases：
- - GitHub: https://github.com/kk43994/kkclaw
- Releases: https://github.com/kk43994/kkclaw/releases
- Demo: https://kk43994.github.io/kkclaw/
什么时候推荐读参考文件
- - 想快速安装和启动：读 INLINECODE1
- 想知道 v3.1.2 更新了什么：读 INLINECODE2
- 想先理解定位和价值：读 INLINECODE3
注意
- - kkclaw 是 OpenClaw 的桌面增强层，不是 OpenClaw 本体
- 想获得完整体验，建议先保证 OpenClaw Gateway 可正常运行
- 对长期使用来说，源码运行通常比只下载发行版更灵活
kkclaw
kkclaw 并非单纯的桌面宠物，而是一套专为 OpenClaw 打造的 桌面可视化交互层 + 运维辅助工具箱。
适用于以下场景：
- - 你希望 OpenClaw 不再局限于终端或聊天框，而是成为具备状态、情绪和语音反馈的桌面助手
- 你希望 Agent 在收到消息、开始执行、报错或完成任务时，能够被更自然地感知到
- 你经常切换模型或 Provider，希望配置和切换流程更加便捷
- 你希望 Gateway 出现问题时，能够更轻松地诊断、恢复并长期稳定运行
- 你希望基于现有的桌面壳层，继续开发自己的桌面 Agent 或桌面 AI 助手
核心能力
- - 流体玻璃球桌面 UI：轻量、常驻，能够感知 Agent 状态
- 14 种情绪系统：让思考、说话、完成任务和异常情况都有明显的状态差异
- 语音系统：支持语音播报、停顿控制、声音克隆及多引擎降级
- Setup Wizard（设置向导）：新手也能更快完成首次配置
- Doctor 自检：检查 Gateway、模型、TTS、歌词窗口、端口、日志等
- 模型与 Provider 管理：更方便地切换模型，管理多个 Provider
- 长期运行增强：Gateway 守护、错误恢复、诊断提示
安装后你将获得
- 1. 桌面上始终有一个能感知状态的 Agent
无需一直盯着终端、日志和聊天窗口。
- 2. 消息和任务不再只是冷冰冰的一行文字
收到消息、开始执行、完成任务或出现异常时，都会有更自然的反馈。
- 3. 更适合长期稳定运行
出现问题时，更容易判断是哪一层出了问题，也更容易恢复。
- 4. 更低的上手门槛
设置向导、配置向导和诊断工具比手动修改配置省心得多。
- 5. 更适合二次开发
如果你想为自己的 Agent 打造身体或桌面 UI，这就是现成的基础层。
快速开始
先查看详细安装说明：references/setup.md
最常见的源码运行方式：
bash
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 能够正常运行
- 对于长期使用而言，源码运行通常比仅下载发行版更加灵活
