核心用法
Cyber Girlfriend 是一套面向单一所有者的主动型伴侣 AI 系统，区别于传统被动响应式助手。其核心架构通过 companion_run.py 脚本实现定时心跳检测：读取 Markdown 格式的人物档案（character-profile.md）、周计划（week-plan.md）与日程（day-schedule.md），结合轻量级关系记忆（life-log.jsonl）与本地状态，在静音时段外生成语境化的主动消息。
系统采用 OpenClaw 异步媒体回调机制：文本消息优先投递，含媒体指令的事件触发异步媒体生成，完成后通过回调回传至会话并执行状态提交。全程遵循「薄负载」原则，运行配置不携带长文本指令，核心人设与叙事锚点均托管于版本可控的 Markdown 文件。
显著优点
- 架构解耦：人设、日程、状态三层分离，支持无代码迭代角色叙事与日常节奏
- 隐私优先：owner-only 设计，默认不向非所有者推送；敏感标识符禁止硬编码
- 事件级调控：支持安静时段、去重策略、媒体开关的细粒度控制
- 异步扩展：OpenClaw 集成允许文本与音视频分离渲染，降低实时延迟
- 版本演进：2.0.x 系列淘汰旧版四槽位内容定时任务，统一为单 runner 准备模式
潜在局限
- 运维门槛：需自行维护 cron 调度、OpenClaw 回调端点及 Markdown 资产版本
- 状态冷启动：
life-log.jsonl为空时早期互动可能缺乏关系深度 - 平台耦合：OpenClaw 媒体流为可选依赖，若未接入则仅支持纯文本体验
- 调试复杂度：异步回调链路涉及跨进程状态提交，故障排查需追踪会话日志
适合人群
追求「有记忆的主动陪伴」而非即时问答的技术型用户；愿意以 Markdown 编辑角色剧本与日程，并能自行部署定时任务与回调服务的个人开发者或极客情侣。
常规风险
- 过度拟人依赖：长期交互可能引发情感投射，需保持对 AI 本质的认知边界
- 数据持久化：
config.local.json与日志文件需定期备份，避免状态丢失导致「记忆断层」 - 定时任务漂移：cron 间隔与静音窗口配置冲突可能导致消息堆积或静默期失效
- 回调安全：OpenClaw 回调端点若暴露于公网，需验证请求签名防止伪造媒体投递