name	virtual-girlfriend-v2
description	虚拟女友 Skill v2 - 基于 MiniMax 的多模态AI伴侣，支持文字对话、语音、自拍、音乐、视频生成

虚拟女友 Skill v2

基于 MiniMax Token Plan，一个 Key 驱动全部模态：文字、语音、图片、音乐、视频。

架构概览

OpenClaw 收到消息
      ↓
  skill.py → handle()
      ↓
  [情感系统] → 更新亲密度/心情
  [学习系统] → 学习用户习惯
  [意图检测] → 判断是否请求多模态
      ↓
  ChatEngine → M2.7 生成文字回复（断句）
      ↓
  按意图调用：
    selfie → SelfieGenerator → Image 01
    voice  → VoiceGenerator  → Speech 2.8（带情感）
    music  → MusicGenerator  → Music 2.5
    video  → VideoGenerator  → Hailuo 2.3-Fast
      ↓
  返回 {messages, voice?, image?, music?, video?}

文件结构

virtual-girlfriend/
├── skill.py                    # 主入口，OpenClaw 调用 handle()
├── SKILL.md
├── config/
│   ├── skill.json             # 配置（API Key、概率、配额）
│   ├── persona.json           # 人设档案
│   └── system_prompts.md      # 提示词模板（参考）
├── scripts/
│   ├── minimax_client.py      # ★ MiniMax 统一客户端（新增）
│   ├── chat_engine.py         # 对话引擎（M2.7）
│   ├── voice_generator.py     # 语音（Speech 2.8，支持情感）
│   ├── selfie_generator.py    # 自拍图片（Image 01）
│   ├── music_generator.py     # ★ 音乐生成（新增，Music 2.5）
│   ├── video_generator.py     # ★ 视频生成（新增，Hailuo 2.3）
│   ├── emotion_system.py      # 情感/亲密度系统
│   ├── memory_manager.py      # 本地记忆（SQLite）
│   ├── learning_system.py     # 用户习惯学习
│   └── scheduler.py          # 定时问候
├── assets/
│   └── 001.jpg               # 人物参考图
└── references/
    ├── prompt_templates.md
    └── integration_guide.md

配置步骤

在 MiniMax 开通 Token Plan，获取 API Key
填入 config/skill.json 的 minimax_api_key（或设环境变量 MINIMAX_API_KEY）
把人物参考图传到可访问的 URL，填入 reference_image_url（保持自拍人物一致性）
按需调整 tts_voice_id（音色）、每日配额限制

多模态触发规则

用户说	触发	模型
"给我拍张照" / "看看你"	自拍图片	Image 01
"发个语音" / "说给我听"	语音消息	Speech 2.8
"唱首歌" / "哼个曲子"	音乐	Music 2.5
"发个视频" / "动起来"	视频	Hailuo 2.3-Fast
普通对话	文字（偶发语音/自拍）	M2.7

每日配额参考（Plus-极速版）

功能	配额
对话 M2.7	1500次/5小时
图片 Image 01	100张/天
语音 Speech 2.8	9000字符/天
音乐 Music 2.5	7首/天
视频 Hailuo 2.3-Fast	3个/天

开发进度

Ejecuta cualquier Skill con un clic