🎨 14 Emotional States 🎨 14种情绪状态

Click any mood icon to see the ball change color. 点击情绪图标，即可实时查看球体的变化。

Idle

待机

Happy

开心

Talking

说话

Thinking

思考

Sleepy

困倦

Surprised

惊讶

Offline

离线

Sad

伤心

Angry

生气

Fearful

恐惧

Calm

平静

Excited

兴奋

Love

喜欢

Focused

专注

openclaw-kkclaw

Desktop visualization companion for OpenClaw - Fluid glass orb pet, 14-emotion system, voice cloning, Gateway Guardian, and real-time WebSocket sync.

OpenClaw 桌面可视化伴侣 — 流体玻璃球宠物、14情绪系统、声音克隆、Gateway 智能守护、实时 WebSocket 同步。

v3.5.2 7×24 Stable Windows + macOS Electron 28

Download for Windows / macOS下载 Windows / macOS 版 GitHub ClawHub

Fluid Glass Ball + Toolbar

流体玻璃球 + 工具栏

Desktop Lyrics (Click-through)

桌面歌词 (鼠标穿透)

KKClaw Model Switch

KKClaw 模型切换

WHAT'S NEW新版亮点

v3.5.2 — Gateway Guardian + Colorized Logs + One-Click Install

v3.5.2 — Gateway 智能守护 + 彩色日志 + 一键安装

Smart auto-start, 12+ colorized modules, Setup Wizard polish, and security hardening.

Gateway 智能自启、12+ 模块彩色日志、配置向导优化、安全加固。

Gateway Guardian

Gateway 智能守护

Auto-starts Gateway after 3 consecutive detection failures. Health scoring, voice status announcements, crash auto-recovery with rate limiting (max 10/hour).

连续3次检测失败后自动拉起 Gateway。健康评分、语音状态播报、崩溃自动恢复（每小时上限10次）。

Colorized Terminal Logs

彩色终端日志

12+ modules with ANSI colorized output. Models in cyan, URLs in green, errors in red, channels in magenta. Auto-dedup + log rotation.

12+ 模块统一彩色输出。模型名青色、URL绿色、错误红色、渠道洋红。自动去重 + 日志轮转。

One-Click Dependency Install

一键安装缺失依赖

Setup Wizard detects missing deps and installs with one button. Real-time progress for edge-tts, sqlite3, node_modules. Cross-platform: Windows/macOS/Linux.

向导检测缺失依赖后一键安装。edge-tts / sqlite3 / node_modules 实时进度。跨平台：Windows/macOS/Linux。

38 Micro-Expressions

38种待机微表情

Three-dimensional trigger system: mood × time-of-day × conversation tone. Morning energetic, afternoon sleepy, late-night yawning — all automatic.

三维触发系统：心情×时间段×对话语气。早晨活力、午后犯困、深夜哈欠——全自动切换。

Security Hardening

安全加固

Command injection prevention (execFile/spawn with args array), auto log sanitization, IPC whitelist sandbox for all windows.

命令注入防护（execFile/spawn 参数数组）、日志自动脱敏、全窗口 IPC 白名单沙箱。

Wizard Stability

向导稳定性

Fixed 3 syntax errors causing blank pages. Error visualization shows actual error instead of white screen. Dual audio fix with silent notifications.

修复3处语法错误导致的白屏。出错时直接显示报错信息而非空白。通知静默化修复双声音问题。

INTERACTIVE DEMO交互式演示

Try the KKClaw 新手引导

体验 KKClaw 新手引导

Click through all 8 steps — Smart Env Check, Gateway, Model, Channels, TTS, Voice, Display, and Full Test.

点击体验全部 8 个步骤 — 智能环境检测、Gateway、模型、渠道、TTS、语音、显示、全链路测试。

⚡ One-Click Install 一键安装依赖

Auto-detects missing deps (edge-tts, sqlite3, node_modules) and installs with real-time progress.

