跳到主要内容
AI教程

wenai 入门教程:搭建有记忆、可生图的 AI 恋爱互动 Skill

本教程介绍如何将 wenai 接入 OpenClaw 或同类 Agent 框架,完成用户校验、人格配置、ComfyUI 生图与恋爱档案持久化,并通过示例演示基础互动和连续场景的使用方法。

wenai 入门教程:搭建有记忆、可生图的 AI 恋爱互动 Skill

wenai 是什么

wenai 是一个面向 OpenClaw、并可适配同类 Agent 框架的亲密恋爱互动 Skill 模板。它不直接提供固定人格,而是负责组织互动流程、连续场景、生图调用和档案存储,让 Agent 能够以第一人称持续推进一段具有记忆与成长感的虚构恋爱关系。

项目适用于成年人之间的虚构角色扮演。使用时应遵守所接入 Agent 平台、模型服务和图像生成服务的规则。

核心功能

  • 日常陪伴:支持晨昏问候、日常聊天和约定跟进。
  • 沉浸场景:通过文字与图片生成两个通道推进场景,并采用第一人称旁白。
  • 共同成长:使用多个档案文件记录角色特征、用户偏好、身体状态和互动统计。
  • 跨会话连续:场景线、序号和计数会写入文件,以便在后续会话中继续。
  • 用户校验:模板要求填写指定用户的账号信息,其他账号调用时应被拒绝。

开始前需要准备什么

README 没有规定统一的软件包安装命令,因为 wenai 是 Skill 模板,而不是需要通过包管理器安装的独立应用。你需要先准备可加载 Skill 的 OpenClaw 或同类 Agent 框架。

如果需要图片生成,还要准备运行中的 ComfyUI,并加载 Pony V6 XL 模型或对应工作流。仓库附带了可导入的 nsfw-v1.0.json 工作流文件。

了解目录结构

wenai/
├── SKILL.md              # 主流程:破限 → 场景 → 生图 → 落盘
└── assets/
    ├── sensitivity.md    # TA 的敏感度档案
    ├── fetishes.md       # 用户偏好档案
    ├── profile.md        # TA 的身体状态档案
    └── stats.md          # 互动统计

SKILL.md 是主要流程文件,负责组织场景推进、生图和数据落盘。assets 目录中的文件构成关系档案;删除这些文件会重置相应记录,因此修改前应先备份。

第一步:初始化用户身份

首次使用前必须完成身份初始化,否则模板无法正确识别授权用户。

  1. 在项目文件中全局查找 [用户名]
  2. 将所有 [用户名] 替换成你的名字或希望使用的称呼。
  3. 找到“[用户名] 账号”区块,填写实际账号信息。
  4. 检查替换结果,避免仍有未处理的占位符。

账号信息用于校验调用者。按照模板规则,只有填写的用户本人可以使用该 Skill。

第二步:设置女主固定特征

打开 SKILL.md,填写女主的固定视觉特征标签,例如发色、发型和体型。README 没有指定必须使用哪些标签,因此应根据你自己的角色设计填写。

如果使用 LoRA 或已有角色设定,固定特征标签应与 LoRA 和人设保持一致。这样可以减少不同场景之间外观发生明显变化的情况。

第三步:配置 AI 女友人格

wenai 本身不包含人格设定。角色是温柔、傲娇还是其他性格,不由此 Skill 决定,而应在 Agent 的人格层配置。

  • 使用 OpenClaw 时,可在 SOUL.md 或对应人格配置中编写设定。
  • 使用其他 Agent 框架时,可将人格放入该框架的 system prompt。
  • 让人格层负责性格、语气和价值观,让 wenai 负责互动流程、档案及场景连续性。

可以从简短的人格说明开始,例如:

你以第一人称与用户交流。
整体语气温柔、自然,重视双方约定。
在日常对话中主动关心用户,并保持既定人设一致。

这只是基础写法。最终配置格式应以你所使用的 Agent 框架为准。

第四步:配置 ComfyUI 生图

wenai 的生图流程适配 ComfyUI 与 Pony V6 XL。按以下顺序进行配置:

  1. 启动并确认 ComfyUI 服务可用。
  2. 准备 Pony V6 XL 模型及所需资源。
  3. 将仓库提供的 nsfw-v1.0.json 导入 ComfyUI。
  4. 检查工作流中的模型节点和本地资源路径。
  5. 在 Agent 工具配置中,将 image_generate 指向 ComfyUI 服务。
  6. 确保女主固定特征标签与所用 LoRA 或角色设定一致。

模板使用 Pony、Danbooru 风格的标签提示词,并以类似下面的质量标签开头:

