Agent skill

Kkclaw

by kk43994 in kk43994/kkclaw

给你的 AI Agent 一个桌面身体 — Setup Wizard、14情绪球体、语音克隆、歌词窗、Doctor 自检、跨平台支持(Windows + macOS)

MITAuto-check passedMedia & Creative

Install Kkclaw

skills CLI
$ npx skills add kk43994/kkclaw --skill kkclaw -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kk43994/kkclaw kkclaw --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kkclaw
GitHub stars
174
Token cost
~576 tokens
SKILL.md length
123 words
Files
232 (incl. scripts, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

给你的 AI Agent 一个桌面身体 — Setup Wizard、14情绪球体、语音克隆、歌词窗、Doctor 自检、跨平台支持(Windows + macOS)

  • Tasks that involve Text to speech and voice
  • SKILL.md covers 功能特性, 技术栈, 安装 and 配置, plus 2 more sections
  • Calls npm and git

What it does

Kkclaw is an agent skill from kk43994/kkclaw. 给你的 AI Agent 一个桌面身体 — Setup Wizard、14情绪球体、语音克隆、歌词窗、Doctor 自检、跨平台支持(Windows + macOS)

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. The skill folder holds 235 other files, including scripts and assets (for example `.claude/plan.md`, `.claude/settings.local.json` and `.github/ISSUE_TEMPLATE/bug_report.yml`).

It sits in Media & Creative, covering Text to speech and voice. It works with macOS. The repository describes itself as: 🦞 一个可爱的桌面龙虾AI助手 - Desktop lobster pet with OpenClaw AI, Edge TTS voice, and emotion animations. The licence is MIT.

When your agent uses it

  • Tasks that involve Text to speech and voice

Example prompts

  • “/kkclaw”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 0e1879b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • npm
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • kk43994.github.io
    • clawhub.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kkclaw loads about 576 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 123 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~576

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from kk43994/kkclaw at commit 0e1879b, republished under its MIT licence (© kk43994). 123 words, ~576 tokens.

Download SKILL.mdSave it as .claude/skills/kkclaw/SKILL.md (or your agent's skills folder). This skill also uses 231 other files; get the full folder from GitHub.
name
kkclaw
description
给你的 AI Agent 一个桌面身体 — Setup Wizard、14情绪球体、语音克隆、歌词窗、Doctor 自检、跨平台支持(Windows + macOS)
version
3.1.2
author
xiao-k-assistant
tags
desktop-pet, electron, tts, voice, emotion, openclaw, visualization, cross-platform

kkclaw — 桌面龙虾 AI 伴侣

给你的 AI Agent 一个桌面身体:可视化球体 + 语音交互 + 情绪表达。

功能特性

  • 🧙 Setup Wizard — 首次运行引导配置,3 分钟上手
  • 🔐 safeStorage 加密 — API Key 本地加密存储,不再明文
  • 🎭 人设定制 — 自动生成 AGENTS.md / SOUL.md / USER.md / HEARTBEAT.md
  • 🎵 声音系统 — MiniMax 声音克隆 + CosyVoice + Edge TTS 三级降级,永不失声
  • 👀 情绪表达 — 14 种情绪 + 多种眼睛微表情 + 动态 glow 光效
  • 🩺 Doctor 自检 — 一键诊断 Gateway / 模型 / TTS / 端口 / 日志 / 歌词窗
  • 🎛️ 模型管理 — Provider CRUD、模型增删、延迟测速、预设快速添加
  • 🧠 Gateway 同步 — WebSocket 实时同步 OpenClaw Agent 状态,毫秒级响应
  • 💪 7x24 可靠 — 自动恢复、健康评分监控、Switch Logger
  • 🖥️ 轻量渲染 — 纯 HTML/CSS/JS 球体,CSS radial-gradient 琉璃质感,不依赖框架
  • 🎤 语音播报 — Agent 回复自动转语音,支持情感识别与停顿标记
  • 🖱️ 桌面集成 — 窗口置顶、鼠标穿透、拖动跟随、歌词式字幕窗口

技术栈

  • Electron(桌面容器)
  • OpenClaw Gateway(WebSocket 通信)
  • MiniMax Speech / CosyVoice / Edge TTS(语音合成)
  • CSS Animation + requestAnimationFrame(球体动画)

安装

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

或下载安装包:

配置

编辑 pet-config.json 自定义:

  • TTS 引擎和声音
  • 球体颜色和大小
  • OpenClaw Gateway 连接
  • 情绪映射规则
  • Setup Wizard 首次引导流程

目录结构

kkclaw/
├── main.js              # Electron 主进程
├── index.html           # 球体渲染 UI
├── lyrics.html          # 歌词字幕窗口
├── setup-wizard.html    # Setup Wizard 界面
├── setup-wizard.js      # Setup Wizard 逻辑
├── gateway-client.js    # Gateway 通信客户端
├── smart-voice.js       # 语音调度系统
├── templates/           # Agent 模板文件
├── voice/               # TTS 引擎模块
├── utils/               # 工具模块
├── scripts/             # 构建脚本
└── docs-dev/            # 开发文档

链接

© kk43994, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 231 other files (scripts, assets) in the repository root of kk43994/kkclaw.

  • SKILL.md
  • .claude/plan.md
  • .claude/settings.local.json
  • .env.example
  • .gitattributes
  • .github/ISSUE_TEMPLATE/bug_report.yml
  • .github/ISSUE_TEMPLATE/config.yml
  • .github/ISSUE_TEMPLATE/feature_request.yml
  • .github/ISSUE_TEMPLATE/maintenance.yml
  • .github/pull_request_template.md
  • .github/workflows/build-release.yml
  • .github/workflows/ci.yml
  • .gitignore
  • CHANGELOG.md
  • CONTRIBUTING.md
  • LICENSE
  • PROJECT-STRUCTURE.md
  • … and 215 more

Open the folder on GitHubat commit 0e1879b

Compare with similar skills

Kkclaw next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kkclaw compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kkclaw this skillkk43994/kkclaw174—~576Automated safety check: PassMIT
Sayitcallebtc/sayit159—~2.9kAutomated safety check: PassMIT
Agentvibespaulpreibisch/AgentVibes155—~1.5kAutomated safety check: PassApache-2.0
Ttsmikeyobrien/rho372—~177Automated safety check: PassMIT
Med Podcast Generatorinfometa/workbuddyskills346—~1kAutomated safety check: PassNone
Sayit Releasecallebtc/sayit159—~1.1kAutomated safety check: WarnMIT

Similar skills

  • Sayit

    callebtc/sayit

    Live, low-latency spoken narration for hands-free agent sessions through the sayit TTS command.

    159 GitHub stars~2.9k tokensUpdated 16 days ago
    Media & CreativeAuto-check passed
  • Agentvibes

    paulpreibisch/AgentVibes

    🎤 AgentVibes Voice Management - Manage your text-to-speech voices across multiple providers (Piper TTS, Piper, macOS Say).

    155 GitHub stars~1.5k tokensUpdated 22 days ago
    Media & CreativeAuto-check passed
  • Tts

    mikeyobrien/rho

    Text-to-speech on macOS -- make the device speak text aloud.

    372 GitHub stars~177 tokensUpdated 8 days ago
    Media & CreativeAuto-check passed
  • Med Podcast Generator

    infometa/workbuddyskills

    将医学文本草稿(论文摘要、临床指南、教学讲义、药品推广材料、专家访谈等)二创为播客音频,输出 .mp3 + 配套脚本文本。支持单人讲解与双人对话两种形式,edge-tts 神经网络真人级音色,内置 90+ 医学英文术语发音自动修正,无网络时回退 macOS 原生引擎。当用户提到"把医学内容做成播客""生成播客音频""双人对话播客""医学播客""medical podcast"等需求时使用本…

    346 GitHub stars~1k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Sayit Release

    callebtc/sayit

    Build, sign, validate, notarize, and publish Say It macOS DMG releases using the repository release script.

    159 GitHub stars~1.1k tokensUpdated 16 days ago
    Media & CreativeAuto-check: warnings
  • Voice Setup

    vellum-ai/vellum-assistant

    Complete voice configuration in chat - desktop Talk and PTT shortcuts, microphone permissions, ElevenLabs/Deepgram TTS, and troubleshooting

    1.4k GitHub stars~2.8k tokensUpdated today
    Media & CreativeAuto-check passed

Works with

Questions about Kkclaw

What does Kkclaw do?

给你的 AI Agent 一个桌面身体 — Setup Wizard、14情绪球体、语音克隆、歌词窗、Doctor 自检、跨平台支持(Windows + macOS). Kkclaw is an agent skill from kk43994/kkclaw.

When should I use Kkclaw?

Kkclaw fits situations like: tasks that involve Text to speech and voice.

How do I install Kkclaw in Claude Code?

Run `npx skills add kk43994/kkclaw --skill kkclaw -a claude-code`. Or copy the skill folder (the kk43994/kkclaw repository) into .claude/skills/kkclaw in your project. Claude Code loads it when a task matches its description.

How do I install Kkclaw in Codex?

Run `npx skills add kk43994/kkclaw --skill kkclaw -a codex`. Or copy the skill folder (the kk43994/kkclaw repository) into .agents/skills/kkclaw in your project. Codex loads it when a task matches its description.

Can I use Kkclaw in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kk43994/kkclaw --skill kkclaw -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kkclaw, .gemini/skills/kkclaw, .github/skills/kkclaw and .opencode/skills/kkclaw in your project.

What does Kkclaw need to run?

Going by SKILL.md and its folder, Kkclaw needs the command-line tools its instructions call (npm and git). Our summary lists: Node.js.

Does Kkclaw access the network?

SKILL.md names 2 domains. As links in the text: kk43994.github.io and clawhub.ai. This is read from the text; nothing was executed.

Is Kkclaw safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Kkclaw use?

Kkclaw is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kkclaw use?

About 576 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Kkclaw?

Skills that share tags, products or a category with Kkclaw: Sayit (callebtc/sayit, 159 stars), Agentvibes (paulpreibisch/AgentVibes, 155 stars), Tts (mikeyobrien/rho, 372 stars) and Med Podcast Generator (infometa/workbuddyskills, 346 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kkclaw?

kk43994 (a GitHub user) maintains it in kk43994/kkclaw, which has 174 GitHub stars. The repository was last updated on April 14, 2026.

Source: kk43994/kkclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.