自动检测缺失依赖并一键安装，每个依赖实时显示安装进度。

NEW in v3.5.2

🐛 No More White Screens 出错不白屏

Error visualization shows actual error message instead of blank page. Renderer errors forwarded to main process.

出错时显示具体报错信息，渲染进程错误自动转发到主进程日志。

FIXED in v3.5.2

🔍 Smart Env Detection 智能环境检测

10-item auto-diagnostics: Gateway, TTS, model, port, health, cache, lyrics, logs, and more.

10项全自动诊断：Gateway、TTS、模型、端口、健康度、缓存、歌词、日志等。

🎭 RPG-Style Wizard RPG 风格向导

7-step guided setup with game aesthetic: Gateway → Model → Channels → TTS → Voice → Display → Test.

7步引导流程，游戏化视觉：Gateway → 模型 → 渠道 → TTS → 语音 → 显示 → 测试。

This is a live interactive demo. The actual wizard runs inside the Electron app. 这是可交互的在线演示。实际向导在 Electron 应用内运行。

FEATURES核心特性

Everything an AI Companion Needs

AI 桌面伴侣的一切所需

Built from scratch with pure code animations, zero sprite sheets.

从零构建，纯代码动画，零精灵图。

Air-Feel UI

空气感 UI

67px fluid glass ball with 14 mood-based color themes. No clunky windows — just a floating orb on your desktop.

67px 流体玻璃球，14 种情绪色系。没有笨重窗口，只有一个漂浮的光球。

38 Micro-Expressions

38 种微表情

Capsule eyes blink, look around, and react. Idle micro-animations trigger by mood, time, and tone — your pet is always alive.

胶囊眼睛会眨眼、环顾、做出反应。待机微表情由心情×时间×语气三维触发 — 宠物始终鲜活。

Emotional TTS

情感语音

MiniMax Speech 2.5 Turbo with voice cloning + 14 emotion modes. 2-tier fallback: MiniMax → Edge TTS — never silent.

MiniMax Speech 2.5 Turbo 声音克隆 + 14 种情绪。双级降级：MiniMax → Edge TTS，语音永不中断。

Desktop Lyrics

桌面歌词

Agent responses float like desktop lyrics — typewriter effect, auto-fade, fully click-through. Never blocks your work.

AI 回复像桌面歌词一样浮现 — 打字机效果、自动淡出、完全鼠标穿透。

Dual Window Architecture

双窗口架构

Sprite window (200×220, draggable) + Lyrics window (400×100, click-through). Both transparent, always-on-top.

精灵窗口 (200×220, 可拖动) + 歌词窗口 (400×100, 鼠标穿透)。双透明、双置顶。

Pure Code Animation

纯代码动画

All animations procedurally generated with CSS + JS. Zero sprite sheets, zero image assets. Everything is code.

所有动画均由 CSS + JS 程序化生成。零精灵图、零图片资源。一切都是代码。

KKCLAW SWITCH模型热切换

Switch AI Models in 3 Seconds

3秒切换AI模型，零重启

No more manual config editing. No more restart waiting.

告别手动编辑配置，告别重启等待。

Switch Provider

切换Provider

Claude ↔ GPT ↔ Gemini

在KKClaw Switch中点击切换

→

Auto Detect

自动监听

Monitor DB every 2s

每2秒检测DB变化

→

Sync & Restart

同步并重启

Switch takes effect!

切换即生效 ⚡

❌ Traditional Way 传统方式

✗ Manually edit openclaw.json
✗ 手动编辑 openclaw.json
✗ Find correct provider key
✗ 找到正确的 provider key
✗ Restart Gateway manually
✗ 手动重启 Gateway
✗ Wait ~30 seconds
✗ 等待约30秒

RECOMMENDED

✅ KKClaw Switch

✓ Click to switch
✓ 点击切换
✓ Auto sync config
✓ 自动同步配置
✓ Auto restart Gateway
✓ 自动重启 Gateway
✓ ~3 seconds ⚡
✓ 约3秒 ⚡

