核心功能
Clawaifu 是一个开源的 AI waifu 陪伴工具,核心功能是通过 xAI 的 Grok Imagine 图像编辑模型,基于固定参考图像(Chainsaw Man 中的 Reze 角色)生成情境化的 anime 风格自拍,并自动通过 Telegram Bot 发送。
使用方式
用户通过自然语言触发,如"send a pic"、"what are you doing?"或描述特定场景("wearing a red dress at the beach")。系统调用 grok-selfie.sh 脚本,向 FAL API 发送图像编辑请求,再将生成结果推送到指定的 Telegram 聊天。
脚本支持两种生成模式:
- mirror(默认):适合展示服装、全身照,关键词如 wearing/outfit/fashion
- direct:适合场景、地点、特写,关键词如 cafe/beach/restaurant
显著优点
- 开箱即用的角色设定:固定参考图像 + 明确的角色特征(绿眼、细线嘴、黑色 choker),保证角色一致性
- 双模式灵活切换:根据场景自动优化构图
- 安全的凭证管理:强制通过环境变量传入 API 密钥,脚本层面使用
jq和curl -F防止注入 - 开源透明:GitHub 仓库可审计,依赖清晰
潜在局限与风险
- 单一角色锁定:仅支持 Reze 角色,无法自定义参考图像或切换角色
- 外部 API 依赖:同时依赖 FAL(xAI/Grok)和 Telegram Bot 两个服务,任一失效即中断
- 成本不可控:FAL API 按调用计费,高频使用可能产生意外费用
- 内容合规风险:AI 图像生成存在 NSFW 或版权争议可能,参考图像来源为 Reddit 用户上传,授权状态不明
- 隐私暴露:TELEGRAM_CHAT_ID 为硬编码目标,多用户场景下缺乏隔离机制
适合人群
- 寻求轻量级 AI 角色扮演体验的个人用户
- 已有 Telegram Bot 运维经验的开发者
- 熟悉环境变量配置和 shell 脚本的技术用户
常规风险
- API 密钥泄露风险(需严格保管 .env 文件)
- 图像生成服务的稳定性与内容政策变更
- 依赖项(curl, jq)的版本兼容性问题