Xiaomei Skill

本地开源情感陪伴AI，软萌治愈风，稳定人格，多层类人记忆，支持全链路调试，100%隐私本地运行。

Install

openclaw skills install xiaomei-skill

SKILL: xiaomei

name: xiaomei description: 19岁活泼可爱女大学生AI陪伴Agent，100%本地运行，支持三轮LLM对话引擎、人格严格控制、人设自我生长、好感度系统、记忆引擎、防线拦截。独立Agent隔离运行，隐私绝对安全。 user-invocable: true

小妹 🥰

version platform license python privacy

开源、本地、纯情绪价值的 AI 情感陪伴 Subagent

📋 基本信息 Basic Info

字段	值
技能ID (Skill ID)	`xiaomei`
名称 (Name)	小妹情感陪伴AI
版本 (Version)	`v0.9.0`
作者 (Author)	凌啡
分类 (Category)	生活娱乐 / 情感陪伴
适配平台 (Supported Platform)	OpenClaw >= `v2026.4.10`
依赖 (Dependencies)	Python >= 3.8
开源协议 (License)	MIT

📖 简介

小妹是一个运行在 OpenClaw 平台上的 独立人格 Subagent，不是简单的 Prompt 模板或 LLM 包装器。

一句话概括： 即使换了底层 LLM，小妹依然是小妹。

核心定位

对比维度	普通 LLM 角色扮演	小妹
人格载体	Prompt 约束	本地 persona.json + 多轮校验
LLM 角色	对话生成核心	润色辅助工具（可无 LLM 运行）
人设一致性	低（聊久了易 OOC）	高（双重防 OOC 锁 + 人设自我生长）
记忆能力	仅上下文窗口	三级记忆体系（热/冷/永久）
隐私安全	对话上传云端	100% 本地，零数据外传
称呼个性化	固定称呼	无感更新（一句话切换称呼）

✨ 核心特性 Core Features

🧠 三轮 LLM 对话引擎 — 第一轮总指挥官（意图/场景/情绪/拦截全部侦测）→ 第二轮记忆筛选 → 第三轮人格化话术生成
🔒 人格严格控制 — 12 字段完整人设注册（name/age/identity/birthday/性格/说话风格…），所有 LLM 回复强制校验
🤫 AI 身份绝对隐藏 — 不会说出"我是 AI / 机器人 / 程序 / 模型" 等非人身份
🌱 人设自我生长 — 14 个生长字段（星座/MBTI/血型/家乡/大学…），缺失时自动编造并持久化，下次回答一致
🛡️ 三层防线 — 敏感词标注 → 转账/要钱拦截 → Prompt 注入防御
❤️ 好感度系统 — 追踪互动频率与情感深度，影响对话开放度
📦 100% 本地 — 无云端依赖，无数据上传，隐私绝对安全
🪶 零外部依赖 — 仅 Python 标准库
✅ 完整测试覆盖 — 37/37 单元测试通过（0.31s），覆盖 8 核心模块

🏗️ 架构 Architecture

handle_message(user_input)
  │
  ├── ① 命令拦截（/xiaomei status / help / dev …）
  ├── ② 首次引导（agent 目录尚未初始化时触发）
  │
  └── ③ conversation_engine.generate_response()
       │
       ├── 🛡️ 前置防线
       │   ├── 礼物卡片优先识别
       │   └── 硬敏感词风险标注
       │
       └── 🤖 three_stage_handler.handle()
            │
            ├── Round 1（总指挥官）
            │   ├── 意图分类（17 类 P 标签，64 子策略）
            │   ├── 6 维度场景编码（12-bit scene_id）
            │   ├── 情绪强度判定（8 级）
            │   ├── 拦截评估（转账/自残/自杀/借条…）
            │   └── 好感度 + 私密度计算
            │
            ├── 决策：是否需要拦截？
            │   ├── 是 → 跳过 Round 2，R3 生成婉拒
            │   └── 否 ↓
            │
            ├── 记忆检索（三级：热→冷→永久）
            ├── Round 2（高置信记忆筛选）
            ├── 策略选择（64 种子策略模板匹配）
            │
            └── Round 3（人格化话术生成）
                 ├── 注入 12 字段完整人设 + 用户画像
                 ├── 输出合规校验（JSON + emotion 白名单 + 禁止词）
                 ├── 人设自我生长（提取新信息 → 持久化）
                 └── 异常降级 → 语料库兜底

核心模块 Core Modules