Interactive Provider Panel 交互式 Provider 面板

Click any provider card to switch — just like in the real app 点击任意 Provider 卡片即可切换——与应用内体验一致

KKClaw Switch

中/EN

服务商

模型

日志

Manual Sync (Optional) 手动同步（可选）

# Sync current provider to OpenClaw
node kkclaw-hotswitch.js

# Sync and auto-restart Gateway
node kkclaw-hotswitch.js --restart

GET STARTED快速开始

Install in 60 Seconds

60 秒完成安装

Option A: Download Installer

方式 A：下载安装包

Pre-built binaries for Windows and macOS

Windows 和 macOS 预编译安装包

Windows (x64)Windows (x64) macOS (Intel)macOS (Intel) macOS (Apple Silicon)macOS (Apple Silicon)

Option B: ClawHub

方式 B：ClawHub

One command install via ClawHub registry

通过 ClawHub 一键安装

                        Click to copy
                        npx clawhub@latest install kk43994/desktop-pet
                    

Option C: GitHub

方式 C：GitHub

Clone, install, and run

克隆、安装、运行

                        Click to copy
                        # Clone and run

                        git clone https://github.com/kk43994/kkclaw.git

                        cd kkclaw

                        npm install

                        npm start

Node.js

>= 18.x

Electron

28.x

Windows

10 / 11

macOS

10.15+

OpenClaw

>= 2026.x

COMMUNITY社区

Join the Community

加入社区

Connect with other builders and get support

与其他开发者交流，获取技术支持

AI Coding Group

AI Coding 交流群

WeChat group for AI coding discussion

微信 AI Coding 技术交流群

Scan to join 扫码入群

Discord

Discord 社区

Chat with the developer directly

和开发者直接交流

Join Discord加入 Discord

reribth_75722 reribth_75722

Support the Project

赞赏支持

Help keep this project going

用于开发维护 / 服务器费用

Your support means a lot 每一份支持都是动力

openclaw-kkclaw

14

38

2

7×24

Boot Up in Style

酷炫的启动画面

v3.5.2 — Gateway Guardian + Colorized Logs + One-Click Install

v3.5.2 — Gateway 智能守护 + 彩色日志 + 一键安装

Gateway Guardian

Gateway 智能守护

Colorized Terminal Logs

彩色终端日志

One-Click Dependency Install

一键安装缺失依赖

38 Micro-Expressions

38种待机微表情

Security Hardening

安全加固

Wizard Stability

向导稳定性

Gateway Guardian in Action

Gateway 智能守护演示

12+ Modules, One Color System

12+ 模块，统一彩色输出

Find Your Fastest Model

找到你最快的模型

Try the KKClaw 新手引导

体验 KKClaw 新手引导

Everything an AI Companion Needs

AI 桌面伴侣的一切所需

Air-Feel UI

空气感 UI

38 Micro-Expressions

38 种微表情

Emotional TTS

情感语音

Desktop Lyrics

桌面歌词

Dual Window Architecture

双窗口架构

Pure Code Animation

纯代码动画

Switch AI Models in 3 Seconds

3秒切换AI模型，零重启

Switch Provider

切换Provider

Auto Detect

自动监听

Sync & Restart

同步并重启

❌ Traditional Way 传统方式

✅ KKClaw Switch

Interactive Provider Panel 交互式 Provider 面板

Manual Sync (Optional) 手动同步（可选）

System Architecture

系统架构

Hear the Emotional TTS

听听情感语音效果

Happy

开心

Calm

平静

Surprised

惊喜

14 Emotional States

14 种情绪状态

Install in 60 Seconds

60 秒完成安装

Option A: Download Installer

方式 A：下载安装包

Option B: ClawHub

方式 B：ClawHub

Option C: GitHub

方式 C：GitHub

Join the Community

加入社区

AI Coding Group

AI Coding 交流群

Discord