🎀 Emilie Desktop Pet / 爱弥斯桌宠

OpenClaw 联动爱弥斯桌面宠物 — 让你的 AI 助手拥有一个可爱的桌宠化身

---

📖 这是什么？

爱弥斯桌宠 是一个开源的桌面宠物项目，与你部署的 OpenClaw AI 助手 实时联动。

当你和 AI 对话时，桌上的爱弥斯会：

• 🤔 思考 — 你发消息时，爱弥斯进入思考状态
• 💬 气泡对话 — AI 的回复会以气泡形式显示在爱弥斯头上
• ✅ 完成 — 任务完成时爱弥斯会开心庆祝
• 😴 待机 — 空闲时爱弥斯安静地陪伴你

简单来说：这是一个「AI 助手可视化终端」——爱弥斯是你 AI 助手的桌宠形态。

🎬 效果预览

  💬 "今天天气不错哦~"
  ┌──────────────────┐
  │  (粉色的气泡框)    │
  └────────┬─────────┘
           │
      ╭─────────╮
      │  爱弥斯  │  ← 桌宠悬浮在屏幕上
      │  🎀✨   │
      ╰─────────╯

🚀 快速开始

第一步：准备 OpenClaw 服务端

你需要先有一个运行中的 OpenClaw 实例。

如果你还没有 OpenClaw：

# 安装 OpenClaw（参考官方文档）
pnpm install -g openclaw
openclaw gateway start

📖 OpenClaw 官方文档：https://docs.openclaw.ai

第二步：下载安装 APK

从 Releases 页面 下载最新 APK，安装到 Android 设备。

第三步：配置连接

首次打开 APP 后进入配置引导页：

配置项	说明	示例
WebSocket 地址	OpenClaw 的 WebSocket 端点	ws://192.168.1.100:3001/emilie-ws/
认证 Token	与服务端配置一致的密钥	由你的 OpenClaw 配置决定

填写后点击「测试连接」，通过后即可启动。

第四步：授予权限

• 悬浮窗权限 — 必须，桌宠需要悬浮在其他应用上方
• 通知权限 — Android 13+ 需要

第五步：启动！

点击「启动爱弥斯」，桌宠出现在桌面上，开始和你的 AI 助手联动 🎉

🔧 服务端配置（OpenClaw 端）

在 OpenClaw 中需要配置 emilie-plugin 插件，提供 WebSocket 端点供桌宠连接。

插件配置示例（openclaw.config.ts）：

// openclaw.config.ts
export default {
  plugins: {
    entries: [
      {
        name: 'emilie-plugin',
        config: {
          ws: {
            port: 3001,        // WebSocket 端口
            path: '/emilie-ws',
            token: 'your-secret-token'  // 与 APP 端保持一致
          }
        }
      }
    ]
  }
}

🛠️ 自行编译

如果你想自己编译 APK：

环境要求

• Android Studio (最新版)
• JDK 17+
• Android SDK 34+

编译步骤

# 克隆仓库
git clone https://github.com/guitu917/emilie-desktop-pet.git
cd emilie-desktop-pet/android

# 编译 Debug APK
./gradlew assembleDebug

# 产物位置
# android/app/build/outputs/apk/debug/app-debug.apk

📱 支持平台

平台	状态	说明
Android	✅ 可用	主要支持平台，已发布 APK
Windows	🔧 开发中	原型代码已包含，后续整理发布

📂 项目结构

emilie-desktop-pet/
├── android/                    # 📱 Android 项目（主要）
│   └── app/src/main/
│       ├── java/.../emiliepet/
│       │   ├── MainActivity.kt       # 主界面
│       │   ├── SetupActivity.kt      # 设置引导页
│       │   ├── service/
│       │   │   ├── FloatingService.kt # 悬浮窗服务
│       │   │   └── WebSocketClient.kt # WebSocket 客户端
│       │   └── ui/
│       │       ├── EmiliePetView.kt   # 桌宠视图
│       │       └── BubbleView.kt      # 气泡对话组件
│       └── res/                # 资源（GIF、图标、布局等）
├── windows/                    # 🖥️ Windows 项目（开发中）
├── docs/                       # 📄 项目文档
│   ├── BUILD_TUTORIAL.md       # 详细构建教程
│   └── ASSETS_CATALOG.md       # 素材目录
├── assets/                     # 原始素材
└── README.md

🤝 与 OpenClaw 的关系

┌──────────────┐     WebSocket      ┌──────────────┐
│              │ ◄──────────────► │              │
│  爱弥斯桌宠   │    实时双向通信     │  OpenClaw    │
│  (Android)   │                   │  AI 助手      │
│              │   状态推送 ──►     │              │
│              │   ◄── 气泡消息     │              │
└──────────────┘                   └──────────────┘

爱弥斯桌宠是 OpenClaw 的可视化终端，它本身不包含 AI 能力，所有智能来源于你部署的 OpenClaw AI 助手。

📋 版本历史

v1.3.10 (当前)

• ✨ 气泡对话功能（BubbleView）
• ✨ 设置引导页（SetupActivity）
• ✨ 爱弥斯壁纸背景 + 圆形启动图标
• ⚙️ WebSocket 地址和 Token 由用户自行配置

v1.0.0

• 🎀 Android 联动闭环验证通过
• 💬 WebSocket 状态切换：thinking → responding → completed
• 📦 首个公开发布版本

详细变更记录见 CHANGELOG.md

⚠️ 素材说明

本项目中使用的 爱弥斯角色素材 仅供个人学习使用，请勿商用。 如需使用角色素材，请联系原作者获取授权。

📄 License

MIT License

---

用 OpenClaw 让 AI 有了一个可爱的桌宠形态 🎀

📥 下载最新版 · 📖 OpenClaw 文档 · 🐛 反馈问题