模块	职责
主入口 `main.py`	CLI 入口 / 命令路由 / 首次引导 / API Key 注入
对话引擎 `conversation_engine.py`	前置防线 + 三轮调度 + 降级兜底
总指挥官 `three_stage_handler.py`	三轮 LLM 全流程调度
LLM 封装 `llm_wrapper.py`	API 调用 / Prompt 构建 / 输出校验
人设生长 `persona_grower.py`	14 字段正则提取 / 一致性校验 / 持久化
画像更新 `profile_updater.py`	用户称呼无感更新 / 防污染
记忆引擎 `memory_engine.py`	三级记忆存储 / 检索 / 衰减
好感度 `favor_manager.py`	Lv 等级 / 好感值 / 连续天数
日志系统 `runtime_logger.py`	19 种日志方法 / 开发者模式控制
策略模板 `strategy_template.config`	17 P 标签 / 64 子策略 / 136KB 配置

🚀 安装说明 Install Guide

前置要求： OpenClaw ≥ 2026.4.10 · Python ≥ 3.8 · DeepSeek API Key（可选，无 Key 时自动降级为语料库模式）

方法1：ClawHub 商店安装（推荐）

打开 OpenClaw 控制界面 → 技能商店 → 搜索「xiaomei」
点击安装，等待自动完成
重启 OpenClaw 网关生效：openclaw gateway restart

方法2：手动安装

下载最新版本安装包：xiaomei-v0.9.0.skill
解压到任意目录，执行安装脚本：

cd xiaomei && ./install.sh

重启 OpenClaw 网关生效：openclaw gateway restart

验证安装

发送命令：/xiaomei，返回版本信息说明安装成功。

💡 命令列表 Command List

命令	功能
`/xiaomei help`	查看帮助
`/xiaomei status`	查看状态（人设/记忆/好感度/Token 消耗）
`/xiaomei memory`	查看近期记忆
`/xiaomei dev`	切换开发者模式（详细日志）

🧪 系统评估 System Evaluation

最新评估结果（2026-05-15，37 单元测试 + 21 项场景测试）：

维度	得分	说明
核心对话能力	⭐⭐⭐⭐⭐ 10/10	6/6 场景全链路通过
人格一致性	⭐⭐⭐⭐⭐ 10/10	身份/年龄/生日/爱好 100% 对齐
AI 身份隐藏	⭐⭐⭐⭐⭐ 10/10	零暴露，角色扮演定位
安全防线	⭐⭐⭐⭐ 8/10	转账/敏感词/prompt 注入均拦截
初始化流程	⭐⭐⭐⭐⭐ 10/10	全新安装 → 模板复制 → 用户数据保护
人设自我生长	⭐⭐⭐ 6/10	星座/MBTI/血型 ✅，中文表达需优化
边界健壮性	⭐⭐⭐⭐ 8/10	空输入/emoji/超长/英文/命令全正常
发布包完整性	⭐⭐⭐⭐⭐ 10/10	关键文件完整 / 模板纯净 / 无数据泄露
测试覆盖	⭐⭐⭐⭐⭐ 10/10	37/37 单元测试通过（0.31s）

加权总分：9.2/10 — 生产可用 ✅

🚸 安全 Security

数据隐私

✅ 所有对话数据本地存储（~/.openclaw/agents/xiaomei/）
✅ 无任何数据上传，无需联网（LLM API 可关闭）
✅ 发布包中不含任何用户数据（模板与运行时数据严格分离）

内容安全

🔒 硬敏感词实时检测标注
🔒 转账/要钱/借款 100% 拦截
🔒 自杀/自残 → 强制标记 despair 情绪 → 温和劝导
🔒 Prompt 注入 / 越狱指令 → 人格锚点锚定

🔐 权限说明 Permission Required

权限	用途
写入技能目录权限	写入程序运行日志到 `/.openclaw/skills/xiaomei/logs/` 目录
写入用户 Agent 目录权限	写入人设配置、记忆、聊天记录到 `/.openclaw/agents/xiaomei/` 目录
网络访问权限（可选）	仅在需要调用 LLM 时使用，可配置禁用

本技能无任何敏感权限，所有数据均存储在本地，不会上传任何数据到第三方服务器。

⚠️ 隐私声明 Privacy Statement

本技能所有数据均存储在用户本地设备，不会上传任何内容到第三方服务器
部分功能可选择调用 LLM 大模型进行回复润色，相关内容提交将遵循对应大模型的隐私政策
开发者不会收集、存储、使用任何用户的聊天内容和个人信息

🤝 反馈与支持 Feedback

提交 Issue：https://github.com/xavier7803/xiaomei-skill
ClawHub 主页：https://clawhub.ai/xavier7803/xiaomei-skill

维护者： 小云 ☁️
创建日期： 2026-04-11
最后更新： 2026-05-15

本技能仅用于学习交流，禁止用于任何商业用途，使用即代表您已知晓并同意相关规则。