坤典智慧农场
111.81M · 2026-02-18
这是"一天一个开源项目"系列的第25篇文章。今天带你了解的项目是 Clawra（GitHub），由 SumeLabs 开源。来剖析下号称电子女友的开项目项目，到底有哪些功能。
OpenClaw 通过 T@elegrimm、Discord、WhatsApp 等渠道与你对话，但默认能力以文本为主。若希望助手具备「形象」、能响应「发张自拍」「你现在在干嘛？发张图」这类请求，就需要图像生成 + 与渠道发图的能力。Clawra 是一个 OpenClaw Skill：基于 fal.ai 调用 xAI Grok Imagine，用一张固定参考图（reference image）保持形象一致，按用户描述生成「自拍」并通过 OpenClaw Gateway 在对应平台发送。一条 npx clawra@latest 即可完成检查、获取 fal.ai Key、安装 Skill、配置与 SOUL.md 注入，让助手支持 Mirror（全身/穿搭）与 Direct（近景/场景）两种自拍模式。
npx clawra@latest 与手动安装、配置 openclaw.json 与 SOUL.md~/.openclaw/skills/、通过 openclaw.json 启用）Clawra 是面向 OpenClaw 的 Skill（技能），为 AI 助手增加基于固定参考形象的自拍生成与多渠道发图能力。用户可以说「发张自拍」「发一张戴牛仔帽的」「你现在在咖啡馆，发张图」等，助手会通过本 Skill 调用 fal.ai 的 xAI Grok Imagine 生成与参考图一致的图像，并经由 OpenClaw Gateway 在 T@elegrimm、Discord、WhatsApp、Slack、Signal、MS Teams 等渠道以图片形式回复。Skill 提供 Mirror（全身、穿搭）与 Direct（近景、场景）两种模式，便于适配不同提示词；参考图托管在 CDN，保证生成形象一致。
项目解决的核心问题：
面向的用户群体：
npx clawra@latest 使用最新安装逻辑Clawra 的核心作用是在 OpenClaw 上增加「自拍」能力：
SOUL.md 注入「你有实体形象、可以自拍」的说明，使助手在对话中主动使用该 Skill陪伴/人设类助手
穿搭/造型展示
场景化回复
多平台统一体验
学习 Skill 与图像 API
前置：已安装并配置 OpenClaw；拥有 fal.ai 账号并可在 fal.ai/dashboard/k… 创建 API Key（有免费档）。
一键安装（推荐）：
npx clawra@latest
脚本会：检查 OpenClaw 是否已安装、引导获取 fal.ai API Key、将 Skill 安装到 ~/.openclaw/skills/clawra-selfie/、在 openclaw.json 中启用并写入 FAL_KEY、向 SOUL.md 注入自拍能力说明。
手动安装：
# 1. 在 fal.ai 创建 API Key
# 2. 克隆 Skill
git clone ~/.openclaw/skills/clawra-selfie
# 3. 在 ~/.openclaw/openclaw.json 的 skills.entries 中添加：
# "clawra-selfie": { "enabled": true, "env": { "FAL_KEY": "你的_fal_key" } }
# 4. 在 ~/.openclaw/workspace/SOUL.md 中增加自拍能力说明（见 README 模板）
安装并重启 Gateway 后，在任意已配置渠道对助手说「发张自拍」「发一张戴牛仔帽的」「你现在在咖啡馆，发张图」等即可触发生成与发图。
固定参考图
Mirror / Direct 双模式
fal.ai + Grok Imagine
OpenClaw 原生集成
SOUL.md 人设注入
| 对比项 | Clawra + OpenClaw | 纯文本 OpenClaw | 独立图像 Bot + 聊天 Bot |
|---|---|---|---|
| 发图能力 | 按人设生成并直接发到当前会话 | 无 | 需两套 Bot 或手动转发 |
| 形象一致性 | 固定参考图 + Grok Imagine | - | 视实现而定 |
| 部署与配置 | 一条 npx + fal Key | 同 OpenClaw | 多套配置 |
| 渠道覆盖 | 复用 OpenClaw 已配置渠道 | 同左 | 需逐渠道对接 |
为什么选择 Clawra？
clawra/
├── bin/
│ └── cli.js # npx 安装器入口
├── skill/
│ ├── SKILL.md # Skill 定义（能力描述、触发方式等）
│ ├── scripts/ # 生成与调用逻辑
│ └── assets/ # 参考图等资源
├── templates/
│ └── soul-injection.md # 注入 SOUL.md 的模板
└── package.json
npx clawra@latest 执行时运行，负责环境检查、引导 fal Key、克隆/安装 skill、写 openclaw.json、注入 SOULFAL_KEY 在 openclaw.json 的 skills.entries["clawra-selfie"].env 中配置，由安装脚本或手动填写assets/clawra.png 的 CDN 地址；若 fork 后想用自己的形象，可替换该资源并更新引用欢迎来我中的个人主页找到更多有用的知识和有趣的产品
