kkclaw — デスクトップ ロブスター AI コンパニオン
AI エージェントにデスクトップ上の身体を与えます：視覚的な球体 + 音声対話 + 感情表現。
機能特長
- 🧙 Setup Wizard — 初回実行時の設定ガイド、3分で使い始められます
- 🔐 safeStorage 暗号化 — API キーをローカルに暗号化保存、平文はもう使いません
- 🎭 ペルソナ設定 —
AGENTS.md/SOUL.md/USER.md/HEARTBEAT.mdを自動生成 - 🎵 音声システム — MiniMax 音声クローン + CosyVoice + Edge TTS の3段階フォールバックで、音声が途切れることはありません
- 👀 感情表現 — 14の感情 + 多彩な目の表情 + 動的なグロー光効果
- 🩺 Doctor 自己診断 — ワンクリックで Gateway / モデル / TTS / ポート / ログ / 歌詞ウィンドウを診断
- 🎛️ モデル管理 — Provider CRUD、モデルの追加・削除、レイテンシー測定、プリセットの素早い追加
- 🧠 Gateway 同期 — WebSocket で OpenClaw Agent の状態をリアルタイム同期、ミリ秒単位の応答
- 💪 7x24 信頼性 — 自動復旧、ヘルススコア監視、Switch ロガー
- 🖥️ 軽量レンダリング — 純粋な HTML/CSS/JS 球体、CSS radial-gradient のガラス質感、フレームワーク不要
- 🎤 音声読み上げ — Agent の応答を自動で音声に変換、感情認識とポーズマーカーに対応
- 🖱️ デスクトップ統合 — ウィンドウ最前面表示、マウス透過、ドラッグ追従、歌詞字幕ウィンドウ
技術スタック
- Electron（デスクトップコンテナ）
- OpenClaw Gateway（WebSocket 通信）
- MiniMax Speech / CosyVoice / Edge TTS（音声合成）
- CSS Animation + requestAnimationFrame（球体アニメーション）
インストール
git clone https://github.com/kk43994/kkclaw.git
cd kkclaw
npm install
npm start
またはインストーラをダウンロード：
- Windows: https://github.com/kk43994/kkclaw/releases/download/v3.1.2/KKClaw-Desktop-Pet-3.1.2-Setup.exe
- macOS (Intel): https://github.com/kk43994/kkclaw/releases/download/v3.1.2/KKClaw-Desktop-Pet-3.1.2-x64.dmg
- macOS (Apple Silicon): https://github.com/kk43994/kkclaw/releases/download/v3.1.2/KKClaw-Desktop-Pet-3.1.2-arm64.dmg
設定
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/ # 開発ドキュメント
リンク
- GitHub: https://github.com/kk43994/kkclaw
- ランディングページ: https://kk43994.github.io/kkclaw/
- ClawHub: https://clawhub.ai/kk43994/desktop-pet
- バージョン: v3.1.2