引言
“让
助手不仅能聊,还能按一句「发张自拍」生成并发送一张符合人设的图片。
”
这是"一天一个开源项目"系列的第25篇文章。
今天带你了解的项目是Clawra(GitHub),由SumeLabs开源。
来剖析下号称电子女友的开项目项目,到底有哪些功能。
OpenClaw
等渠道与你对话,但默认能力以文本为主。
若希望助手具备「形象」、能响应「发张自拍」「你现在在干嘛?发张图」这类请求,就需要图像生成
+
与渠道发图的能力。
Clawra是一个OpenClaw
Skill:基于fal.ai调用xAI
Grok
Imagine,用一张固定参考图(reference
image)保持形象一致,按用户描述生成「自拍」并通过
OpenClaw
clawra@latest即可完成检查、获取
fal.ai
Direct(近景/场景)两种自拍模式。
你将学到什么
- Clawra
OpenClaw
Skill
- 快速开始:
npx与手动安装、配置clawra@latest
openclaw.json
SOUL.md
- 自拍模式(Mirror
Direct)与参考图机制
- 技术栈:fal.ai、Grok
Imagine、OpenClaw
Gateway、多平台发图
- 与纯文本助手及其他图像生成方案的对比
前置知识
- 已安装并配置
OpenClawInstaller
机制(技能安装在
~/.openclaw/skills/、通过openclaw.json
Key(有免费额度)
/>
项目背景
项目简介
Clawra是面向OpenClaw的Skill(技能),为
助手增加基于固定参考形象的自拍生成与多渠道发图能力。
用户可以说「发张自拍」「发一张戴牛仔帽的」「你现在在咖啡馆,发张图」等,助手会通过本
Skill
Telegram、Discord、WhatsApp、Slack、Signal、MS
Teams
提供Mirror(全身、穿搭)与Direct(近景、场景)两种模式,便于适配不同提示词;参考图托管在
CDN,保证生成形象一致。
项目解决的核心问题:
- OpenClaw
默认以文本为主,无法响应「发图」「自拍」类需求
- 需要与助手「人设」一致的图像生成,而不是随机风格
- 希望生成结果能直接发到当前对话渠道,而非另开工具
面向的用户群体:
- 已使用
OpenClaw、希望给助手增加「有形象、能发图」能力的用户
- 想学习
OpenClaw
多场景自拍」的创意或陪伴类应用场景
作者/团队介绍
- 组织:SumeLabs(GitHub)
- 官网:clawra.dev
- 项目创建时间:2026
月(GitHub
2026-02-08)
项目数据
- ⭐GitHub
Stars
:1.4k+
- 🍴Forks:
259+
- 📦版本:
main
clawra@latest使用最新安装逻辑
- 📄License:
MIT(README
注明)
- 🌐官网:
clawra.dev
- 💬社区:
GitHub
/>
主要功能
核心作用
/>
Clawra
上增加「自拍」能力:
- 一致形象生成:使用
CDN
Imagine)生成与「人设」一致的自拍图
- 多渠道发图:生成的图片通过
OpenClaw
发送到当前会话所在平台(Discord、Telegram、WhatsApp、Slack、Signal、MS
Teams)
- 两种模式:Mirror(全身、穿搭类)与
Direct(近景、场景类),对应不同提示词风格
- 人设注入:安装时可向
SOUL.md注入「你有实体形象、可以自拍」的说明,使助手在对话中主动使用该Skill
使用场景
陪伴/人设类助手
- 用户说「发张自拍」「发一张在沙滩的」,助手生成并回复一张符合设定形象的图
穿搭/造型展示
- 利用
Mirror
模式生成全身或穿搭类图片,用于虚拟形象展示
- 利用
场景化回复
- 「你现在在咖啡馆」→
生成咖啡馆场景近景图并发送,增强情境感
- 「你现在在咖啡馆」→
多平台统一体验
- 同一套
OpenClaw
等任意已配置渠道都能「发图」
- 同一套
学习
Skill
API
- 参考项目结构(SKILL.md、scripts、openclaw.json
配置、SOUL
Skill
- 参考项目结构(SKILL.md、scripts、openclaw.json
快速开始
前置:已安装并配置
OpenClaw;拥有
Key(有免费档)。
一键安装(推荐):
npxclawra@latest
脚本会:检查
OpenClaw
安装到
~/.openclaw/skills/clawra-selfie/、在openclaw.json
注入自拍能力说明。
手动安装:
#fal.ai
Skill
gitclonehttps://github.com/SumeLabs/clawra
~/.openclaw/skills/clawra-selfie#
skills.entries
模板)
安装并重启
Gateway
后,在任意已配置渠道对助手说「发张自拍」「发一张戴牛仔帽的」「你现在在咖啡馆,发张图」等即可触发生成与发图。
核心特性
固定参考图
- 参考图托管在
jsDelivr
CDN,保证每次生成形象一致
- 参考图托管在
Mirror
Direct
双模式
- Mirror:适合全身、穿搭、fashion
类提示(如
outfit)
- Direct:适合近景、场景、肖像(如
cafe,
smile)
- Mirror:适合全身、穿搭、fashion
fal.ai
+
Imagine
- 图像生成走
fal.ai,模型为
有免费额度)
- 图像生成走
OpenClaw
Skill
发图,与现有渠道、记忆、人设一致
- 一致形象生成:使用
SOUL.md
人设注入
- 安装时可选向
SOUL.md
clawra-selfie」,减少重复说明
项目优势
| 对比项 | Clawra+Bot | ||
|---|---|---|---|
| 发图能力 | 按人设生成并直接发到当前会话 | 无 | 需两套Bot或手动转发 |
| 形象一致性 | 固定参考图+Imagine | - | 视实现而定 |
| 部署与配置 | 一条npxOpenClaw | 多套配置 | |
| 渠道覆盖 | 复用OpenClaw已配置渠道 | 同左 | 需逐渠道对接 |
为什么选择
Clawra?
- 即插即用:已有
OpenClaw
时,一条命令即可增加自拍与发图能力
- 人设统一:参考图
+
模式设计,便于维持「同一个形象」的体验
- 开源可改:Skill
结构清晰,可基于此做自己的形象、提示词或接入其他图像
API
/>
项目详细剖析
项目结构
clawra/├──
package.json
- bin/cli.js:
npx执行时运行,负责环境检查、引导clawra@latest
fal
SOUL
- skill/:真正被
OpenClaw
发图
- templates/soul-injection.md:安装时追加到用户
SOUL.md
clawra-selfie」
技术链路简述
- 用户请求:在
Telegram/Discord
等渠道说「发张自拍」「发一张在咖啡店的」
- OpenClaw:将消息交给配置的
LLM,LLM
clawra-selfie
- Clawra
Skill
:根据用户语句与模式(Mirror/Direct)构造提示词,携带参考图URL
Imagine),得到图片
- 发图:通过
OpenClaw
将图片发回当前会话所在渠道
配置要点
- 环境变量:Skill
openclaw.json
的
skills.entries["clawra-selfie"].env中配置,由安装脚本或手动填写 - 参考图:默认使用仓库内
assets/clawra.png的CDN
后想用自己的形象,可替换该资源并更新引用
- SOUL.md:不注入也可通过对话说明「请用
clawra-selfie
发图」,但注入后助手更易自动使用
注意事项
- 依赖
OpenClaw
:必须先安装并运行fal
不要泄露
- 内容与合规:生成内容受
fal.ai
政策约束,请勿用于违规用途
/>
项目地址与资源
官方资源
- 🌟GitHub:
github.com/SumeLabs/clawra
- 🌐官网:
clawra.dev
- 🐛Issues:
GitHub
Issues
相关资源
- OpenClaw
主仓库
- OpenClawInstaller(一键部署
OpenClaw)
- fal.ai(API
Keys(创建
Key)
适用人群
- 已用
OpenClaw
并想加「发图」能力的用户
:一条npx
即可体验自拍与多渠道发图
- 做陪伴/人设类产品的开发者:可参考参考图
+
开发的人:项目结构简单,适合作为第二个
Skill
/>
欢迎来我中的个人主页找到更多有用的知识和有趣的产品


