← Back to Skills Marketplace
kk43994

kkclaw

by kk43994 · GitHub ↗ · v3.1.2 · MIT-0
cross-platform ✓ Security Clean
287
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install kkclaw
Description
给 OpenClaw 加一个真正可长期使用的桌面身体:流体玻璃球 UI、14 情绪系统、语音播报/声音克隆、Setup Wizard、Doctor 自检、模型热切换、Gateway 守护与诊断。
README (SKILL.md)

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,这就是现成基础层。

快速开始

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

最常见的源码运行方式:

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

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

什么时候推荐读参考文件

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

注意

  • kkclaw 是 OpenClaw 的桌面增强层,不是 OpenClaw 本体
  • 想获得完整体验,建议先保证 OpenClaw Gateway 可正常运行
  • 对长期使用来说,源码运行通常比只下载发行版更灵活
Usage Guidance
This skill is an instruction-only integration that points to a GitHub project and recommends running npm or installing released binaries. That is coherent with its purpose, but before running: (1) review the GitHub repository code and its npm package.json / dependency tree for suspicious or high‑risk packages; (2) prefer building from source if you want to avoid opaque release installers; (3) be cautious with any TTS/voice‑cloning features — they may require provider API keys you should store securely and only grant to trusted services; (4) check what native permissions the released installers request on your OS (startup/auto‑run, microphone, network access); and (5) keep backups of OpenClaw/Gateway configs before letting a third‑party tool alter them. If you want a deeper assessment, provide the GitHub repository contents or release binaries for review.
Capability Analysis
Type: OpenClaw Skill Name: kkclaw Version: 3.1.2 The kkclaw skill bundle is a desktop UI and maintenance toolkit for OpenClaw, providing a visual interface, emotion systems, and diagnostic utilities. The documentation (SKILL.md, setup.md) describes legitimate features such as a 'Doctor' self-check for troubleshooting and 'Gateway' daemon management for long-term stability, including security-positive mentions of encrypted API key storage. No malicious code, exfiltration patterns, or prompt injection attempts were found; the provided installation steps (npm install) and GitHub links (github.com/kk43994/kkclaw) are standard for open-source project deployment and aligned with the stated purpose.
Capability Assessment
Purpose & Capability
Name/description promise (desktop UI, TTS, model/provider management, Gateway diagnostics) matches the instructions and references to a GitHub project and releases. There are no unrelated credentials, binaries, or config paths requested that would contradict the stated purpose.
Instruction Scope
SKILL.md and reference files are README/setup-style instructions (git clone, npm install, npm start, links to releases). They do not instruct the agent to read arbitrary system files, exfiltrate data, or access environment variables beyond normal developer/runtime usage. The guidance is scoped to installing and running the kkclaw app and preparing OpenClaw/TTS/Gateway.
Install Mechanism
No install spec in the skill bundle (instruction-only), which is lowest platform risk. The README recommends cloning a GitHub repo and using npm and/or downloading GitHub release installers — these are typical but carry standard supply-chain risk (npm dependencies, third‑party binaries). Links point to GitHub (well-known host), not obscure hosts.
Credentials
The skill declares no required env vars/credentials. The README mentions TTS/configs/API key encryption as runtime features of the application, which is consistent; it does not request credentials from the agent itself. No disproportionate or unrelated secrets are requested.
Persistence & Privilege
always is false and the skill is user-invocable. As an instruction-only skill it does not request persistent agent privileges or modify other skills. Normal autonomous invocation is allowed by platform defaults but not combined here with other red flags.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install kkclaw
  3. After installation, invoke the skill by name or use /kkclaw
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.1.2
Initial ClawHub release for kkclaw v3.1.2
Metadata
Slug kkclaw
Version 3.1.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is kkclaw?

给 OpenClaw 加一个真正可长期使用的桌面身体:流体玻璃球 UI、14 情绪系统、语音播报/声音克隆、Setup Wizard、Doctor 自检、模型热切换、Gateway 守护与诊断。 It is an AI Agent Skill for Claude Code / OpenClaw, with 287 downloads so far.

How do I install kkclaw?

Run "/install kkclaw" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is kkclaw free?

Yes, kkclaw is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does kkclaw support?

kkclaw is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created kkclaw?

It is built and maintained by kk43994 (@kk43994); the current version is v3.1.2.

💬 Comments