clawaifu - OpenClaw Waifu

核心功能

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）的版本兼容性问题

核心用法

Clawaifu Selfie 是一个轻量级 Bash 脚本技能，专为生成和分享动漫风格自拍而设计。其核心功能围绕 ./grok-selfie.sh 命令展开，用户通过提供场景描述（如穿着、地点等），结合固定的角色参考图像，调用 xAI 的 Grok Imagine 模型生成编辑后的图像，最终通过 Telegram Bot API 发送至指定聊天。

脚本支持两种拍摄模式：mirror（镜像模式，默认）适合展示服装搭配，如 "wearing a designer dress"；direct（直拍模式）适合场景展示，如 "fancy rooftop restaurant"。用户还可附加文字说明（caption），让分享更具互动感。角色风格固定为《电锯人》中的 Reze，具有标志性的绿瞳、细线嘴型、黑色项圈等特征，采用 2D 动画与 cel shading 渲染风格。

显著优点

1. 架构轻量，依赖极简：脚本仅 84 行可执行代码，零第三方库依赖，仅依赖系统自带的 curl 和 jq，部署门槛极低。

2. 安全设计到位：所有敏感凭据（FAL_KEY、BOT_TOKEN、TELEGRAM_CHAT_ID）均通过环境变量注入，无硬编码风险；使用 jq 安全构造 JSON、curl -F 安全传输表单数据，有效防御注入攻击；脚本启用 set -euo pipefail 严格错误处理。

3. 合规性优秀：通过 GDPR 数据收集合规、敏感凭据保护、输入验证与转义、网络通信加密等六项合规检查，静态与动态分析得分均达 90+。

4. API 来源可靠：仅调用 fal.ai（xAI 官方）与 Telegram 官方 API，均为 HTTPS 加密通信，无恶意第三方服务。

潜在缺点与局限性

1. 功能边界固定：角色形象固定为 Reze，无法自定义角色；参考图像固定托管于 Reddit（i.redd.it），若链接失效将直接影响功能。

2. 外部依赖性强：功能完全依赖 FAL API 的可用性与配额，以及 Telegram Bot 的网络连通性；无本地降级方案。

3. T3 来源风险：由个人开发者（swancho）维护，虽代码开源透明，但长期维护承诺与供应链安全需用户自行评估。

4. 无内置内容过滤：虽角色风格固定，但用户输入的 prompt 可能生成不可控内容，依赖下游 API 的审核机制。

适合的目标群体

• 动漫爱好者与角色扮演社群：希望与 AI 角色进行沉浸式互动的用户。
• 个人开发者与极客用户：寻求轻量级、可自托管的图像生成自动化工具。
• Telegram 社群运营者：需要为群组或频道提供趣味互动内容的运营人员。

使用风险

1. API 密钥泄露风险：若环境变量配置不当（如写入 shell 历史记录），可能导致密钥暴露。建议配置至 ~/.bashrc 或 ~/.zshrc 并设置 600 权限。

2. 服务可用性风险：FAL API 或 Telegram API 的服务中断、速率限制或政策变更将直接影响功能。

3. 成本风险：FAL API 调用按量计费，高频使用可能产生意外费用。

4. 合规风险：生成内容的版权归属、角色形象的合理使用（Reze 为《电锯人》版权角色）需用户自行评估当地法律与平台政策。