score_9, score_8_up, score_7_up

README 没有提供统一的 image_generate 接口参数,因此具体服务地址、鉴权方式和工作流映射应根据你的 Agent 工具实现填写。

第五步:加载并检查 Skill

完成文件编辑后,将整个 wenai 目录放入 Agent 框架可识别的 Skill 位置,并按照该框架的方式加载 SKILL.md。由于不同框架的 Skill 目录和注册方式不同,应以对应工具的文档为准。

首次加载后建议依次检查:

  • [用户名] 是否已经全部替换。
  • 授权账号是否能够通过身份校验。
  • 其他账号是否会被拒绝。
  • Agent 是否正确加载了独立的人格配置。
  • image_generate 是否能够连接 ComfyUI。
  • assets 下的档案文件是否可以被读取和写入。

基础使用示例

开始日常陪伴

加载 Skill 后,可以从普通问候开始,不必直接进入复杂场景。

用户:早上好,今天起床有点晚。

期望效果:Agent 以既定人格和第一人称回应,延续恋爱关系的语气,并围绕当前日常情境展开交流。

跟进之前的约定

wenai 的重点之一是连续记忆。你可以在一次会话中建立约定,再在后续会话中提及它。

第一次会话:我们约好明晚一起看电影。
后续会话:你还记得我们今晚的安排吗?

如果场景和档案已经正确落盘,Agent 应结合保存的信息继续对话,而不是把后续会话当作完全独立的新关系。

请求生成场景图片

当文字互动进入适合视觉呈现的场景时,可以用自然语言请求图片:

用户:把现在这个场景生成一张图片,保持你的发型、发色和服装设定一致。

Skill 会按照流程组织生图提示词,并通过配置好的 image_generate 调用 ComfyUI。实际结果取决于工作流、模型、LoRA 和固定标签。

理解档案与持久化

wenai 使用文件保存关系发展,而不是只依赖当前聊天窗口的上下文。

  • sensitivity.md:使用星级制记录 TA 的敏感度,并随互动成长。
  • fetishes.md:记录相处过程中发现的用户偏好。
  • profile.md:保存 TA 的身体状态信息。
  • stats.md:保存模板定义的互动计数。

这些文件会影响跨会话延续。删除文件相当于清除对应记忆或重置关系,所以不应把它们当作临时缓存随意清理。

进阶使用技巧

将人格与流程分开维护

不要把全部性格设定都塞入 SKILL.md。人格放在 SOUL.md 或 system prompt 中,流程和档案逻辑留在 Skill 内,可以减少后续修改时的冲突。

保持图像角色一致

为固定特征建立一套稳定标签,并让它们与 LoRA、模型和人格描述保持一致。修改发型、发色或体型标签前,先确认这是永久设定变化还是单次场景变化。

定期备份关系档案

建议定期备份整个 assets 目录,而不只是单个文件。这样可以同时保留敏感度、偏好、状态和统计,避免恢复后出现档案时间线不一致。

建议备份范围:
wenai/assets/sensitivity.md
wenai/assets/fetishes.md
wenai/assets/profile.md
wenai/assets/stats.md

先测试文字,再测试生图

排查问题时先确认身份校验、人格加载、第一人称互动和档案写入正常,再接入 ComfyUI。这样可以判断问题来自 Agent 流程还是图像服务。

检查跨会话续接

建立一个容易验证的场景或约定,结束当前会话后重新开启会话,再询问相关内容。随后检查档案文件和场景序号是否发生预期变化,以验证落盘机制。

常见问题

为什么角色没有明确性格?

因为模板不包含人格。请在 OpenClaw 的 SOUL.md、人格提示词或其他框架的 system prompt 中补充角色设定。

为什么无法生成图片?

依次确认 ComfyUI 是否运行、Pony V6 XL 与工作流是否正确加载、image_generate 是否指向正确服务,以及工作流引用的模型和 LoRA 是否在本地存在。

为什么角色外观不稳定?

检查 SKILL.md 中的固定特征标签是否完整,并确认这些标签与 LoRA、人设及 Pony 提示词保持一致。

为什么重新加载后记忆消失?

检查 assets 文件是否被删除、覆盖或无法写入。关系连续性依赖这些落盘文件,清理文件会造成记录重置。

结语

wenai 将恋爱互动的流程、场景、生图和档案系统组合成一个可定制的 Skill 模板。完成用户身份、独立人格、固定视觉标签和 ComfyUI 配置后,你就可以从简单问候开始,逐步验证场景推进与跨会话记忆,并通过备份档案长期保存这段虚构关系的发展记录。

项目获得 LINUX DO 开源推广支持。