LingPet

Your AI Desktop Companion

你的 AI 桌面夥伴


github.com/Gabigi748/LingPet

What is LingPet?

LingPet 是什麼?

  • A cross-platform AI desktop pet powered by OpenClaw
    基於 OpenClaw 的跨平台 AI 桌面寵物
  • Give your AI a face — chat right on your desktop
    讓你的 AI 有張臉 —— 在桌面上聊天

Core Philosophy

核心理念

  • Not just a chatbot — a companion on your screen
    不只是聊天機器人 —— 是螢幕上的夥伴
  • Shares memory across all your devices
    在所有裝置上共享記憶

Features at a Glance

功能一覽

Transparent Window 透明視窗 Galgame Chat 對話 UI Dynamic Emotions 動態情緒 Head Pat 摸頭 Screen Watch 螢幕觀察 Layout Settings 佈局設定 Floating Animation 漂浮動畫 Cross-Platform 跨平台

Transparent Desktop Pet

透明桌面寵物

  • Always-on-top, draggable, click-through
    永遠置頂、可拖曳、滑鼠穿透
  • Gentle floating animation for a living feel
    輕柔漂浮動畫,彷彿有生命

Galgame-Style Chat

Galgame 風格對話

  • Semi-transparent dialog with typewriter effect
    半透明對話框搭配打字機效果
  • Position configurable: above or below character
    位置可調:角色上方或下方

Dynamic Emotion System

動態情緒系統

  • Auto-scans assets/ folder on startup
    啟動時自動掃描 assets/ 資料夾
  • Your artwork defines the available emotions
    你的立繪決定可用情緒

How Emotions Work

情緒運作方式

AI replies with emotion tags, artwork switches accordingly

AI 回覆帶情緒標籤,立繪自動切換

[happy] [shy] [angry] [thinking] [sleepy] [confused]

Auto-resets to default after 5 seconds | 5 秒後自動恢復預設

Head Pat

摸頭互動

  • Click the top area of the pet to pat its head
    點擊寵物頭部區域來摸頭
  • Cute response with heart particle effects
    可愛回應搭配愛心粒子效果

Screen Watch

螢幕觀察

  • Pet periodically screenshots your screen
    寵物定期截取你的螢幕畫面
  • Comments naturally on what you're doing
    自然地評論你正在做的事

Screen Watch Flow

螢幕觀察流程

1. Capture screenshot (pet hides)
截取螢幕(寵物隱藏)
2. Vision AI describes the screen
視覺 AI 描述螢幕內容
3. OpenClaw generates personality-aware comment
OpenClaw 生成角色個性的評論

Layout Settings

佈局設定

  • Dialog position: above or below character
    對話框位置:角色上方或下方
  • Character offset and scale adjustable
    角色偏移和縮放可調整

OpenClaw Integration

OpenClaw 整合

  • Connects to Gateway for full AI experience
    連接 Gateway 獲得完整 AI 體驗
  • Shares session with QQ bot, PWA, and more
    與 QQ 機器人、PWA 等共享 session

Quick Start

快速開始

1. git clone & npm install
2. cp config.example.json config.json
3. Drop artwork in assets/ as default.png
4. npm start

In-App Settings

應用內設定

  • Configure everything via the gear button
    透過齒輪按鈕設定一切
  • API, pet name, prompt, layout — no code needed
    API、名稱、提示詞、佈局 —— 不需寫程式

Tech Stack

技術堆疊

Electron
Cross-platform desktop app | 跨平台桌面應用
OpenClaw Gateway
AI backend with memory | 帶記憶的 AI 後端
Vision API
Anthropic / OpenAI for screen recognition | 螢幕辨識

Roadmap

未來規劃

  • Auto-start on boot
    開機自動啟動
  • Live2D support — animated pet models
    Live2D 支援 —— 動態寵物模型

Thank You

謝謝


LingPet — Your AI Desktop Companion

LingPet —— 你的 AI 桌面夥伴


github.com/Gabigi748/LingPet
Open source under MIT License