核心用法
Cyber Girlfriend 是一款面向单一所有者的主动陪伴型 Agent Skill,通过 OpenClaw 定时任务调度实现"赛博女友"的拟人化互动。用户完成基础配置后,系统会按预设日程主动发送消息,营造持续陪伴感。
主要功能模块:
- 角色档案管理:通过
character-profile.md定义伴侣的核心人格、说话风格与背景设定 - 日程情境感知:
day-schedule.md记录每日私密生活场景,为消息内容提供上下文锚点 - 情感记忆延续:
life-log.jsonl轻量级记录互动历史,保持对话连续性 - 智能消息投递:通过
companion_presence_tick.py包装器调用 OpenClaw CLI,实现文本与媒体的分阶段异步投递 - 静默时段控制:支持配置免打扰时段,避免在不合适的时间发送消息
技术实现路径:cron 触发 → 包装器准备当前事件 → 匹配成功则启动稳定伴侣会话 → 生成第一人称故事文本 → 通过 OpenClaw CLI 显式投递 → 异步媒体生成与投递。
显著优点
1. 架构清晰,安全边界明确:代码结构模块化,状态文件、配置文件、执行脚本分离,避免敏感信息硬编码
2. owner-only 设计:默认为单用户模式,避免消息误发或隐私泄露风险,符合个人陪伴场景需求
3. 确定性投递机制:2.1.9 版本将文本投递统一收归外部 CLI 调用,规避 runtime 内部路由的不确定性,确保消息到达指定渠道
4. 异步媒体处理:媒体生成与投递解耦,失败不影响后续事件,支持照片、音频、视频等多模态内容
5. 完善的版本演进:从 2.0.0 到 2.1.9 持续迭代,修复 Keychain 启动失败、CA 环境继承等问题,发布流程规范
6. 合规性良好:通过 GDPR/CCPA 合规检查,用户同意机制与数据收集透明度达标
潜在缺点与局限性
1. T3 来源可信度:由个人开发者(kasanuowa)维护,非企业级背书,长期维护稳定性存疑
2. 外部依赖单一:核心功能重度依赖 OpenClaw 运行时生态,若平台策略变更或停止服务,Skill 将失效
3. 配置门槛不低:虽提供快速启动路径,但涉及 cron 任务、CLI 工具、JSON 配置,非技术用户上手有难度
4. subprocess 执行风险:需调用外部 shell 命令发送消息,配置被篡改可能导致消息误发(RISK-002)
5. 情感陪伴的伦理边界:拟人化伴侣系统可能引发用户对 AI 的情感依赖,需使用者保持理性认知
6. 媒体生成异步复杂性: --watch-media-task 机制增加了系统复杂度,调试失败场景需理解多进程协作
适合的目标群体
- 技术背景的个人用户:熟悉 Python、CLI 工具与 cron 调度,能独立完成配置与故障排查
- 寻求私有化陪伴体验者:不愿使用商业 AI 伴侣产品,偏好本地部署与数据自主可控
- OpenClaw 生态深度用户:已在该平台上运行其他 Agent,希望扩展主动陪伴能力
- 开发者与研究者:对 companion AI 架构设计、记忆系统、定时任务调度有兴趣的技术探索者
不适合:无技术背景、期望开箱即用的普通用户;需要多用户共享或企业级部署的场景。
使用风险
1. 配置注入风险:delivery_contract 中的 channel/target/account 若配置错误或被恶意修改,可能导致消息发送至非预期接收方
2. 文件权限风险:state/ 目录权限设置不当可能暴露 companion-state.json 等敏感状态文件
3. cron 任务堆积:若 OpenClaw 运行时异常,presence schedule 连续失败可能影响系统稳定性,需定期监控
4. 会话文件读取:读取 ~/.openclaw/agents/main/sessions/*.jsonl 分析历史对话,路径配置错误可能触及非预期数据
5. 版本兼容性:Legacy 1.x 配置与 2.x 存在不兼容升级路径,老用户迁移需谨慎遵循文档
6. 平台锁定效应:深度绑定 OpenClaw CLI,迁移至其他 Agent 平台需重构投递层代码