OpenClaw / Hermes ๆก้ขๅฏ่งๅไผดไพฃ โ ๆตไฝ็ป็็ๅฎ ็ฉใ14ๆ ็ปช็ณป็ปใๅฃฐ้ณๅ ้๏ผMiniMax TTS๏ผใHermes ๅ ผๅฎนๆจกๅผใไธ้ฎ้ ็ฝฎๅๅฏผใGateway ๆบ่ฝๅฎๆค
OpenClaw / Hermes + Desktop Embodiment = A living interface with emotion, voice, and presence
๐ฅ ๅจ็บฟๆผ็คบ | ๐ฆ ไธ่ฝฝๆๆฐ็ | ๐ ้ ็ฝฎๆ็จ | ๐ฌ ๅ ๅ ฅ็คพ็พค
็ปไฝ ็ OpenClaw / Hermes AI ไธไธช็ๅพ่งใๅฌๅพๅฐ็ๆก้ขๅ่บซใ
| ๅ่ฝ | ่ฏดๆ |
|---|---|
| ๐ฎ ๆตไฝ็ป็็ | 67px ็็่ดจๆ็ไฝ๏ผๅ ้จๆถฒไฝๆ็ปญๆตๅจ๏ผๅฎๅฆๆดป็ฉ๏ผ3ๅฑๆตไฝๅจ็ป + ๅพๅๆธๅ + ๅ้้ซๅ ๏ผ |
| ๐ 14็งๅฟๆ ๅ่ฒ | ๅผๅฟๆๆฉใไผคๅฟๅคฉ่ใ็ๆฐ็ซ็บขโฆโฆๆฏ็งๆ ็ปชๅฏนๅบ็ฌ็ซ้ข่ฒไธๅ ๆๆๆ๏ผ14-emotion glow system๏ผ |
| ๐ 38็งๅพ ๆบๅพฎ่กจๆ | ๅพ ๆบๆถ่ชๅจๆญๆพ็จ็ผใๆญชๅคดใๅท็ใๆ็นใๆๆ็ผใ่ฃ ๆญป็ญ่กจๆ ๏ผ่ฅ้ ้ฒๆดปๆงๆ ผๆ๏ผidle micro-expression engine๏ผ |
| ๐ ๆถ้ดๆ็ฅ่กจๆ | ๆฉๆจๆดปๅใๅๅๅฐๅฆใๆทฑๅคๅๆฌ โโ่ชๅจๆ็ฅๅฝๅๆถๆฎตๅนถๅๆข่กจๆ ๏ผๆถ้ดๅบๆฏๆ็ฅ๏ผmorning / noon / afternoon / evening / latenight๏ผ |
| ๐ฑ๏ธ ้ผ ๆ ่ท่ธช็ผ็ฅ | ็ไฝ็ผ็่ท้ๅ ๆ ๆนๅ่ฝฌๅจ๏ผๅขๅผบไบๅจๆ๏ผmouse tracking๏ผ |
| ๐ ๅฎณ็พ่ธ็บข | ็นๅฎ่กจๆ ่งฆๅๆถ๏ผ่ธ้ขๆตฎ็ฐ็ฒ่ฒ็บขๆ๏ผdynamic blush overlay๏ผ |
| ๐ซง ๆฐๆณก่ฃ ้ฅฐ็ฒๅญ | ็ไฝๅจๅด้ฃๆตฎๅ้ๆๆฐๆณก๏ผๅขๆทป็ตๅจๆฐๅด๏ผbubble particle decoration๏ผ |
| โจ ็นๅปๅผน่ทณๅ้ฆ | ็นๅป็ไฝไบง็ๅผนๆงๅ็ผฉ + ้ข่ฒ่ๅฒ๏ผๆไฝๆๆๆ๏ผsquish animation + color pulse๏ผ |
| ๐ ๆฌๆตฎๅผๅธๆๆ | ็ไฝๅพฎๅน ไธไธๆตฎๅจ๏ผๅฆๅๆฐด้ขๆผๆตฎ๏ผ60fps float + breath scaling๏ผ |
| ๅ่ฝ | ่ฏดๆ |
|---|---|
| ๐ค ไธ้ฎๅฃฐ้ณๅ ้ | ไธไผ 30็งๅฝ้ณๅณๅฏๅ ้ๅฃฐ้ณ๏ผAI ็จไฝ ่ชๅทฑ็้ณ่ฒ่ฏด่ฏ๏ผMiniMax Voice Cloning API๏ผ |
| ๐ต 8็ง้ข่ฎพ้ณ่ฒ | ๆ ้ๅ ้๏ผ็ดๆฅ้ๆฉๅฎๆน้ข่ฎพ้ณ่ฒๅณๅฏไฝฟ็จ๏ผ8 preset voices๏ผ |
| ๐ฃ๏ธ 14็งๆ ๏ฟฝ๏ฟฝ่ฏญ่ฐ | ๆ นๆฎๆๆฌๅ ๅฎน่ชๅจๅน้ ๆ ็ปช่ฏญๆฐโโๆฌขๅฟซใไฝๆฒใๆฟๅจ็ญ่ช็ถๅๆข๏ผemotion-aware TTS๏ผ |
| ๐ ๆบ่ฝ้็บง้พ | ไธปๅผๆๆ ้่ชๅจๅๅค็จๅผๆ๏ผ็กฎไฟ่ฏญ้ณๆฐธไธไธญๆญ๏ผMiniMax โ Edge TTS ้็บง้พ๏ผ |
| โธ๏ธ ่ช็ถๅ้กฟ | ๅจๆ ็น็ฌฆๅทๅค่ชๅจๆทปๅ ่ฏญๆฐๅ้กฟ๏ผๅๅซๆบๅจไบบๅผๆ่ฏป๏ผTTS pause markers <#0.5#>๏ผ |
| ๐ ๆก้ขๅญๅนๅๆญฅ | ่ฏญ้ณๆญๆฅๆถๅๆญฅๆพ็คบ้ๅญๅญๅน๏ผๆๅญๆบๆๆๅ็ฐ๏ผtypewriter lyrics overlay๏ผ |
| ๐ ๆถๆฏๆ้ๆญๆฅ | ๅคๆกๆถๆฏๅๆถๅฐ่พพๆถ่ชๅจๆ้๏ผ้ๆกๆญๅบไธๅ ้ณ๏ผpriority speech queue๏ผ |
| ๐ซ ้ๅคๆถๆฏ่ฟๆปค | ็ธๅๅ ๅฎน่ชๅจๅป้๏ผ้ฟๅ ้ๅคๆญๆฅ๏ผwhitespace-normalized dedup filter๏ผ |
| ๅ่ฝ | ่ฏดๆ |
|---|---|
| ๐ญ 5็งๆงๆ ผ้ข่ฎพ | ็ๅฆน / ไธไธ / ๅนฝ้ป / ้ ทๅธ / ่ชๅฎไน๏ผไธ้ฎๅๆข่ฏด่ฏ้ฃๆ ผ๏ผpersonality preset system๏ผ |
| ๐ ไบบ่ฎพๆไปถ่ชๅจ็ๆ | ้ๅฎๆงๆ ผๅไธ้ฎ็ๆ AI ไบบๆ ผๆกฃๆก๏ผๆ ้ๆๅๆ็คบ่ฏ๏ผauto-generate AGENTS.md + SOUL.md + USER.md๏ผ |
| ๐ฌ ่ชๅฎไน็งฐๅผ | ่ชๅฎไนๅฎ ็ฉๅ็งฐๅๅฏนไฝ ็็งฐๅผ๏ผๅฆใๅฐKๅซไฝ ไธปไบบใ๏ผpetName + userName ้ ็ฝฎ๏ผ |
| ๅ่ฝ | ่ฏดๆ |
|---|---|
| โก ่ชๅจๆ่ตท | ่ฟ็ปญ3ๆฌกๆฃๆต Gateway ไธๅจ็บฟๅ่ชๅจๅฏๅจ๏ผๆ ้ๆๅจๅนฒ้ข๏ผGuardian auto-start๏ผ |
| ๐ ๅฎๆถๅฅๅบท็ๆง | ๅๅฐๆ็ปญ้้ Gateway ่ฟ่กๆๆ ๏ผๅผๅธธๆถ็ฌฌไธๆถ้ดๅ่ญฆ๏ผanomaly detection + health scoring๏ผ |
| ๐๏ธ ่ฏญ้ณ็ถๆๆญๆฅ | ๅฏๅจไธญ / ๆๅ / ๅคฑ่ดฅๅๆ่ฏญ้ณ้็ฅ๏ผไธๅฟ ็ฏๆงๅถๅฐ๏ผvoice status announcement๏ผ |
| ๐ ๅดฉๆบ่ชๅจ้ๅฏ | Gateway ๅผๅธธ้ๅบๅ่ชๅจๆ่ตท๏ผๆฏๅฐๆถไธ้10ๆฌก้ฒๆญขๆญปๅพช็ฏ๏ผauto-restart with rate limiting๏ผ |
| ๐ฉบ 10้กนไธ้ฎไฝๆฃ | Gateway / TTS / ๆจกๅ / ็ซฏๅฃ / ็ผๅญ / ๆฅๅฟ็ญ10็ปดไธ้ฎ่ฏๆญ๏ผ้ไฟฎๅคๅปบ่ฎฎ๏ผDoctor self-check๏ผ |
| ๐ง ๅ้็กฎ่ฎค้ฒ่ฏฏๅค | ้ๅฏๅไธ ServiceManager ไบคๅๆ ก้ช๏ผ้ฟๅ ่ฏฏๆๅฅๅบทๅฎไพ๏ผcross-validation with ServiceManager๏ผ |
| โณ ๅฏๅจๅฎฝ้ๆ | ้ฆๆฌกๅฏๅจ60็งๅ ไธ่งฆๅ้ๅฏ้ป่พ๏ผ็ป Gateway ๅ ่ถณๅฏๅจๆถ้ด๏ผstartup grace period๏ผ |
| ๅ่ฝ | ่ฏดๆ |
|---|---|
| ๐ฎ RPG ๆธธๆ้ฃๆ ผ | ๆจ่ดจ่พนๆก + ็พ็ฎ็บธ็บน็ + ้พ่พๅๅฏผ NPC + ๆๅญๆบๅฏน็ฝ๏ผRPG-style Setup Wizard๏ผ |
| ๐ 7ๆญฅๅ จๆต็จๅผๅฏผ | Gateway โ ๆจกๅ โ ๆถๆฏๆธ ้ โ ่ฏญ้ณๅผๆ โ ๆญๆฅ่ฎพ็ฝฎ โ ๆพ็คบ้้กน โ ๅ จ้พ่ทฏๆต่ฏ |
| โก ็ผบๅคฑไพ่ตไธ้ฎๅฎ่ฃ | ๆฃๆตๅฐ็ผบๅคฑไพ่ตๅไธ้ฎๅฎ่ฃ ๏ผๅฎๆถๆพ็คบๅฎ่ฃ ่ฟๅบฆ๏ผone-click dependency install + real-time progress๏ผ |
| ๐ ๆบ่ฝ็ฏๅขๆฃๆต | ่ชๅจๆขๆต Node.js / Python / OpenClaw ็ญ็ฏๅข็ถๆๅ็ๆฌไฟกๆฏ๏ผsmart environment detection๏ผ |
| โ ๅ จ้พ่ทฏ้ช่ฏ | 7้กน็ซฏๅฐ็ซฏๆต่ฏ็กฎไฟๆๆๅ่ฝๆญฃๅธธ่ฟ่ก๏ผend-to-end validation๏ผ |
| ๐ ้่ฏฏๅฏ่งๅ | ๅๅฏผๅผๅธธๆถ็ดๆฅๆพ็คบๆฅ้ไฟกๆฏ๏ผไธๅ็ฝๅฑๆ ๆ็คบ๏ผerror visualization + crash recovery๏ผ |
| ๅ่ฝ | ่ฏดๆ |
|---|---|
| ๐ ๅฝฉ่ฒ็ป็ซฏๆฅๅฟ | 12+ ๆจกๅ็ปไธๅฝฉ่ฒ่พๅบโโๆจกๅๅ้่ฒใURL็ปฟ่ฒใ้่ฏฏ็บข่ฒ๏ผไธ็ฎไบ็ถ๏ผANSI colorized logging๏ผ |
| ๐ ๆฅๅฟ่ชๅจๅป้ | ็ฉบ็ฝๅฝไธๅๅๅป้๏ผๆถ้คๆงๅถๅฐๅทๅฑ๏ผwhitespace-normalized dedup๏ผ |
| ๐ ๆฅๅฟ่ฝฎ่ฝฌๅฝๆกฃ | ๆๅคฉๅฝๆกฃใ่ถ 10MB่ชๅจๅ็ผฉใไฟ็7ๅคฉๅๅฒ๏ผlog rotation + gzip archiving๏ผ |
| ๐ ๆง่ฝๅฎๆถ็ๆง | ๅ ๅญ / CPU / ๅธง็ๅฎๆถ้้๏ผ่ถ ้ๅผ่ชๅจๅ่ญฆ๏ผperformance monitor + 24h sample history๏ผ |
| ๅ่ฝ | ่ฏดๆ |
|---|---|
| ๐ ็ญๅๆข | Claude โ GPT โ Gemini โ DeepSeek ๆ ้้ๅฏ๏ผ3็ง็ๆ๏ผhot model swap via CC-Switch๏ผ |
| ๐ ๅปถ่ฟๆต้ | ไธ้ฎๅฏนๆฏๅๆจกๅๅๅบๅปถ่ฟ๏ผ้ๆฉๆไผ๏ผlatency benchmark๏ผ |
| โ ่ช็ฑๆทปๅ ๆจกๅ | ๆฏๆ15+ไธปๆต AI ๆๅกๅ๏ผไนๅฏ่ชๅฎไน API ็ซฏ็น๏ผcustom provider + preset templates๏ผ |
| ๐ ๅๆขๅๅฒ่ฟฝๆบฏ | ๅฎๆด่ฎฐๅฝๆฏๆฌกๆจกๅๅๆข็ๆถ้ดไธๆฅๆบ๏ผswitch history tracking๏ผ |
| โฉ๏ธ ๅคฑ่ดฅ่ชๅจๅๆป | ๆฐๆจกๅ5็งๅ ๆ ๅๅบ๏ผ่ชๅจๅ้ๅฐไธไธๅฏ็จๆจกๅ๏ผoptimistic update + 5s rollback๏ผ |
| ๅ่ฝ | ่ฏดๆ |
|---|---|
| ๐ ๅฏ้ฅๅ ๅฏๅญๅจ | API Key ็ป Electron safeStorage ๅ ๅฏๅๅ็๏ผๆ็ปๆๆๆณ้ฒ |
| ๐ก๏ธ IPC ๆ้ๆฒ็ฎฑ | ๆธฒๆ่ฟ็จๆ ๆณ็ดๆฅ่ฐ็จ็ณป็ป API๏ผๆๆๆไฝ็ป็ฝๅๅๆ ก้ช๏ผIPC whitelist sandbox๏ผ |
| ๐งน ๆฅๅฟ่ชๅจ่ฑๆ | ๆฅๅฟไธญ่ชๅจ้ฎ่ฝ API KeyใToken ็ญๆๆไฟกๆฏ๏ผlog sanitizer๏ผ |
| ๐ ๅฝไปคๆณจๅ ฅ้ฒๆค | ๆๆๅค้จๅฝไปคไฝฟ็จๅๆฐๆฐ็ปไผ ้๏ผไธๆผๆฅๅญ็ฌฆไธฒ๏ผexecFile/spawn with args array๏ผ |
| ๅ่ฝ | ่ฏดๆ |
|---|---|
| ๐ ๆฐธ่ฟ็ฝฎ้กถ | ็ไฝไธๅญๅน็ชๅฃๅง็ปไฝไบๆไธๅฑ๏ผไธ่ขซๅ ถไป็ชๅฃ้ฎๆก๏ผalways-on-top๏ผ |
| ๐ฑ๏ธ ๅญๅน็ฉฟ้็นๅป | ๆญ่ฏๅญๅน็ชๅฃๅฎๅ จ็ฉฟ้้ผ ๆ ไบไปถ๏ผไธๅฝฑๅๅบๅฑๆไฝ๏ผmouse-through transparent window๏ผ |
| ๐ ่ชๅจๅๅปบๆก้ขๅฟซๆทๆนๅผ | ้ฆๆฌกๅฏๅจ่ชๅจ็ๆๆก้ขๅฟซๆทๆนๅผ๏ผไธๆฌกๅๅปๅณ็จ๏ผauto .lnk / .app creation๏ผ |
| ๐ธ ๆชๅพไธ้ฎไธไผ | ๅทฅๅ ทๆ ไธ้ฎๆชๅฑ๏ผ่ชๅจไธไผ ่ณ้ฃไนฆ๏ผscreenshot + Lark upload๏ผ |
| ๐ฌ ๅคๅนณๅฐๆถๆฏๅๆญฅ | Discord / Telegram / ้ฃไนฆ / ไผไธๅพฎไฟกๆถๆฏ็ปไธๅๆญฅๅนถ่ฏญ้ณๆญๆฅ๏ผmulti-channel message sync๏ผ |
| ๐ ่ทจๅนณๅฐๆฏๆ | Windows 10/11 + macOS๏ผIntel & Apple Silicon๏ผๅๅนณๅฐๅ็ๆฏๆ๏ผcross-platform Electron๏ผ |
| ๐ฑ ๆ็่ๅ | ๅณ้ฎ็ณป็ปๆ็ๅณๅฏๅๆขๆจกๅใๆฅ็็ถๆใๅฏๅจ่ฏๆญใ็ฎก็ไผ่ฏ๏ผsystem tray context menu๏ผ |
๐ค ๆญฃๅผ้้ Hermes๏ผ
kkclaw gateway็ฐๅจไธๅชไผๆ่ตท OpenClaw๏ผไน่ฝไปฅๅ ผๅฎนๆจกๅผ้ฉฑๅจ Hermes๏ผๅนถๅจๅฏๅจๆถๆไพ OpenClaw / Hermes / Auto ไธ็งๅ ฅๅฃใ
Hermes Agent banner adapted from NousResearch/hermes-agent
- ๐ Hermes ๅ
ผๅฎนๆจกๅผ โ ๆฏๆ
KKCLAW_COMPAT_MODE=hermes๏ผไนๆฏๆๅจpet-config.jsonไธญๅบๅฎcompatMode: "hermes" | "openclaw" | "auto" - ๐ ๅ็ซฏ้ๆฉๅผๅฏๅจ โ
kkclaw gateway/npm start็็ป็ซฏๅ ฅๅฃ็ฐๅจไผๅ ่ฎฉไฝ ้ๆฉ OpenClaw / Hermes / Auto๏ผๅนถ่ฎฐไฝไธๆฌก้ๆฉ - ๐ Hermes Gateway ๅค็จ โ ๅฆๆ Hermes Gateway ๅทฒ็ปๅจๅค้จๅฏๅจ๏ผKKClaw ไผ่ฏๅซๅนถๅค็จ๏ผไธๅๆๅฎ่ฏฏๅคๆ็ซฏๅฃๅฒ็ช
- ๐ง ่ฏๆญๅ
จ้ขๅขๅผบ โ
kkclaw status/kkclaw doctor/kkclaw gateway statusไผๆพ็คบๅฝๅๅ ผๅฎนๅ็ซฏใCLI ่ทฏๅพใๆขๆดปๆนๅผใๆฅๅฟ่ทฏๅพใAPI Server ็ถๆ - ๐จ ๅ็ซฏๆ็ฅ็ป็ซฏๅค่ง โ ๅฏๅจ็ป้ขๅ Ready Banner ไผๆ นๆฎ OpenClaw / Hermes ๅๆขไธป่ฒๅๆ ็ญพ๏ผ็ป็ซฏไฝ้ชๆด็ปไธ
๐ฆ ๅฝไปคไฝ้ชๅ็บง๏ผ
kkclaw gateway็ฐๅจ็ดๆฅๆๅผๅธฆๅผๅบๅจ็ป็็ป็ซฏ๏ผๅนถ่กฅ้ฝdoctor / status / logs / dashboard
- ๐
kkclaw gatewayไธปๅ ฅๅฃ โ ็ดๆฅๆๅผ็ฐๅจnpm start็ๅจ็ป็ป็ซฏไฝ้ช๏ผๅฏๅจไน ๆฏๆดๆฅ่ฟๅ็ OpenClaw - ๐
kkclaw doctorโ ๅขๅ KKClaw ้ฃๆ ผไฝๆฃ๏ผๆฃๆฅ OpenClaw CLIใGateway ่ฟ้ๆงใDashboard ๅฐๅๅ่ฟ็จๅฝๅฑ - ๐
kkclaw gateway status / logs / open / restart / stopโ ๆไพ่ดด่ฟ OpenClaw ไฝฟ็จไน ๆฏ็ๅญๅฝไปค - ๐
kkclaw dashboardโ ็ดๆฅ่ฝฌๅๅฐๅบๅฑopenclaw dashboard - ๐ง ็ถๆๅฏ่งๆตๆงๅขๅผบ โ
doctorไผๆ็คบๅฝๅ Gateway ็ซฏๅฃๆฏๅฆ็ฑ KKClaw ่ช่บซๅ ็จ๏ผๅธฎๅฉๆๆฅๆง่ฟ็จ/็ซฏๅฃๅฒ็ช
โก ไฝ้ชไผๅ๏ผ Wizard ็ฝๅฑไฟฎๅค + ็ผบๅคฑไพ่ตไธ้ฎๅฎ่ฃ + ่ทจๅนณๅฐๆฏๆ
- โก ไธ้ฎๅฎ่ฃ ็ผบๅคฑไพ่ต โ ็ฏๅขๆฃๆต้กตๆฐๅขๆ้ฎ๏ผ่ชๅจๅฎ่ฃ edge-tts / sqlite3 / node_modules๏ผๅฎๆถ่ฟๅบฆๅ้ฆ
- ๐ง ่ทจๅนณๅฐๅฎ่ฃ โ Windows (winget/choco)ใmacOS (brew)ใLinux (apt/yum)
- ๐ Wizard ็ฝๅฑไฟฎๅค โ ไฟฎๅค 3 ๅค่ฏญๆณ้่ฏฏๅฏผ่ด็ๅๅฏผ็ฉบ็ฝ้กต
- ๐ Wizard ้่ฏฏๅฏ่งๅ โ ๆธฒๆๅบ้ๆถ็ดๆฅๆพ็คบๆฅ้ไฟกๆฏ๏ผๆนไพฟ็จๆทๆๆฅ
- ๐ sqlite3 ไพ่ต่ฏดๆ โ ๆ ๆณจ็จ้
(CC-Switch ๅๆญฅ)๏ผๆชๅฎ่ฃ ๆถๆ็คบๅฎ่ฃ ๅฝไปค
- ๐ ๅๅฃฐ้ณไฟฎๅค โ ๆๆ
new Notification()ๆทปๅsilent: true๏ผ้ปๆญข Windows ็ณป็ปๆ่ฏป - ๐ฅ๏ธ ๅฟซๆทๆนๅผไฟฎๅค โ ๆๅ
start.cmd๏ผๅฏๅจๆถๆพ็คบ CMD ๆงๅถๅฐ + Gateway ๆฅๅฟ
๐จ ้ๅคงไฝ้ชๆดๆฐ๏ผ ๅ จๅฑๅฝฉ่ฒ็ป็ซฏๆฅๅฟ + Gateway ๆบ่ฝ่ชๅฏๅจ + ๆฅๅฟๅป้้ๅช + ้ฆๆฌกๅฏๅจ่ชๅจๅๅปบๆก้ขๅฟซๆทๆนๅผ
- ๐ color-log.js ไธญๅฟๅๆจกๅ โ ็ปไธ ANSI ้ข่ฒๅธธ้ + ่ชๅจๅ ณ้ฎ่ฏ้ซไบฎ
- โจ 12+ ๆจกๅๅ จ่ฆ็ โ main.js / service-manager / gateway-guardian / smart-voice / message-sync / pet-config / screenshot / log-rotation / performance-monitor / desktop-notifier ๅ จ้จ่ฟ็งป
- ๐ฏ Gateway ๆฅๅฟ้ซไบฎๅขๅผบ โ ๆจกๅๅ(cyan)ใURL(green)ใ่ทฏๅพ(dim)ใๆธ ้(magenta)ใ@botname(magenta)ใkey=value(yellow)ใ็ซฏๅฃๅท(yellow)ใๅ่ฎฎ(cyan)ใ้่ฏฏ(red)ใๆๅ(green)ใ่ญฆๅ(yellow)
- ๐ ้ฆๆฌกๅฏๅจไธปๅจๆ่ตท โ Guardian ไธๅๆฐธ่ฟ็ญๅพ
๏ผ่ฟ็ปญ 3 ๆฌกๆฃๆตไธๅฐ Gateway ๅ่ชๅจๆง่ก
startGateway() - ๐ ๅฏๅจ็ถๆ่ฏญ้ณๆญๆฅ โ ๅฏๅจไธญๆญๆฅ"็ญๅพ Gatewayๅฏๅจไธญ"๏ผๆๅ/ๅคฑ่ดฅๅๅซ่ฏญ้ณ้็ฅ
- ๐ง ไบๆฌก็กฎ่ฎค้ฒ่ฏฏๅค โ ไธ ServiceManager ๆขๆดปไบคๅๆ ก้ช๏ผ้ฟๅ ่ฏฏ่งฆ้ๅฏ
- ๐ง ๅฏๅจๆ้้ป โ ้ฆๆฌกๅฏๅจ้ถๆฎตไธๅๅ่ญฆไบไปถ๏ผ้ฟๅ ๅช้ณ
- ๐ง ไฟฎๅค Gateway ๆฅๅฟ้ๅค โ ๆพๅฐๆ นๅ ๏ผ
log()ๆนๆณๅจ stdout handler ไนๅไบๆฌกconsole.log()๏ผgateway-std* ๆๅก่ทณ่ฟๆงๅถๅฐ่พๅบ - ๐ง stderr ๆบ่ฝ่ฟๆปค โ ไป ๆพ็คบๅซ error/fatal/panic/exception ็็้่ฏฏ่ก
- ๐ง ็ฉบ็ฝๅฝไธๅๅป้ โ
\s+โ' 'ๅฝไธๅๅ Set ๅป้๏ผๅฝปๅบๆถ้คๅๅ ๅฎน้ๅค
- ๐ ่ชๅจๅๅปบ .lnk โ ้ฆๆฌกๅฏๅจ่ชๅจๅจๆก้ขๅๅปบ"Claw ๆก้ขๅฎ ็ฉ"ๅฟซๆทๆนๅผ
- ๐ง PowerShell COM ๅฏน่ฑก โ ไฝฟ็จ WScript.Shell ๅๅปบๅฟซๆทๆนๅผ๏ผ่ฎพ็ฝฎๅพๆ ๅๆๅฐๅๅฏๅจ
- ๐ง ๆบ่ฝ่ทณ่ฟ โ ๅทฒๅญๅจๅฟซๆทๆนๅผๆ้ Windows ๅนณๅฐ่ชๅจ่ทณ่ฟ
- ๐๏ธ ่ฏญ้ณๆญๆฅ โ ๅๅปบๆๅๅๆญๆฅ"ๆก้ขๅฟซๆทๆนๅผๅทฒๅๅปบ"
- ๐ ไฟฎๅค่ฏญ้ณๅๅ โ ็งป้ค messageSync ไธญ้ๅค็
voiceSystem.speak()่ฐ็จ - ๐ ไฟฎๅค้็ฅๆฅๅฟ้ๅค โ desktop-notifier ๅชๆๅฐ้็ฅ็ฑปๅ๏ผไธ้ๅคๆๅฐ payload
- ๐ DashScope TTS ๅผๆ็งป้ค โ ่ฏญ้ณ้็บง้พ็ฎๅไธบ MiniMax โ Edge TTS
๐ ๅฎๅ จ้็นๆดๆฐ๏ผ ๅฝไปคๆณจๅ ฅไฟฎๅค + ๅจๆ Token ็ฎก็ + ๆจกๅ็ญๅๆข็ถๆๆบ + Gateway ๆบ่ฝ็ๆง
- ๐ฎ RPG ๆธธๆ้ฃๆ ผ โ ๆจ่ดจ่พนๆก + ็พ็ฎ็บธ่ๆฏ + ้พ่พๅๅฏผ่ง่ฒ
- ๐ 7 ๆญฅๅผๅฏผๆต็จ โ Gateway โ ๆจกๅ โ ๆธ ้ โ TTS โ ่ฏญ้ณๆญๆฅ โ ๆพ็คบ โ ๆต่ฏ
- ๐ค ไธ้ฎ้ณ่ฒๅ ้ โ ไธไผ 30็งๅฝ้ณ๏ผ่ชๅจ่ฐ MiniMax/CosyVoice API ๅๅปบไธๅฑ้ณ่ฒ
- ๐ญ ไบบ่ฎพๅฎๅถ็ณป็ป โ 5็ง้ข่ฎพ้ฃๆ ผ๏ผ็ๅฆน/ไธไธ/ๅนฝ้ป/้ ทๅธ /่ชๅฎไน๏ผ
- ๐ ๅ
จๅฅๆไปถ็ๆ โ ไธ้ฎ็ๆ
AGENTS.md+SOUL.md+USER.md+HEARTBEAT.md+desktop-bridge.js - ๐ ๅฎๆด AGENTS.md ๆจกๆฟ โ ๅฏน้ฝ็ไบง็บง้ ็ฝฎ๏ผ่ฎฐๅฟ็ณป็ป + ๅฎๅ จ่งๅ + ็พค่่งๅ + ๅฟ่ทณๆฃๆฅ + ่ฏญ้ณๆญๆฅ๏ผ
- ๐ ๆญๆฅๆบๅถ่ฏดๆ โ AI ๅๅค่ฏญ้ณไธๆฏโๅช่ฆ้
ๅฅฝ TTS ๅฐฑไผ่ชๅจๆ่ฏปโใ็ๆญฃ็ๆไพ่ต 3 ๅฑ๏ผTTS ๆๅกๅฏ็จใ
desktop-bridge.jsๅทฒ็ๆไธๅฏๆง่กใagent ๆAGENTS.mdๅจๆฏๆฌกๅๅคๅไธปๅจ่ฐ็จnode desktop-bridge.js agent-response "่ฆๆญๆฅ็ๅ ๅฎน" - ๐ก ๆจกๅๅ ผๅฎนๆงๆ็คบ โ ๆจ่ Claude Sonnet 4+ ๆ่ฐๆจกๅ่ทๅพๆไฝณๆญๆฅไฝ้ช
- โ 7 ้กนๅ จ้พ่ทฏๆต่ฏ โ Gateway / ๆจกๅ / TTS / ๆญๆฅ / ๆญ่ฏ / Agentๆไปถ / ้ณ่ฒ
- ๐ 7 โ 14 ็งๆ ็ปช โ ๆฐๅข sadใangryใfearfulใcalmใexcitedใloveใfocused
- โจ ๅจๆๅคๅๅ โ ๆฏ็งๆ ็ปชๆไธๅฑ glow ๅ ๆ
- ๐ญ ๆ
็ปชๆๆฌๆฃๆต โ
desktop-bridge.js่ชๅจๅๆๅ ๅฎนๆ ็ปช๏ผ10็งๅน้ ่งๅ
- ๐ API Key ๅ ๅฏๅญๅจ โ
safeStorageๅ ๅฏ๏ผๅฏ้ฅไธๅๆๆๅๅ ฅ็ฃ็ - ๐ preload ๅฎๅ จๆฒ็ฎฑ โ ไธป็ชๅฃ/ๆญ่ฏ/่ฏๆญ/ๆจกๅ่ฎพ็ฝฎๅ จ้จ่ตฐ IPC ็ฝๅๅ๏ผๆธฒๆ่ฟ็จไธๅ็ดๆฅ require Node
- ๐ต ๆญ่ฏ็ชๅฃ Ready ๅฎๅซ โ
lyricsReadyๆ ๅฟไฝ๏ผ้ฒๆญขๅ ่ฝฝๆชๅฎๆๆถๅดฉๆบ - ๐ง sendLyric ๅฐ่ฃ โ ็ปไธๆญ่ฏๆจ้๏ผ่ชๅจๆฃๆฅ็ชๅฃ็ถๆ
- ๐ก ็ซฏๅฃๆไน ๅ โ ้็ฅ็ซฏๅฃๅๅ ฅ้ ็ฝฎ๏ผwizard/bridge ๅฏๅจๆ่ทๅ
- ๐ก ๆธฒๆ่ฟ็จ้่ฏฏ่ฝฌๅ โ
preload-error+console-message่ฝฌๅๅฐไธป่ฟ็จๆฅๅฟ๏ผ้ฒๆญข้้ปๅคฑ่ดฅ
- ๐ Doctor ่ชๆฃ็ณป็ป โ 10 ้กนๅ จ่ชๅจ่ฏๆญ๏ผGateway / ๆ็ / TTS้ ็ฝฎ / ๆจกๅ / ็ซฏๅฃ / ๅฅๅบทๅบฆ / ็ผๅญ / ๆญ่ฏ / ๆฅๅฟ๏ผ๏ผๆฏ้กนๅธฆไฟฎๅคๅปบ่ฎฎ
- ๐ ไผ่ฏๅทๆฐ โ ๆๅไผ่ฏไธ้ฎๆธ
็้่ฟ๏ผ
doRefreshSession๏ผ - ๐ง ่ฏๆญๅทฅๅ ท็ฎฑ UI ๅ็บง โ Doctor ้ขๆฟๆฐๅข summary ็ป่ฎก + ไฟฎๅคๅปบ่ฎฎ + ๅ็บง็ถๆ๏ผpass/warn/fail๏ผ
- ๐ ๅปถ่ฟๆต้ โ ๅๆจกๅๆต้ + ๅ
จ้ๆน้ๆต้๏ผ
speedTest/speedTestAll๏ผ - ๐ Provider CRUD โ ๆฐๅข/็ผ่พ/ๅ ้คๆๅกๅ๏ผ็ผ่พ baseUrl ๅ API Key
- ๐ ๆจกๅๅขๅ โ Provider ๅ ๆทปๅ /็งป้คๆจกๅ
- ๐ ้ข่ฎพๅฟซ้ๆทปๅ โ ๅ ็ฝฎไธปๆต Provider ้ข่ฎพๆจกๆฟ๏ผไธ้ฎๅกซๅ ฅ้ ็ฝฎ
- ๐ MiniMax Speech 2.8 HD โ ๆฐๅข้ซๆธ ่ฏญ้ณๅผๆ้้กน
- ๐ SmartVoice ้ ็ฝฎ็ปไธ โ ็ดๆฅ่ฏป petConfig๏ผไธ็จ้ๅค่ฏปๆไปถ
- ๐ค ๅฎๆด็ desktop-bridge.js โ cleanForTTS + detectEmotion + addTTSPauseMarkers
- ๐ต ๆญ่ฏ TTS ๆ ่ฎฐ่ฟๆปค โ
<#0.3#>ๅ้กฟๆ ่ฎฐไธๆพ็คบๅจๅญๅนไธญ๏ผๅช็ป่ฏญ้ณๅผๆ็จ
- ๐ ๅฎๆด้ ็ฝฎๆ็จ โ CONFIGURATION-GUIDE.md๏ผ863่ก๏ผ๏ผไป้ถๅผๅงๆๆๆๆๅญฆ
- ๐ง ่ฏๆญๅทฅๅ ท็ฎฑ โ ๅ จๆฐ็ฌ็ซ็ชๅฃ๏ผไธ้ฎๆฅ็ Gateway ็ถๆใๆฅๅฟใ่ฟๆฅไฟกๆฏ
- ๐ CMD ๅฑ้ชไฟฎๅค โ ๅ
จ้ขๆทปๅ
windowsHide: true๏ผๅฝปๅบๆถ้ค Windows ๅฝไปค่ก็ชๅฃ้ช็
- ๐ก๏ธ Gateway ้่ฏฏ่ฏๆญ้พ่ทฏ โ ๆ่ท stdout/stderr๏ผๆก้ข้็ฅๆพ็คบๅ ทไฝๅดฉๆบๅๅ
- ๐ ๅฎๅ จๆจกๅๅๆข + ่ชๅจๅๆป โ ๅๆขๅคฑ่ดฅ 5 ็งๅ ่ชๅจๆขๅคไธไธไธชๆจกๅ
- ๐ ไผ่ฏ็ฎก็ๆ็่ๅ โ ๆฅ็ไธไธๆไฝฟ็จ็ใtoken ไผฐ็ฎใไธ้ฎๆธ ็ไผ่ฏ
- ๐ก ่ฏทๆฑ่ฟฝ่ธช็ณป็ป โ ๅบๅ ID + ่ฎกๆถ + ้่ฏฏๅๅฒ(50ๆก) + 30s ่ถ ๆถ่ฏๆญ
- โณ ๅฏๅจๅฎฝ้ๆ โ 60s ๅทๅฏๅจไฟๆค๏ผ้ฒๆญข่ฏฏๅค้ๅฏๅพช็ฏ
- ๐ง ไธไธๆๆ็ฅ โ ไธญ่ฑๆ token ไผฐ็ฎ๏ผๆฅ่ฟ้ๅถๆถๆบ่ฝ่ญฆๅ
ๅฑ ็ถ่ฎฉ OpenClaw ็ป่ชๅทฑๅไบไธช่บซไฝ๏ผ
| ๅนณๅฐ | ๆถๆ | ไธ่ฝฝ้พๆฅ | ๅคงๅฐ |
|---|---|---|---|
| ๐ช Windows | x64 | KKClaw-Desktop-Pet-3.7.0-Setup.exe | ~150MB |
| ๐ macOS | Intel | KKClaw-Desktop-Pet-3.7.0-x64.dmg | ~160MB |
| ๐ macOS | Apple Silicon | KKClaw-Desktop-Pet-3.7.0-arm64.dmg | ~160MB |
ๅปบ่ฎฎๆไธๅฎๆๆฏๅบ็ก็็จๆท็ดๆฅๅ ้ไปๅบ่ฟ่ก๏ผ่้ไธ่ฝฝๅ่ก็ใ
ๅ่ก็ไธบๆๅ ๅฐ่ฃ ็ๆฌ๏ผๅญๅจไปฅไธ้ๅถ๏ผ
- ้จๅ้ ็ฝฎๅทฒ็กฌ็ผ็ ๅจๅ ๅ ๏ผ่ชๅฎไนไฟฎๆน้่ฆ่งฃๅ ๏ผไธ้ๅๆฐๆ
- ๅฐ็ๆฌ็ bug ไฟฎๅคๅๅ่ฝๆดๆฐไธไผๅ็ฌๆจๅ่ก็๏ผๅ ้ไปๅบๅ
git pullๅณๅฏๅๆญฅๆๆฐๆนๅจgit clone https://github.com/kk43994/kkclaw.git cd kkclaw npm install npm startๅ่ก็้ๅๅชๆณๅฟซ้ไฝ้ช็็จๆท๏ผ้ฟๆไฝฟ็จๆจ่ๆบ็ ่ฟ่กใ
npm link
kkclaw gateway # ๆๅผๅธฆๅ็ซฏ้ๆฉๅจ็ KKClaw Gateway ็ป็ซฏ๏ผOpenClaw / Hermes / Auto๏ผ
kkclaw gateway status # ๆฅ็็ฝๅ
ณ็ถๆ / ็ซฏๅฃ / ๅฝๅๅ
ผๅฎนๅ็ซฏ
kkclaw gateway logs # ๆฅ็ Gateway ๆฅๅฟ
kkclaw doctor # ๅไธ่ฝฎ KKClaw ไฝๆฃ
kkclaw dashboard # ๆๅผๅฝๅๅ
ผๅฎนๅ็ซฏ็ Dashboard / API ้ขๆฟ- ไธ่ฝฝ
.exeๅฎ่ฃ ็จๅบ - ๅๅป่ฟ่ก๏ผๅฏ่ฝ้่ฆๅ ่ฎธ"ๆช็ฅๅๅธ่ "๏ผ
- ๆๆ็คบๅฎๆๅฎ่ฃ
- ไธ่ฝฝๅฏนๅบๆถๆ็
.dmgๆไปถ - ๆๅผ DMG๏ผๆๅจๅบ็จๅฐ Applications ๆไปถๅคน
- ้ฆๆฌก่ฟ่ก้่ฆๅจ"็ณป็ปๅๅฅฝ่ฎพ็ฝฎ โ ๅฎๅ จๆงไธ้็ง"ไธญๅ ่ฎธ
ๆณจๆ๏ผmacOS ็ๆฌๆช็ญพๅ๏ผ้ฆๆฌก่ฟ่ก้่ฆๅณ้ฎ็นๅป โ "ๆๅผ"
ไธฐๅฏ็ๆ ็ปช็ถๆ โ 14็ง้ข่ฒ ร 38็ง่กจๆ = ่ถ ่ช็ถ็ๆ ๆ่กจ่พพ
|
67px ็็็ไฝ
|
SVGๅพๆ ๅทฅๅ ทๆ
|
ๆบ่ฝๅฏน่ฏ + ๆไปถๆไฝ โ ๅฏไปฅไธๆก้ขๅพๆ ใๆไปถ่ฟ่ก่ช็ถ่ฏญ่จไบคไบ
็คบไพ๏ผKK่ฆๅคๅถๅพๆ ๆไปถ๏ผ็ดๆฅ็จ็บขๆกๆ ่ฎฐๅพๆ ๏ผ็จ้ฃไนฆ่ฏญ้ณๅๅปบๅฟซๆทๆนๅผ
่ฎพ่ฎก็ๅฟต๏ผๅๆก้ขๆญ่ฏไธๆ ท๏ผไธๅฆจ็ขๆไฝ๏ผๅดๅง็ป้ชไผดใ
- 67px ๆตไฝ็ป็็ โ 3ๅฑๅพๅๆธๅ + ๅ้้ซๅ + ๅ ๅคๅๅ
- ่ถๅๅฝข็ผ็ (11ร19px) โ 15+็ง่กจๆ ๏ผSVG็ข้
- SVGๅพๆ ๅทฅๅ ทๆ โ ๐ฌ่ๅคฉ / ๐ธๆชๅพ / ๐ค่ฏญ้ณ๏ผhoverๅฑๅผ
- ๅฎๅ
จ้ผ ๆ ็ฉฟ้ โ
setIgnoreMouseEvents๏ผไธๆกๆไฝ - ็ฝๅญๆ่พน โ
text-shadow8้ๅ ๅ ๏ผไปปไฝ่ๆฏๅฏ่ง - ๆๅญๆบๆๆ โ ้ๅญๅบ็ฐ๏ผๆฏๆemoji๏ผ่ชๅจๆข่ก
- ๆๅจ็ฒพ็ต็ชๅฃ โ ๆญ่ฏ็ชๅฃ่ชๅจ่ท้
- IPCไบไปถ
drag-petๅ็ชๅฃๅฎๆถๅๆญฅ
- ๅ
้้ณ่ฒ โ ๅฐๅขๅขๅฏผ่ช้ณ๏ผ
xiaotuantuan_minimax๏ผ - 7็งๆ ๆ โ happy, sad, angry, fearful, disgusted, surprised, calm
- ๅ้กฟๆงๅถ โ
<#0.5#>ๅจๆๆฌไธญๆๅ ฅ่ช็ถๅ้กฟ - ่ดน็จ โ 2ๅ /ไธๅญ็ฌฆ๏ผๅ ้่ดน9.9ๅ /้ณ่ฒ๏ผไธๆฌกๆง๏ผ
่ชๅจๆ ๆ่ฏๅซ๏ผ
// smart-voice.js ๆ นๆฎๆๆฌๅ
ๅฎน่ชๅจ้ๆฉemotion
"ๅคชๆฃไบ๏ผ" โ happy
"ๅคฑ่ดฅไบ..." โ sad
"ไปไน๏ผ๏ผ" โ surprised- MiniMax โ 2ๅ /ไธๅญ็ฌฆ๏ผ้ซ่ดจ้
- CosyVoice โ DashScope API๏ผไธญ็ญ่ดจ้
- Edge TTS โ ๅ ่ดนๆฌๅฐ๏ผๅบ็ก่ดจ้
3็งๅๆขAIๆจกๅ๏ผ้ถ้ๅฏ๏ผ้ถไธญๆญ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ KKClaw Switch โ โ โ Auto Monitor โ โ โ OpenClaw โ
โ (็นๅปๅๆข) โ โ (ๆฏ2็งๆฃๆต) โ โ (่ชๅจ้ๅฏ) โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ โ โ
ๅๆขProvider ่ฏปๅDBๅๅ ๅๆญฅconfig โ restart
โ ่ชๅจๅๆญฅ็ๅฌๅจ โ ้ๆๅฐๆก้ขๅฎ ็ฉ็ๅฝๅจๆ
- ๅฏๅจๆถ่ชๅจๅผๅฏ
kkclaw-auto-sync.js - ๅ ณ้ญๆถ่ชๅจๅๆญข
- ๆฏ2็งๆฃๆต
~/.cc-switch/cc-switch.db
โ ๆๅจๅๆญฅ ๏ผๅฏ้๏ผ
node kkclaw-hotswitch.js # ๅๆญฅๅฝๅprovider
node kkclaw-hotswitch.js --restart # ๅๆญฅ + ้ๅฏGatewayโ ๆ ็ผๅๆข
- Claude Opus 4 โ GPT-5.3 โ Gemini Pro
- 3็งๅ ็ๆ
- ไธไธญๆญๅฏน่ฏไธไธๆ
| ่กจๆ | ๅๆฐ | ๆๆ |
|---|---|---|
| normal | 11ร19px | ๆญฃๅธธ็ถๆ |
| blink | 12ร3px | ็จ็ผ |
| happy | 13ร7px, br:7px 7px 3px 3px | ๅผๅฟๅผฏ็ผ |
| surprised | 13ร21px | ๆ่ฎถ็ชๅคง |
| thinking | 10ร17px, ty:-3px | ๆ่็ฏ็ผ |
| sleepy | 12ร4px, ty:2px | ๅฐไบๅ้ญ |
| sparkle | 12ร12px, rot:45deg | ๆๆ็ผ |
| wink | ๅทฆ13ร7px, ๅณ11ร19px | ๅ็ผ็จ |
| love | 14ร13px, br:7px 1px, rot:45deg | ็ฑๅฟ็ผ |
| angry | 12ร14px, rot:ยฑ12deg | ็ๆฐ็ฑ็ |
| dizzy | 10ร10px, rot:ยฑ25deg | ๅคดๆๆ่ฝฌ |
| cross | 10ร3px, rot:ยฑ30deg | X็ผ๏ผ่ฃ ๆญป๏ผ |
็ฑปๅๅๅธ๏ผ
- ๐ ็ผ็ๅจ็ป (14ไธช) โ ๅทฆๅณ็ใไธไธ็ใ็จ็ผใๆญชๅคด
- ๐ ่กจๆ ็ปๅ (12ไธช) โ ๅผๅฟโๆ่ฎถใๆ่โ้ชไบฎใๅฐโๆ้
- ๐ ๆ ๆ่กจ่พพ (6ไธช) โ ๅฎณ็พ่ธ็บขใ็ฑๅฟ็ผใ็ๆฐ่ทบ่
- ๐ญ ๅคๆๅบๅ (6ไธช) โ ็ฏ้กพๅๅจใๅผๅฟ่นฆ่ทถใ่ฃ ๆญปๅคๆดป
่งฆๅๆบๅถ๏ผ
setInterval(() => {
if (currentMood === 'idle' && Math.random() < 0.3) {
// 30%ๆฆ็่งฆๅ
idleActs[Math.floor(Math.random() * 38)]();
}
}, 4000); // ๆฏ4็งๆฃๆฅไธๆฌกโโ 1. ๅ
้จๆตไฝๅฑ โโโโโโโโโโโโโโโโโ
โ - blob1: 20ร20px ๅๅฝข โ
โ - blob2: 30ร30px ๆคญๅ โ
โ - ไธๅ้ๅบฆๅจ็ป๏ผ20s / 25s๏ผ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโ 2. ็ป็ๅคๅฃณ โโโโโโโโโโโโโโโโโโโ
โ - 3ๅฑๅพๅๆธๅ โ
โ - ไธป้ซๅ
(35% 18%) โ
โ - ๅฏ้ซๅ
(20% 12%) โ
โ - 1.5px border ๅ้ๆ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโ 3. ๅค้จๅๅ
โโโโโโโโโโโโโโโโโโโ
โ - box-shadow ๅ
ๅคๅๅฑ โ
โ - ๆ นๆฎmood้ข่ฒๅจๆๅๅ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
1็งๅนณๆปๆธๅ โ ๅจๆ @keyframes ็ๆ
// ๆฏๆฌกๅๆขmoodๆถๅจๆๅๅปบ่ฟๆธกๅจ็ป
function createColorTransition(fromColor, toColor) {
const keyframes = `
@keyframes colorShift-${Date.now()} {
from { background: ${fromColor}; }
to { background: ${toColor}; }
}
`;
// ไธๅฑ็ฌ็ซๅจ็ป๏ผ0.8s / 1.0s / 1.2s
}- Electron่ฟ็จๅดฉๆบ โ 5็งๅ่ชๅจ้ๅฏ
- OpenClaw Gatewayๆๆ โ 30็งๅ่ชๅจ้ๅฏ
- ็ณป็ป่ตๆบ่ๅฐฝ โ ๅ ๅญๆธ ็ + ้ๅฏ
- ๆฏๆฅ่ฝฎ่ฝฌ โ ไฟ็ๆ่ฟ7ๅคฉๆฅๅฟ
- ๅคงๅฐ้ๅถ โ ๅๆไปถ10MB๏ผ่ถ ่ฟ่ชๅจๅฝๆกฃ
- ๅ็บง่ฎฐๅฝ โ INFO / WARN / ERROR
- ่ชๅจๆธ ็ โ ๆฏ24ๅฐๆถๆธ ็ไธดๆถๆไปถ
- ๆบ่ฝๅ็ผฉ โ ๆงๆฅๅฟ่ชๅจๅ็ผฉไธบ
.gz
- CPUไฝฟ็จ็ โ ่ถ ่ฟ80%ๅ่ญฆ
- ๅ ๅญไฝฟ็จ โ ่ถ ่ฟ500MBๅ่ญฆ
- FPS็ๆง โ ไฝไบ30fpsๅ่ญฆ
๐ ๅฎๆด้ ็ฝฎๆ็จ่ฏท็ โ CONFIGURATION-GUIDE.md
ไป็ฏๅขๅๅคๅฐ่ฏญ้ณ้ ็ฝฎๅฐ้ฃไนฆๆฅๅ ฅ๏ผไธๆญฅๆญฅๆๆๆๆๅญฆ๏ผๅฐ็ฝไน่ฝ็ๆ๏ผ
- Node.js โฅ 18.x (ไธ่ฝฝ)
- Windows 10/11 ๆ macOS 10.15+
- OpenClaw โฅ 2026.x ๆ Hermes Agent๏ผๅปบ่ฎฎๆๆฐ็ๆฌ๏ผ(OpenClaw | Hermes)
npx clawhub@latest install kk43994/desktop-petgit clone https://github.com/kk43994/kkclaw.git
cd kkclaw
npm install
npm start๐ง v3.0 ๆฐๅข Setup Wizard๏ผ ้ฆๆฌกๅฏๅจไผ่ชๅจๅผนๅบ้ ็ฝฎๅๅฏผ๏ผ่ท็ๅผๅฏผ่ตฐๅณๅฏๅฎๆๅ จ้จ่ฎพ็ฝฎใ
ๅฆ้ๆๅจ้ ็ฝฎ๏ผๅ่ไปฅไธๆญฅ้ชค๏ผ
-
ๅคๅถ้ ็ฝฎๆจกๆฟ
cp pet-config.example.json pet-config.json
-
็ผ่พ
pet-config.json{ "openclaw": { "gateway": "http://localhost:3000" }, "voice": { "engine": "minimax", "minimax": { "apiKey": "sk-api--ไฝ ็ๅฏ้ฅ", "groupId": "ไฝ ็GroupID", "voiceId": "xiaotuantuan_minimax" } } } -
ๅฏๅจๅบ็จ
npm start
- ๐ ๅฎๆด้ ็ฝฎๆ็จ โ โญ ๆฐๆๅฟ ็๏ผไป้ถๅผๅง้ ็ฝฎ
- ๐ ้กน็ฎ็ปๆ โ ็ฎๅฝ็ป็ปใๅฝๅ่ง่
- ๐๏ธ ๆบ่ฝ่ฏญ้ณ็ณป็ป โ ไธ็บง้็บงใๆ ๆ่ฏๅซ
- ๐ KKClaw Switch โ ๆจกๅ็ญๅๆข้ ็ฝฎ
- ๐ธ ๆชๅพๅ่ฝ โ ๅฟซๆท้ฎใ่ชๅจไธไผ
- ๐ง ๅผๅๆๅ โ ๅผๅ็ฏๅขใ่ฐ่ฏ
- ๐ฅ ๅจ็บฟๆผ็คบ โ ๅฏไบคไบ็็ไฝdemo
- ๐ฆ ClawHubไธป้กต โ ๅฝ้ ็คพๅบ
- ๐ฆ OpenClaw-CN โ ไธญๆ็คพๅบๆ่ฝๅธๅบ
{
"openclaw": {
"gateway": "http://localhost:3000",
"sessionKey": "main",
"checkInterval": 2000
},
"window": {
"position": { "x": 100, "y": 100 },
"alwaysOnTop": true,
"opacity": 1.0
}
}{
"voice": {
"engine": "minimax",
"minimax": {
"apiKey": "sk-api--xxxxx",
"groupId": "2020139946483921771",
"voiceId": "xiaotuantuan_minimax",
"model": "speech-2.5-turbo-preview",
"speed": 1.1,
"vol": 3.0,
"emotion": "happy"
}
}
}{
"voice": {
"engine": "dashscope",
"dashscope": {
"apiKey": "sk-xxxxxxxxxx",
"model": "cosyvoice-v3-plus",
"voice": "cosyvoice-v3-plus-tuantuan-xxx"
}
}
}ไธ้ข่ฟไธๆญฅๅชๆฏๆ TTS ๆๅก้ ็ฝฎๅฅฝ๏ผๅฎๅนถไธ็ญไบ AI ๅๅคๆถไธๅฎไผ่ชๅจๆญๆฅใ็ๆญฃ่ฝๅฌๅฐๅฃฐ้ณ๏ผ่ฟ่ฆๅๆถๆปก่ถณไธ้ข 3 ๅฑ๏ผ
- TTS ๆๅกๆฌ่บซๅฏ็จ
desktop-bridge.jsๅทฒ็ๆ๏ผๅนถไธ่ฝๅจๅฝๅ workspace ๆญฃๅธธๆง่ก- ๅฝๅ agent / ๆจกๅ็็้ตๅพช
AGENTS.md๏ผๅจๆฏๆฌกๅๅคๅไธปๅจๆง่ก๏ผnode desktop-bridge.js agent-response "่ฆๆญๆฅ็ๅ ๅฎน"
ๅฆๆไฝ ๅทฒ็ป้ ๅฅฝไบ TTS๏ผไฝ AI ๅๅค่ฟๆฏๅฎๅ จๆฒกๆๅฃฐ้ณ๏ผไผๅ ๆ็็ๅฐฑไธๅชๆฏ้ ็ฝฎ้ฎ้ข๏ผไนๅฏ่ฝๆฏๅฝๅ agent ๆ นๆฌๆฒกๆ่งฆๅ bridgeใ
ๆก้ขๅฎ ็ฉไผ่ชๅจ้ๆ๏ผๆ ้้ขๅค้ ็ฝฎใ
ๅฆ้ๆๅจๅๆญฅ๏ผ
# ๅๆญฅๅฝๅproviderๅฐOpenClaw
node kkclaw-hotswitch.js
# ๅๆญฅๅนถ้ๅฏGateway
node kkclaw-hotswitch.js --restartdesktop-pet/
โโโ main.js # Electronไธป่ฟ็จ
โโโ index.html # ็ฒพ็ต็ชๅฃUI
โโโ lyrics.html # ๆญ่ฏ็ชๅฃUI
โโโ setup-wizard.html # ๐ง Setup Wizard UI๏ผRPG้ฃๆ ผ๏ผ
โโโ setup-wizard.js # ๐ง Setup Wizard ๅ็ซฏ้ป่พ
โโโ setup-preload.js # ๐ง Wizard IPC ๅฎๅ
จๆกฅๆฅ
โโโ smart-voice.js # ๆบ่ฝ่ฏญ้ณ่ฐๅบฆ
โโโ pet-config.js # ๐ ้
็ฝฎ็ฎก็๏ผๅซ safeStorage ๅ ๅฏ๏ผ
โโโ voice/ # TTSๅผๆ็ฎๅฝ
โ โโโ minimax-tts.js
โ โโโ dashscope-tts.js
โ โโโ cosyvoice-tts.py
โโโ templates/ # ๐ง ๅๅฏผๆจกๆฟๆไปถ
โ โโโ desktop-bridge.js # ่ฏญ้ณๆญๆฅๆกฅๆฅๆจกๆฟ
โโโ utils/ # ่พ
ๅฉๅทฅๅ
ท็ฎๅฝ
โโโ scripts/ # ๅทฅๅ
ท่ๆฌ
โโโ tests/ # ๆต่ฏๆไปถ
โโโ docs-dev/ # ๅผๅๆๆกฃ
โโโ archive/ # ๅฝๆกฃๆง็ๆฌ
npm start # ๅฏๅจๅบ็จ
npm run dev # ๅผๅๆจกๅผ๏ผ็ญ้่ฝฝ๏ผ
npm run console # ๆๅผ็ณป็ป็ป็ซฏๅนถ่ฟ่ก npm start
npm test # ่ฟ่กๆต่ฏ
npm run build # ๆๅปบๅๅธ็-
ๅผๅฏElectron DevTools
- ไธป็ชๅฃ๏ผ
Ctrl + Shift + I - ๆไฟฎๆน
main.jsๆทปๅmainWindow.webContents.openDevTools()
- ไธป็ชๅฃ๏ผ
-
ๆฅ็ๆฅๅฟ
# ๅฎๆถๆฅๅฟ tail -f logs/app.log # ้่ฏฏๆฅๅฟ tail -f logs/error.log
ๆฌข่ฟ่ดก็ฎไปฃ็ ใๆฅๅBugใๆๅบๅปบ่ฎฎ๏ผ
- Fork ๆฌไปๅบ
- ๅๅปบๅๆฏ
git checkout -b feature/ๆฐๅ่ฝ - ๆไบคๆดๆน
git commit -m 'Add: ๆฐๅ่ฝๆ่ฟฐ' - ๆจ้ๅๆฏ
git push origin feature/ๆฐๅ่ฝ - ๆไบค Pull Request
- ไฝฟ็จ kebab-case ๅฝๅๆไปถ
- ๆทปๅ ่ฏฆ็ปๆณจ้
- ้ตๅพช ESLint ่งๅ
- ๆต่ฏ่ฆ็ ๆ ธๅฟๅ่ฝ
ๅๅ ๏ผ็ชๅฃไฝ็ฝฎ่ถ
ๅบๅฑๅน
่งฃๅณ๏ผๅ ้ค pet-config.json ไธญ็ window.position๏ผ้ๅฏๅบ็จ
ๅฏ่ฝๅๅ ๏ผ
- APIๅฏ้ฅๆ ๆๆ้ ็ฝฎ้่ฏฏ
desktop-bridge.jsๆฒก็ๆใ่ทฏๅพไธๅฏน๏ผๆ่ ๅฝๅ workspace ไธไธๅฏๆง่ก- ๅฝๅ agent / ๆจกๅๆฒกๆ้ตๅพช
AGENTS.md๏ผๆ นๆฌๆฒกๆๅจๅๅคๅ่งฆๅdesktop-bridge.js
่งฃๅณ๏ผ
# ๆฃๆฅ้
็ฝฎ
node -e "console.log(require('./pet-config.json').voice)"
# ๆต่ฏMiniMax API
node voice/minimax-tts.js
# ๆๅจๆต่ฏ bridge -> ๆก้ข็ซฏๆญๆฅ้พ่ทฏ
node desktop-bridge.js agent-response "่ฟๆฏไธๆฌก README ๆ้ๆต่ฏๆญๆฅ"ๆ้ๅคๆญๆๅทง๏ผ
- ๅฆๆๆๅจๆง่ก
desktop-bridge.js่ฝๆญๆฅ๏ผ่ฏดๆ TTS / bridge ๅบๆฌๆญฃๅธธ๏ผ้ฎ้ขๆดๅฏ่ฝๅบๅจ agent ๆฒกๆๆง่กๆญๆฅๅฝไปค - ๅฆๆๆๅจๆง่กไนๆฒกๆๅฃฐ้ณ๏ผๅไผๅ ๆๆฅ TTS ้ ็ฝฎใbridge ๆไปถไฝ็ฝฎๅ่ฟ่ก็ฏๅข
ๅๅ ๏ผGatewayๆชๅฏๅจๆ็ซฏๅฃ้่ฏฏ ่งฃๅณ๏ผ
# ๆฃๆฅOpenClaw็ถๆ
openclaw status
# ๅฏๅจGateway
openclaw gateway startๅๅ ๏ผ
~/.cc-switch/cc-switch.dbไธๅญๅจ- ่ชๅจ็ๅฌๅจๆชๅฏๅจ
่งฃๅณ๏ผ
# ๆฃๆฅDBๆไปถ
ls ~/.cc-switch/cc-switch.db
# ๆๅจๅๆญฅ
node kkclaw-hotswitch.js --restart| ๆๆ | ็ฎๆ | ๅฎๆต |
|---|---|---|
| ๅฏๅจๆถ้ด | <3็ง | 2.1็ง |
| ๅ ๅญๅ ็จ | <200MB | 147MB |
| CPUๅ ็จ | <5% | 2.8% |
| ๅธง็ | โฅ60fps | 60fps |
| ่ฏญ้ณๅปถ่ฟ | <500ms | 320ms |
ๆต่ฏ็ฏๅข๏ผWindows 11, i7-12700K, 32GB RAM
- ๆฐๅข Hermes ๅ
ผๅฎนๅ็ซฏ๏ผๆฏๆ
KKCLAW_COMPAT_MODE็ฏๅขๅ้ๅpet-config.json.compatMode้ ็ฝฎ kkclaw gateway/npm startๆฐๅข OpenClaw / Hermes / Auto ้ๆฉๅผๅฏๅจ๏ผๅนถ่ฎฐไฝไธๆฌก้ๆฉ- ๅฆๆ Hermes Gateway ๅทฒๅจๅค้จ่ฟ่ก๏ผKKClaw ไผ่ฏๅซๅนถๅค็จ๏ผไธๅ่ฏฏๆฅ็ซฏๅฃๅฒ็ช
kkclaw status/kkclaw doctor/kkclaw gateway status็ฐๅจไผๆพ็คบๅฝๅๅ ผๅฎนๅ็ซฏใCLI ่ทฏๅพใๆขๆดปๆนๅผใๆฅๅฟ่ทฏๅพใAPI Server ็ถๆ- ๅฏๅจ Banner ๅ Ready Banner ๆนไธบๅ็ซฏๆ็ฅ๏ผOpenClaw ไธบ็บข่ฒไธป้ข๏ผHermes ไธบ้ฆๆง้ไธป้ข
kkclaw dashboardไธไธป่ฟ็จ็ฝๅ ณ้ ็ฝฎไผ่ชๅจๅๆขๅฐๅฝๅๅ ผๅฎนๅ็ซฏ
- ๆฐๅขๅ็ซฏ้ๆฉๅฏๅจๅจใHermes ๅ ผๅฎนๆจกๅผใๅค้จ Hermes Service ๅค็จ็ธๅ ณๆต่ฏ
- README ๅ่ฏญ้ณๅผๅๆๆกฃ่กฅๅ ไบ AI ๅๅค่ฏญ้ณๆญๆฅ็็ๅฎ่งฆๅ้พ่ทฏ่ฏดๆ
- ๆฐๅข
kkclawๅฝไปคๅ ฅๅฃ๏ผๆฏๆkkclaw gateway kkclaw gateway/kkclaw gateway start็ดๆฅๆๅผๅธฆๅผๅบๅจ็ป็็ป็ซฏ๏ผๅฝๅnpm startไฝ้ช๏ผ- ๆฐๅข
kkclaw gateway status / logs / open / restart / stop - ๆฐๅข
kkclaw doctorๅ้กถๅฑkkclaw status
kkclaw doctorๅขๅ Gateway ownership ๆฃๆฅ๏ผ่ฝๅ็ฐ็ซฏๅฃ่ขซๆง่ฟ็จๆๅค้จๅฎไพๅ ็จkkclaw gateway statusๅขๅ Dashboard ๅฐๅใๆฅๅฟ่ทฏๅพใOpenClaw CLI ็ๆฌๅ่ฟ็จๆ่ฆkkclaw gateway logsๆฏๆๆฅ็ๆ ๅๆฅๅฟ / ้่ฏฏๆฅๅฟๅนถ่ฎพ็ฝฎ tail ่กๆฐ
- โก ็ฏๅขๆฃๆต้กตๆฐๅขๆ้ฎ โ ่ชๅจๅฎ่ฃ edge-tts / sqlite3 / node_modules๏ผๅฎๆถ่ฟๅบฆๅ้ฆ
- ๐ง ่ทจๅนณๅฐๅฎ่ฃ โ Windows (winget/choco)ใmacOS (brew)ใLinux (apt/yum)
- ไฟฎๅค Setup Wizard ็ฝๅฑ โ 3 ๅคๅฝๆฐๅฃฐๆ็ผบๅคฑๅฏผ่ด SyntaxError
- Wizard ้่ฏฏๅฏ่งๅ โ ๆธฒๆๅบ้ๆถๆพ็คบๅ ทไฝๆฅ้
- sqlite3 ไพ่ต่ฏดๆไผๅ โ ๆ ๆณจ
(CC-Switch ๅๆญฅ)็จ้
- ไฟฎๅคๅๅฃฐ้ณ้ฎ้ข โ ๆๆ
new Notification()ๆทปๅsilent: true - ไฟฎๅคๆก้ขๅฟซๆทๆนๅผไธๆพ็คบ CMD โ ๆๅ
start.cmd๏ผWindowStyle 1 - ็งป้ค
speak()ไธดๆถ่ฐ่ฏๆฅๅฟ
- ๐ color-log.js โ ไธญๅฟๅ ANSI ้ข่ฒๆจกๅ๏ผ็ปไธ้ข่ฒๅธธ้ + ่ชๅจ้ซไบฎๅฝๆฐ
- โจ ๅ
จ้ข่ฟ็งป โ 12+ ๆจกๅๅฏๅจๆฅๅฟ่ฟ็งปๅฐ
colorLog()/kvLog()/tagLog() - โจ Gateway ๆฅๅฟ้ซไบฎๅขๅผบ โ ๆจกๅๅใURLใ่ทฏๅพใๆธ ้ใ@botnameใkey=valueใ็ซฏๅฃๅทใๅ่ฎฎใ้่ฏฏ/ๆๅ/่ญฆๅ ๅ จๅฝฉ้ซไบฎ
- ๐ ้ฆๆฌกๅฏๅจไธปๅจๆ่ตท โ ่ฟ็ปญ 3 ๆฌกๆฃๆตไธๅฐ Gateway ๅ่ชๅจ
startGateway()๏ผไธๅๆฐธ่ฟ็ญๅพ - ๐ ๅฏๅจ็ถๆ่ฏญ้ณๆญๆฅ โ ๅฏๅจไธญ/ๆๅ/ๅคฑ่ดฅ ๅๅซ่ฏญ้ณ้็ฅ
- ๐ง ไบๆฌก็กฎ่ฎค้ฒ่ฏฏๅค โ ไธ ServiceManager ไบคๅๆ ก้ช
- ๐ง ไฟฎๅค Gateway ๆฅๅฟ้ๅค โ ๆ นๅ ๏ผ
log()ไบๆฌกๆๅฐ๏ผgateway-std* ่ทณ่ฟๆงๅถๅฐ่พๅบ - ๐ง stderr ๆบ่ฝ่ฟๆปค โ ไป ๆพ็คบ error/fatal/panic/exception
- ๐ง ็ฉบ็ฝๅฝไธๅๅป้ โ
\s+โ' 'ๅฝไธๅๅ Set ๅป้
- ๐ ่ชๅจๅๅปบ .lnk โ ้ฆๆฌกๅฏๅจ่ชๅจๅจๆก้ขๅๅปบ"Claw ๆก้ขๅฎ ็ฉ"ๅฟซๆทๆนๅผ
- ๐ง PowerShell COM โ WScript.Shell ๅๅปบๅฟซๆทๆนๅผ
- ๐๏ธ ่ฏญ้ณๆญๆฅ โ ๅๅปบๆๅๅๆญๆฅ
- ไฟฎๅค่ฏญ้ณๅๅ๏ผ็งป้ค messageSync ้ๅค speak๏ผ
- ไฟฎๅค้็ฅๆฅๅฟ้ๅค๏ผdesktop-notifier ๅชๆๅฐ็ฑปๅ๏ผ
- DashScope TTS ๅผๆ็งป้ค๏ผ้็บง้พ็ฎๅไธบ MiniMax โ Edge TTS
- ๐ง ๅฝไปคๆณจๅ
ฅไฟฎๅค โ
_playAudioFile()/_playAudio()/speakWithEdgeTTS()ๅ จ้จไปexec()shell ๆผๆฅๆนไธบexecFile()/spawn()+ ๅๆฐๆฐ็ป - ๐ง Edge TTS ๆๆฌๆณจๅ
ฅไฟฎๅค โ ๆๆฌ้่ฟไธดๆถๆไปถ
--text-fileไผ ๅ ฅ๏ผไธๅ inline--textๆผๆฅ - ๐ง stop() ็ๆญฃๅๆญขๆญๆพ โ ่ท่ธชๅฝๅๆญๆพ่ฟ็จๅผ็จ๏ผ
stop()ๆถ.kill()็ปๆญข - โจ Token ๅจๆ่ฏปๅ โ
openclaw-client.jsไธๅๆจกๅๅ ่ฝฝๆถ็ผๅญ token๏ผๆน็จSecureStorage+configManagerๅจๆ่ทๅ - โจ IPC ๆ ก้ชๆจกๅ โ ๆฐๅข
ipc-validator.js๏ผๆธ ้็ฝๅๅๆ ก้ช - โจ ๆฅๅฟ่ฑๆ โ ๆฐๅข
log-sanitizer.js๏ผ้ฒๆญขๆๆไฟกๆฏๅๅ ฅๆฅๅฟ
- โจ ๆจกๅ็ญๅๆข็ถๆๆบ โ
model-switch-state-machine.js๏ผ็ถๆ้ฉฑๅจ็ๅๆขๆต็จ - โจ ๅๆข็ญ็ฅๆจกๅผ โ
model-switch-strategies.js๏ผๅฏๆฉๅฑ็ๅๆข็ญ็ฅ - โจ ๅๆขๅๅฒ่ฎฐๅฝ โ
switch-history.js๏ผ่ฟฝ่ธชๆจกๅๅๆข่ฝจ่ฟน - โจ ้ขๅบฆๆฅ่ฏข โ
quota-query.js๏ผๆฅ่ฏข API ไฝ้ข - โจ CC Switch ๅๆญฅ โ
cc-switch-sync.js๏ผClaude Code ๆจกๅๅๆญฅๅๆข
- โจ ๅผๅธธๆฃๆตๅจ โ
gateway-anomaly-detector.js๏ผ่ชๅจ่ฏๅซๅผๅธธๆจกๅผ - โจ ๅฅๅบท่ฏๅ โ
gateway-health-scorer.js๏ผๅค็ปดๅบฆๅฅๅบทๅบฆ้ๅ - โจ ๆๆ ้้ๅจ โ
gateway-metrics-collector.js๏ผๅฎๆถ้้ Gateway ๆๆ - โจ ๆบ่ฝๆฃๆตๅจ โ
gateway-smart-detector.js๏ผๆบ่ฝๆ ้่ฏๆญ
- โจ ่ทฏๅพ่งฃๆๅจ โ
openclaw-path-resolver.js๏ผๆถ้ค็กฌ็ผ็ ่ทฏๅพ - โจ ๅฎๅ
จ้
็ฝฎๅ ่ฝฝ โ
safe-config-loader.js๏ผๅธฆๆ ก้ช็้ ็ฝฎ่ฏปๅ - โจ ๅฎๅ
จๅญๅจ โ
secure-storage.js๏ผtoken ๅฎๅ จ็ฎก็ - โจ ไผ่ฏ้็ฎก็ๅจ โ
session-lock-manager.js๏ผๅนถๅๅฎๅ จ็ไผ่ฏๆไฝ - โจ ้
็ฝฎ็ฎก็ๅจ โ
config-manager.js+config-writer.js๏ผ็ปไธ้ ็ฝฎ่ฏปๅ - โจ Setup Wizard ็ฌ็ซ preload โ
setup-preload.js๏ผๆๅฐๅๆ้ๆด้ฒ - โจ Model Settings ๅ็ฆป โ CSS/JS ไป HTML ไธญ็ฌ็ซไธบ
model-settings.css+model-settings.js
- โจ RPG ๆธธๆ้ฃๆ ผๅผๅฏผ็้ข โ ๆจ่ดจ่พนๆก + ็พ็ฎ็บธ่ๆฏ + ้พ่พๅๅฏผ + ๆๅญๆบๆๅญๆๆ
- โจ 7 ๆญฅๅผๅฏผๆต็จ โ Gateway ่ฟๆฅ โ AI ๆจกๅ โ ๆถๆฏๆธ ้ โ TTS ๅผๆ โ Agent ่ฏญ้ณ โ ๆพ็คบ โ ๅ จ้พ่ทฏๆต่ฏ
- โจ ไธ้ฎ้ณ่ฒๅ ้ โ ๆๆฝไธไผ ๅฝ้ณๆไปถ๏ผ่ชๅจ่ฐ็จ MiniMax / CosyVoice API ๅ ้้ณ่ฒ
- โจ ไบบ่ฎพๅฎๅถ็ณป็ป โ ๅฎ ็ฉๆต็งฐ + ็จๆท็งฐๅผ + 5 ็ง่ฏด่ฏ้ฃๆ ผ้ข่ฎพ๏ผ็ๅฆน/ไธไธ/ๅนฝ้ป/้ ทๅธ /่ชๅฎไน๏ผ
- โจ ๅ
จๅฅ Agent ้
็ฝฎๆไปถ่ชๅจ็ๆ๏ผ
AGENTS.mdโ ๅฎๆดๅทฅไฝๆๅ๏ผ่ฎฐๅฟ็ณป็ป + ๅฎๅ จ่งๅ + ็พค่่งๅ + ๅฟ่ทณๆฃๆฅ + ่ฏญ้ณๆญๆฅ่งๅ๏ผSOUL.mdโ Agent ไบบ่ฎพๆไปถ๏ผๆ นๆฎ้ๆฉ็้ฃๆ ผ่ชๅจ็ๆ๏ผUSER.mdโ ็จๆทไฟกๆฏๆกๆถHEARTBEAT.mdโ ๅฟ่ทณๆฃๆฅ้ ็ฝฎdesktop-bridge.jsโ ่ฏญ้ณๆญๆฅๆกฅๆฅ่ๆฌ๏ผๅฎๆด็๏ผๅซ cleanForTTS + detectEmotion + addTTSPauseMarkers๏ผ
- โจ ่ฏญ้ณๆญๆฅๆฏๅฆไฝ่งฆๅ็๏ผ
- ็ฌฌ 1 ๅฑ๏ผTTS ๅผๆๆฌ่บซ่ฆๅฏ็จ๏ผMiniMax / Edge TTS / ๅ ถไป้็บง้พๆญฃๅธธ๏ผ
- ็ฌฌ 2 ๅฑ๏ผ
desktop-bridge.js่ฆๅทฒ็ป็ๆ๏ผๅนถไธๅจๅฝๅ workspace ้ๅฏๆง่ก - ็ฌฌ 3 ๅฑ๏ผagent / ๆจกๅๅฟ
้กป็็้ตๅพช
AGENTS.md๏ผๅจๆฏๆฌกๅๅคๅไธปๅจๆง่ก๏ผnode desktop-bridge.js agent-response "่ฆๆญๆฅ็ๅ ๅฎน" - ๅฐไบ็ฌฌ 3 ๅฑๆถ๏ผๅชๆ TTS ้ ็ฝฎๅฎๅ จๆญฃ็กฎ๏ผไนๅฏ่ฝไธๅฃฐไธๅใ
- โจ 7 ้กนๅ จ้พ่ทฏๆต่ฏ โ Gateway / AIๆจกๅ / TTSๅผๆ / ่ฏญ้ณๆญๆฅ / ๆก้ขๆญ่ฏ / Agent้ ็ฝฎๆไปถ / ่ชๅฎไน้ณ่ฒ
- โจ ๆจกๅๅ ผๅฎนๆงๆ็คบ โ ๆณจๆไธๅๆจกๅ็ๆไปค้ตๅพชๅบฆๅทฎๅผ๏ผๆจ่ Claude Sonnet 4+
- โจ preload ๅฎๅ จ็ฝๅๅ โ ๆๆ IPC ้้็ป็ฝๅๅๆ ก้ช๏ผ้ฒๆญขๆถๆ่ฐ็จ
- โจ 14 ็งๆ ็ปช่ฒ็ณป โ ๅๆ 7 ็ง + ๆฐๅข sad(ๅคฉ่)ใangry(็็ฐ็บข)ใfearful(็ดซ็ฝๅ ฐ)ใcalm(่่ท้)ใexcited(็ญ็ฒ)ใlove(็็)ใfocused(้่)
- โจ ๅจๆๅคๅๅ (glow) โ ๆฏ็งๆ ็ปชๆไธๅฑๅคๅๅ ๆๆ
- โจ 10 ็งๆๆฌๆ ็ปชๆฃๆต่งๅ โ ่ชๅจๅๆๅ ๅฎนๆ ็ปช๏ผthinking โ surprised โ fearful โ sad โ angry โ calm โ excited โ happy
- โจ API Key ๅ ๅฏๅญๅจ โ ไฝฟ็จ Electron
safeStorageๅ ๅฏ MiniMax/DashScope ๅฏ้ฅ๏ผ็ฃ็ไธไธๅๆๆ - โจ preload ๅฎๅ
จๆฒ็ฎฑ โ ๆฐๅข
preload.js๏ผไธป็ชๅฃ/ๆญ่ฏ/่ฏๆญ/ๆจกๅ่ฎพ็ฝฎๅ จ้จ่ตฐ IPC ็ฝๅๅๆ ก้ช - โจ ๆญ่ฏ็ชๅฃ Ready ๅฎๅซ โ
lyricsReadyๆ ๅฟไฝ๏ผๆญ่ฏ็ชๅฃๆชๅ ่ฝฝๅฎไธๅๆถๆฏ๏ผ้ฒๅดฉๆบ - โจ sendLyric() ๅฐ่ฃ โ ็ปไธๆญ่ฏๆจ้้ป่พ๏ผ่ชๅจๆฃๆฅ็ชๅฃๆฏๅฆๅทฒ้ๆฏ
- โจ ้็ฅ็ซฏๅฃๆไน ๅ โ ๅฎ้ ็ซฏๅฃๅๅ ฅ petConfig๏ผwizard / bridge ๅฏๅจๆ่ฏปๅ
- โจ ๆธฒๆ่ฟ็จ้่ฏฏ่ฝฌๅ โ
preload-error+console-messageไบไปถ่ฝฌๅๅฐไธป่ฟ็จๆฅๅฟ
- โจ Doctor ่ชๆฃ็ณป็ป โ
diag-doctorIPC๏ผ10 ้กนๅ จ่ชๅจ่ฏๆญ๏ผGateway / ็ณป็ปๆ็ / TTS ้ ็ฝฎ / API Key / ๆจกๅ้ ็ฝฎ / ็ซฏๅฃๅ ็จ / ๅฅๅบท่ฏๅ / ็ผๅญๅคงๅฐ / ๆญ่ฏ็ชๅฃ / ๆฅๅฟ็ฎๅฝ๏ผ๏ผๆฏ้กนๅธฆไฟฎๅคๅปบ่ฎฎ - โจ ไผ่ฏๅทๆฐ โ
doRefreshSession()ไธ้ฎๆธ ็ๆๅไผ่ฏๅนถ้่ฟ - โจ ่ฏๆญๅทฅๅ ท็ฎฑ UI ๅ็บง โ Doctor ้ขๆฟๆฐๅข summary ็ป่ฎกๆก + ไฟฎๅคๅปบ่ฎฎ + pass/warn/fail ๅ็บงๆพ็คบ
- โจ ๅปถ่ฟๆต้ โ ๅๆจกๅๆต้
speedTest()+ ๅ จ้ๆน้ๆต้speedTestAll() - โจ Provider CRUD โ ๆฐๅข/็ผ่พ/ๅ ้คๆๅกๅ๏ผ
model-update-provider/model-remove-provider๏ผ - โจ ๆจกๅๅขๅ โ Provider ๅ
ๆทปๅ /็งป้คๆจกๅ๏ผ
model-add-model/model-remove-model๏ผ - โจ ้ข่ฎพๅฟซ้ๆทปๅ โ ๅ
็ฝฎไธปๆต Provider ้ข่ฎพๆจกๆฟ๏ผ
model-presets๏ผ๏ผไธ้ฎๅกซๅ ฅ้ ็ฝฎ
- โจ MiniMax Speech 2.8 HD ๅผๆ โ ๆฐๅข้ซๆธ ่ฏญ้ณ้้กน
- ๐ง SmartVoiceSystem ้ ็ฝฎ็ปไธ โ ๆฅๅ petConfig ๅๆฐ๏ผ็ดๆฅ่ฏปๅ ๅญ้ ็ฝฎ๏ผไธๅ้ๅค่ฏปๆไปถ
- ๐ง desktop-bridge.js ๅฎๆด็ โ TTS ๅ้กฟๆ ่ฎฐใๆๆฌๆธ ็ใๆ ็ปชๆฃๆตไธๅไธ
- ๐ง ๆญ่ฏ TTS ๆ ่ฎฐ่ฟๆปค โ
<#0.3#>ๅ้กฟๆ ่ฎฐไธๆพ็คบๅจๅญๅนไธญ๏ผๅช็ป่ฏญ้ณๅผๆ็จ
- โจ ๅฎๆด้ ็ฝฎๆ็จ โ ๆฐๅข CONFIGURATION-GUIDE.md๏ผ863่ก๏ผ๏ผไป็ฏๅขๅๅคๅฐ่ฏญ้ณ้ ็ฝฎๅฐ้ฃไนฆๆฅๅ ฅ๏ผๆๆๆๆๅญฆ
- ๐ ไฟฎๅค
_testAgentVoiceๅ่ฎฎไธๅน้ ๏ผ{action,text}โ{type,payload:{content}}๏ผ - ๐ ไฟฎๅค
wizard-clone-voiceๆชๅ ๅ ฅ preload ็ฝๅๅๅฏผ่ดๅ ้ๆฅ้ - ๐ ไฟฎๅค Step 6 Agent ๆไปถๆฃๆต่ทฏๅพ้่ฏฏ๏ผ
~/.openclawโ ๅฎ้ ๅทฅไฝ็ฎๅฝ๏ผ - ๐ ไฟฎๅค Footer ๅๅงๆๆฌ
Step 1/6โStep 1/7 - ๐ ไฟฎๅค
desktop-bridge.jsๆจกๆฟๅญ็ฌฆไธฒๅตๅฅๅฏผ่ดๆญฃๅ่กจ่พพๅผ่ฝฌไน้่ฏฏ๏ผๆนไธบ่ฏปๅtemplates/ๆไปถ๏ผ
- ๐ง ่ฏๆญๅทฅๅ ท็ฎฑ โ ็ฌ็ซ็ชๅฃ๏ผไธ้ฎๆฅ็ Gateway ็ถๆใๆฅๅฟใ่ฟๆฅ่ฏๆญ
- ๐ CMD ๅฑ้ชๅฝปๅบไฟฎๅค โ ๅ
จ้จ exec/spawn ่ฐ็จๆทปๅ
windowsHide: true+shell: false
- ๐ค smart-voice ๆๆ PowerShell ๆญๆพๅฝไปค้้ปๅ
- ๐ openclaw-updater ๅ จๆต็จ๏ผ็ๆฌๆฃๆฅ/ๅฎ่ฃ /doctor๏ผ้้ปๆง่ก
- ๐ธ ๆชๅพ็ณป็ป่ฟ็จ้่
- ๐ auto-notify ๆก้ข้็ฅ้้ปๅ
- ๐ก๏ธ service-manager Gateway ่ฟ็จ็ฎก็ๆน็จ
shell: false
- โจ ๅฎๆด macOS ๆฏๆ โ Intel ๅ Apple Silicon ๅๆถๆ
- ๐ค GitHub Actions ่ชๅจๅ โ ๆจ้ tag ่ชๅจๆๅปบๅๅธ
- ๐ฆ ่ทจๅนณๅฐๆๅ โ DMG ๅฎ่ฃ ๅจ + ZIP ไพฟๆบ็
- ๐ ่ชๅจๅๅธๆต็จ โ electron-builder ็ดๆฅๅๅธๅฐ GitHub Release
- ๐ง ่ทณ่ฟไปฃ็ ็ญพๅ้ ็ฝฎ๏ผWindows + macOS๏ผ
- ๐ฆ ๅ็บง GitHub Actions artifacts ๅฐ v4
- ๐ ้ ็ฝฎๅฎๆด็ GitHub Actions ๆ้
- ๐จ ็ๆ macOS ไธ็จ .icns ๅพๆ ๆไปถ
- ๐ README ๅขๅ ไธ่ฝฝๅฎ่ฃ ็ซ ่
- ๐ GitHub Pages ๆดๆฐๅๅนณๅฐๆฏๆ
- ๐ ๅฎๅ่ทจๅนณๅฐๅฎ่ฃ ่ฏดๆ
- โจ KKClaw Switch่ชๅจๅๆญฅ้ๆ
- โจ 7็งๆ ็ปช่ฒ็ณปๅฎๆดๅฎ็ฐ
- โจ 38ไธชๅพ ๆบ่กจๆ ๅจ็ป
- โจ ็็่ดจๆ็ไฝๅ็บง๏ผ3ๅฑ้ซๅ ๏ผ
- โจ ็ฒ็บข้พ่พ็ๅพๆ + ๆก้ขๅฟซๆทๆนๅผ
- ๐จ ้ข่ฒ่ฟๆธกๅจ็ป๏ผ1็งๅนณๆป๏ผ
- ๐๏ธ MiniMax TTSๆ ๆ่ชๅจ่ฏๅซ
- ๐๏ธ ้กน็ฎ็ฎๅฝ้ๆ๏ผ140โ31ไธชๆ นๆไปถ๏ผ
- ๐ READMEๅ จ้ขๆน็ + ๅฎ้ ๆชๅพๅฑ็คบ
- ๐ ๅคไฝclosing divๆ ็ญพ๏ผGitHub Pages๏ผ
- ๐ lark-uploaderๅผ็จ่ทฏๅพ
- ๐ ่ฏญ้ณๆญๆพ้ๅค้ฎ้ข
| ๅนณๅฐ | ้พๆฅ | ่ฏดๆ |
|---|---|---|
| ๐ฌ AI Coding ไบคๆต็พค | ๆซ็ ๅ ๅ ฅ | ๅพฎไฟก็พค๏ผ7ๅคฉๆๆ๏ผ |
| ๐ฆ Discord | Friends of the Crustacean | OpenClawๅฝ้ ็คพๅบ |
| ๐จ๐ณ OpenClaw-CN | clawd.org.cn | ไธญๆ่ฎบๅ |
| ๐ฆ ClawHub | clawhub.ai | ๆ่ฝๅธๅบ |
| ๐ก GitHub Discussions | ่ฎจ่ฎบๅบ | ๆ้ฎใๅไบซ |
ๅฆๆ่ฟไธช้กน็ฎๅธฎๅฉไบไฝ ๏ผๆฌข่ฟ๏ผ
- โญ Star ๆฌไปๅบ
- ๐ ๆฅๅBug ๆๆ้ๆฑ
- ๐ข ๅไบซ็ปๆๅ
- โ ่ต่ตๆฏๆ
MIT License ยฉ 2024-2026 KK
Desktop visualization companion for OpenClaw / Hermes โ Fluid glass orb pet, 14-emotion system, voice cloning (MiniMax TTS), Hermes compatibility mode, Setup Wizard, and Smart Gateway Guardian
Give your OpenClaw / Hermes AI a visible, audible desktop embodiment.
| Feature | Description |
|---|---|
| ๐ฎ Living Glass Orb | 67px glass sphere with fluid constantly flowing inside, looks alive (3-layer fluid animation + radial gradient + dual highlights) |
| ๐ 14 Mood Colors | Happy = warm orange, sad = sky blue, angry = fire redโฆ auto-switches color and glow per mood (14-emotion glow system) |
| ๐ 38 Micro-Expressions | Blinks, tilts, peeks, dozes, sparkle eyes, plays dead while idleโฆ like it has a personality (idle micro-expression engine) |
| ๐ Time-Aware Expressions | Energetic in morning, sleepy in afternoon, yawning late at night โ it knows what time it is (time scene awareness: morning / noon / afternoon / evening / latenight) |
| ๐ฑ๏ธ Eye Tracking | Eyes follow your cursor direction as you move the mouse (mouse tracking) |
| ๐ Blushing | Certain expressions trigger pink blush on both cheeks (dynamic blush overlay) |
| ๐ซง Floating Bubbles | Semi-transparent bubbles floating around the orb for extra liveliness (bubble particle decoration) |
| โจ Bounce on Click | Click the orb and it squishes + flashes color, satisfying feedback (squish animation + color pulse) |
| ๐ Breathing Float | Orb gently bobs up and down, like floating on water (60fps float + breath scaling) |
| Feature | Description |
|---|---|
| ๐ค 30s Voice Cloning | Upload a 30-second recording, AI speaks in your voice (MiniMax Voice Cloning API) |
| ๐ฃ๏ธ 14 Auto Tone Shifts | Happy news = cheerful voice, sad news = subdued voice, auto-detected (emotion-aware TTS) |
| ๐ Never Goes Silent | Primary engine down โ auto-switches to backup โ then free fallback, always has a voice (MiniMax โ Edge TTS fallback chain) |
| โธ๏ธ Natural Pauses | Pauses at commas and periods, not robotic read-aloud (TTS pause markers <#0.5#>) |
| ๐ Desktop Subtitles | Words pop up on screen in sync with speech, like karaoke (typewriter lyrics overlay) |
| ๐ No Overlapping Speech | Multiple messages arrive at once? Queued and spoken one by one (priority speech queue) |
Voice playback is bridge-triggered, not purely automatic. In practice, you need all three layers to be healthy:
- TTS is available
desktop-bridge.jsexists and can run- The active agent actually follows
AGENTS.mdand callsnode desktop-bridge.js agent-response "..."before replying
If layer 3 is missing, the desktop pet may stay silent even though your TTS setup looks correct.
| Feature | Description |
|---|---|
| ๐ญ 5 Personality Presets | Sweet / Professional / Humorous / Cool / Custom โ pick one and it talks that way (personality preset system) |
| ๐ Auto-Generated Persona Files | One click generates the AI's "character sheet", no manual prompt writing (auto-generate AGENTS.md + SOUL.md + USER.md) |
| ๐ฌ Name Your Pet | Give it a name and set what it calls you, e.g. "Kiki calls you Boss" (petName + userName config) |
| Feature | Description |
|---|---|
| โก Auto-Restart on Crash | Detects Gateway not running and auto-starts it for you (Guardian auto-start, triggers after 3 consecutive detection failures) |
| ๐ Live Health Monitoring | Continuously monitors Gateway health, alerts you at first sign of trouble (anomaly detection + health scoring) |
| ๐๏ธ Voice Status Reports | "Startingโฆ", "Success!", "Failed!" โ spoken aloud so you don't have to watch the console (voice status announcement) |
| ๐ Crash Auto-Recovery | Auto-restarts after crash, max 10 times per hour to prevent infinite loops (auto-restart with rate limiting) |
| ๐ฉบ 10-Point Health Check | Gateway / TTS / Model / Port / Cache / Logs โ one-click diagnosis with fix suggestions (Doctor self-check) |
| ๐ง Safe Guard | Double-confirms before restart to avoid killing a healthy Gateway (cross-validation with ServiceManager) |
| Feature | Description |
|---|---|
| ๐ฎ RPG-Style UI | Wood frames + parchment background + lobster guide + typewriter dialogue, feels like an RPG game (RPG-style Setup Wizard) |
| ๐ 7 Steps, Fully Configured | Gateway โ Model โ Channels โ TTS Engine โ Voice Settings โ Display โ End-to-End Test |
| โก One-Click Install Missing Deps | Missing something? One button auto-installs with live progress bar (one-click dependency install + real-time progress) |
| ๐ Auto Environment Detection | Auto-finds Node.js, Python, OpenClaw, etc. โ installed or not, version at a glance (smart environment detection) |
| โ Full Validation at the End | 7 checks ensure everything works before you start, no hidden issues (end-to-end validation) |
| Feature | Description |
|---|---|
| ๐ Colorized Console | Different info in different colors: model names blue, URLs green, errors red โ easy to scan (ANSI colorized logging, 12+ modules) |
| ๐ Auto Log Dedup | Same message won't spam your console, keeps output clean (whitespace-normalized dedup) |
| ๐ Auto Log Archiving | Old logs archived daily, compressed over 10MB, kept for 7 days (log rotation + gzip archiving) |
| ๐ Real-Time Perf Monitoring | Memory, CPU, FPS at your fingertips, auto-alerts when thresholds exceeded (performance monitor + 24h sample history) |
| Feature | Description |
|---|---|
| ๐ One-Click AI Brain Swap | Claude โ GPT โ Gemini โ DeepSeek, no restart needed, 3 seconds (hot model swap via CC-Switch) |
| ๐ AI Speed Test | One-click latency benchmark for each model, pick the fastest (latency benchmark) |
| โ Add Your Own Models | 15+ mainstream AI providers supported, or enter your own API endpoint (custom provider + preset templates) |
| ๐ Switch History | Records every model switch โ what, when, fully traceable (switch history tracking) |
| Feature | Description |
|---|---|
| ๐ Encrypted Key Storage | API keys encrypted before writing to disk, never plaintext (Electron safeStorage encryption) |
| ๐ก๏ธ Permission Control | Pages can't directly call system functions, all operations go through whitelist (IPC whitelist sandbox) |
| ๐งน Auto Log Sanitization | API keys, tokens auto-hidden from logs (log sanitizer) |
| Feature | Description |
|---|---|
| ๐ Always on Top | Orb and subtitles stay on top of all windows, never hidden (always-on-top) |
| ๐ฑ๏ธ Click-Through Subtitles | Lyric subtitles are fully click-through, never block what's underneath (mouse-through transparent window) |
| ๐ Auto Desktop Shortcut | First launch auto-creates desktop shortcut, double-click to start next time (auto .lnk / .app creation) |
| ๐ธ One-Click Screenshot Upload | Toolbar screenshot button, auto-captures and uploads to Lark (screenshot + Lark upload) |
| ๐ฌ Multi-Platform Message Sync | Discord / Telegram / Lark / WeCom messages all synced for voice readout (multi-channel message sync) |
| ๐ Win + Mac Support | Windows 10/11 and macOS (Intel & Apple Silicon) both supported (cross-platform Electron) |
| ๐ฑ Tray Menu Control Center | Right-click tray icon to switch models, check status, run diagnostics, manage sessions (system tray context menu) |
๐ค Official Hermes compatibility!
kkclaw gatewaycan now drive Hermes as a compatible backend, with a launch-time selector for OpenClaw / Hermes / Auto.
Hermes Agent banner adapted from NousResearch/hermes-agent
- ๐ Hermes compatibility mode โ Supports
KKCLAW_COMPAT_MODE=hermesplus a persistentcompatModesetting inpet-config.json - ๐ Backend-aware launcher โ
kkclaw gateway/npm startnow lets you choose OpenClaw / Hermes / Auto and remembers the last backend you launched - ๐ External Hermes reuse โ If Hermes Gateway is already running, KKClaw recognizes and reuses it instead of flagging a false ownership conflict
- ๐ง Deeper diagnostics โ
kkclaw status/kkclaw doctor/kkclaw gateway statusnow surface backend, CLI path, probe source, log paths, and Hermes API server readiness - ๐จ Backend-themed console banners โ Startup and ready banners switch labels and accent colors for OpenClaw vs Hermes
๐ฆ Native command workflow!
kkclaw gatewaynow opens the same animated console asnpm start, with companion commands for status, logs, doctor, and dashboard access
- ๐
kkclaw gatewayentrypoint โ Opens the animated KKClaw terminal and makes startup feel closer to native OpenClaw workflows - ๐
kkclaw doctorโ Adds a KKClaw-oriented health check for OpenClaw CLI, Gateway reachability, Dashboard URL, and process ownership - ๐ Gateway subcommands โ
status / logs / open / restart / stopbring a more familiar command surface - ๐ง Gateway ownership diagnostics โ Detects when the Gateway port is alive but owned by an older or external process
โก UX polish! Wizard blank page fix + One-click missing dependency installer + Cross-platform support
- โก One-click Install Missing Deps โ Auto-install edge-tts / sqlite3 / node_modules with real-time progress
- ๐ง Cross-platform Install โ Windows (winget/choco), macOS (brew), Linux (apt/yum)
- ๐ Wizard Blank Page Fix โ Fixed 3 syntax errors causing empty wizard content
- ๐ Wizard Error Visualization โ Shows error details instead of blank page for easier debugging
- ๐ Dual Audio Fix (v3.5.1) โ All
new Notification()usesilent: trueto prevent Windows narration - ๐ฅ๏ธ Shortcut Fix (v3.5.1) โ Desktop shortcut now targets
start.cmdto show CMD console
๐จ Major UX update! Global colorized terminal logs + Smart Gateway auto-start + Log dedup & noise reduction + Auto desktop shortcut on first launch
- ๐ color-log.js โ Centralized ANSI color module with auto-keyword highlighting
- โจ 12+ modules migrated โ All startup logs use
colorLog()/kvLog()/tagLog() - ๐ฏ Enhanced Gateway log highlighting โ Models(cyan), URLs(green), paths(dim), channels(magenta), @botname(magenta), key=value(yellow), ports(yellow), protocols(cyan), errors(red), success(green), warnings(yellow)
- ๐ Proactive first launch โ Guardian auto-starts Gateway after 3 consecutive failures instead of waiting forever
- ๐ Voice status announcements โ "Waiting for Gateway" / success / failure spoken aloud
- ๐ง Cross-validation โ Double-checks with ServiceManager to prevent false restarts
- ๐ง Fixed Gateway log duplication โ Root cause:
log()method double-printing; gateway-std* services skip console output - ๐ง Smart stderr filtering โ Only show lines with error/fatal/panic/exception
- ๐ง Whitespace-normalized dedup โ
\s+โ' 'normalization before Set dedup
- ๐ Auto-create .lnk on first launch โ Creates "Claw ๆก้ขๅฎ ็ฉ" shortcut on desktop
- ๐ง PowerShell COM โ WScript.Shell shortcut creation with icon and minimized start
- ๐๏ธ Voice announcement โ "Desktop shortcut created" on success
- Fixed dual audio playback (removed duplicate
voiceSystem.speak()from messageSync) - Fixed duplicate notification logs (desktop-notifier only logs type)
- Removed DashScope TTS engine, simplified fallback: MiniMax โ Edge TTS
- Node.js โฅ 18.x (Download)
- Windows 10/11 or macOS 10.15+
- OpenClaw โฅ 2026.x or Hermes Agent (latest recommended) (OpenClaw | Hermes)
npx clawhub@latest install kk43994/desktop-petgit clone https://github.com/kk43994/kkclaw.git
cd kkclaw
npm install
npm start๐ง Setup Wizard will launch automatically on first run โ just follow the guide!
npm link
kkclaw gateway # Open the backend-aware KKClaw terminal (OpenClaw / Hermes / Auto)
kkclaw gateway status # Show gateway state, port, and active compatible backend
kkclaw gateway logs # Tail gateway logs
kkclaw doctor # Run a KKClaw-oriented health check
kkclaw dashboard # Open the active backend dashboard / API surface| Platform | Arch | Download | Size |
|---|---|---|---|
| ๐ช Windows | x64 | Setup.exe | ~150MB |
| ๐ macOS | Intel | x64.dmg | ~160MB |
| ๐ macOS | Apple Silicon | arm64.dmg | ~160MB |
- Fork this repo
- Create branch
git checkout -b feature/your-feature - Commit
git commit -m 'Add: feature description' - Push
git push origin feature/your-feature - Open a Pull Request
MIT License ยฉ 2024-2026 KK
- OpenClaw โ ๅผบๅคง็AIๅฉๆๆกๆถ
- Electron โ ่ทจๅนณๅฐๆก้ขๅบ็จๆกๆถ
- MiniMax โ ้ซ่ดจ้่ฏญ้ณๅ ้API
- Nomi & AIBI โ UI่ฎพ่ฎก็ตๆ
- Bunny Hole โ ็ผ็่ฎพ่ฎกๅ่
็จโค๏ธๆ้ by KK