Desktop Pet

一款像素风桌面宠物（默认为龙虾 🦞），以透明 Electron 覆盖层形式在屏幕上自由游走。

快速开始

cd /assets/app
npm install
npx electron .

宠物将从屏幕底部中央位置启动，并开始游走。

HTTP API

本地 API，运行于 端口 18891（仅限 127.0.0.1）：

• GET /state — 返回 {"state":"idle","statusText":""}
• POST /state — 设置状态：{"state":"talking","bubble":"hello!"}

状态说明

智能体集成

可在响应开始时调用该 API，使宠物转向用户：

curl -s -X POST http://127.0.0.1:18891/state 
  -H 'Content-Type: application/json' 
  -d '{"state":"talking","bubble":"working on it..."}'

长时间操作期间可设为 working 状态，推理过程中可设为 thinking 状态。

talking 状态将在气泡持续时间结束后自动恢复为 idle 状态。

自动启动（macOS）

创建一个 LaunchAgent，实现登录时自动启动。使用标识符 ai.openclaw.desktop-pet。

# 安装为 LaunchAgent
cat > ~/Library/LaunchAgents/ai.openclaw.desktop-pet.plist << 'EOF'



  Labelai.openclaw.desktop-pet
  ProgramArguments
    APP_PATH/node_modules/.bin/electron
    APP_PATH
  
  WorkingDirectoryAPP_PATH
  RunAtLoad
  KeepAlive
  StandardOutPath/tmp/desktop-pet.log
  StandardErrorPath/tmp/desktop-pet.log
  EnvironmentVariables
    PATH/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin
  

EOF

请将 APP_PATH 替换为应用目录的绝对路径。

自定义配置

宠物图形通过 index.html 中的 Canvas 像素画方式程序化绘制。如需更换生物形象：

• 修改 lobsterBase() 和 lobsterFront() 函数，替换为新的像素布局
• 颜色定义为脚本块顶部的常量
• 每个像素表示为 {x, y, w, h, color}，按 3× 缩放比例绘制

功能特性

• 透明覆盖层，始终置顶，支持穿透点击（宠物本体除外）
• 可在整个桌面空间中游走：包括“地板”“墙面”“天花板”
• 主动避开鼠标光标（半径 250px）及最前端窗口
• 右键弹出上下文菜单，支持手动控制状态
• 对话气泡支持自动适配内容长度的持续时间
• 全部像素画均通过 Canvas 绘制，无需依赖外部图像资源