clawra-anime 1.0.1 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +116 -85
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,15 +1,21 @@
1
- # Clawra Anime - 二次元虚拟女友 🌸
1
+ # Clawra Anime 🌸
2
2
 
3
3
  [![npm version](https://img.shields.io/npm/v/clawra-anime)](https://www.npmjs.com/package/clawra-anime)
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
5
5
 
6
- 让你的 OpenClaw 助手变成可以发自拍的二次元女友!基于 [Clawra](https://github.com/SumeLabs/clawra) 改造。
6
+ Turn your OpenClaw assistant into an anime virtual girlfriend who can send selfies!
7
7
 
8
- **特色:**
9
- - 🎨 动漫风格自拍生成
10
- - 💝 温柔可爱的虚拟女友人设
11
- - 📸 智能场景识别(镜子/直接自拍)
12
- - 🌈 全平台支持(Telegram/Discord/WhatsApp 等)
8
+ Forked from [SumeLabs/clawra](https://github.com/SumeLabs/clawra) with anime-style enhancements.
9
+
10
+ ---
11
+
12
+ ## Features
13
+
14
+ - 🎨 **Anime-style selfie generation** using AI
15
+ - 💝 **Virtual girlfriend persona** - gentle, cute, caring
16
+ - 📸 **Smart scene detection** - auto-selects best selfie mode
17
+ - 🌈 **Multi-platform support** - Telegram, Discord, WhatsApp, etc.
18
+ - 🎭 **Emotional expressions** - adjusts mood based on conversation
13
19
 
14
20
  ---
15
21
 
@@ -19,119 +25,144 @@
19
25
  npx clawra-anime@latest
20
26
  ```
21
27
 
22
- 这会自动:
23
- 1. 检查 OpenClaw 是否安装
24
- 2. 引导你获取 fal.ai API key
25
- 3. 安装技能到 `~/.openclaw/skills/clawra-anime-selfie/`
26
- 4. 配置 OpenClaw
27
- 5. 添加二次元女友人设到 SOUL.md
28
+ This will:
29
+ 1. Check if OpenClaw is installed
30
+ 2. Guide you to get a fal.ai API key
31
+ 3. Install the skill to `~/.openclaw/skills/clawra-anime-selfie/`
32
+ 4. Configure OpenClaw automatically
33
+ 5. Add anime girlfriend persona to your agent's SOUL.md
28
34
 
29
- ## ✨ 功能特性
35
+ ---
30
36
 
31
- Clawra Anime 让你的 OpenClaw 助手能够:
32
- - **生成二次元风格自拍** - 使用固定的精灵少女角色
33
- - **跨平台发送照片** - Discord、Telegram、WhatsApp 等
34
- - **智能场景响应** - "在干嘛?"、"发张照片" 等自然对话
35
- - **虚拟女友互动** - 温柔可爱的回复风格,适当使用颜文字
37
+ ## 💬 What It Does
36
38
 
37
- ### 📸 自拍模式
39
+ Clawra Anime enables your OpenClaw agent to:
38
40
 
39
- | 模式 | 适用场景 | 触发关键词 |
40
- |------|----------|-----------|
41
- | **镜子自拍** | 全身照、展示服装 | 穿着、outfit、衣服、dress |
42
- | **直接自拍** | 特写、场景照 | 咖啡厅、beach、微笑、地点 |
41
+ - **Generate anime-style selfies** with consistent character design
42
+ - **Send photos** across all messaging platforms (Discord, Telegram, WhatsApp, etc.)
43
+ - **Respond visually** to "what are you doing?" and "send a pic" requests
44
+ - **Virtual girlfriend interactions** - warm replies with cute emoticons
43
45
 
44
- ## Prerequisites
46
+ ---
45
47
 
46
- - [OpenClaw](https://github.com/openclaw/openclaw) installed and configured
47
- - [fal.ai](https://fal.ai) account (free tier available)
48
+ ## 📸 Selfie Modes
48
49
 
49
- ## Manual Installation
50
+ | Mode | Best For | Keywords |
51
+ |------|----------|----------|
52
+ | **Mirror** | Full-body shots, outfits | wearing, outfit, clothes, dress |
53
+ | **Direct** | Close-ups, locations | cafe, beach, smile, location |
50
54
 
51
- If you prefer manual setup:
55
+ ---
52
56
 
53
- ### 1. Get API Key
57
+ ## 📋 Prerequisites
58
+
59
+ - [OpenClaw](https://github.com/openclaw/openclaw) installed and configured
60
+ - [fal.ai](https://fal.ai) account (free tier available)
54
61
 
55
- Visit [fal.ai/dashboard/keys](https://fal.ai/dashboard/keys) and create an API key.
62
+ ---
56
63
 
57
- ### 2. Clone the Skill
64
+ ## 📖 Usage Examples
58
65
 
59
- ```bash
60
- git clone https://github.com/SumeLabs/clawra ~/.openclaw/skills/clawra-selfie
66
+ ### Example 1: Basic Request
67
+ ```
68
+ User: "Send me a selfie"
69
+ Assistant: [generates anime selfie] "Just took this! (。・ω・。)ノ♡"
61
70
  ```
62
71
 
63
- ### 3. Configure OpenClaw
64
-
65
- Add to `~/.openclaw/openclaw.json`:
66
-
67
- ```json
68
- {
69
- "skills": {
70
- "entries": {
71
- "clawra-selfie": {
72
- "enabled": true,
73
- "env": {
74
- "FAL_KEY": "your_fal_key_here"
75
- }
76
- }
77
- }
78
- }
79
- }
72
+ ### Example 2: Scene-Specific
73
+ ```
74
+ User: "What are you doing?"
75
+ Assistant: "Reading at a cafe~ Want to see a photo?"
76
+ User: "Yes!"
77
+ Assistant: [sends cafe selfie] "Here you go ☕"
80
78
  ```
81
79
 
82
- ### 4. Update SOUL.md
80
+ ### Example 3: Outfit
81
+ ```
82
+ User: "Take a pic wearing a dress"
83
+ Assistant: [generates mirror selfie] "How do I look? (*^▽^*)"
84
+ ```
83
85
 
84
- Add the selfie persona to `~/.openclaw/workspace/SOUL.md`:
86
+ ---
85
87
 
86
- ```markdown
87
- ## Clawra Selfie Capability
88
+ ## 🎨 Character Reference
88
89
 
89
- You have a physical appearance and can take selfies!
90
- When users ask for pictures, use the clawra-selfie skill.
91
- ```
90
+ The current anime character:
91
+ - Silver-white long hair (side braid)
92
+ - Gentle green eyes
93
+ - Elf ears
94
+ - White and gold fantasy outfit
92
95
 
93
- ## Usage Examples
96
+ **Want to customize?** Replace `skill/assets/clawra.png` with your preferred anime character image!
94
97
 
95
- Once installed, your agent responds to:
98
+ ---
96
99
 
97
- ```
98
- "Send me a selfie"
99
- "Send a pic wearing a cowboy hat"
100
- "What are you doing right now?"
101
- "Show me you at a coffee shop"
102
- ```
100
+ ## 💰 Cost
103
101
 
104
- ## Reference Image
102
+ Using fal.ai Grok Imagine:
103
+ - ~$0.05-0.10 per image
104
+ - Free tier: New users get free credits
105
105
 
106
- The skill uses a fixed reference image hosted on CDN:
106
+ Estimated monthly cost (5-10 selfies/day):
107
+ - ~$10-30/month
107
108
 
108
- ```
109
- https://cdn.jsdelivr.net/gh/SumeLabs/clawra@main/assets/clawra.png
110
- ```
109
+ ---
110
+
111
+ ## 🛠️ Manual Installation
111
112
 
112
- This ensures consistent appearance across all generated images.
113
+ See [INSTALL.md](INSTALL.md) for detailed manual installation instructions.
113
114
 
114
- ## Technical Details
115
+ ---
116
+
117
+ ## 🔧 Technical Details
115
118
 
116
119
  - **Image Generation**: xAI Grok Imagine via fal.ai
120
+ - **Style**: Anime/manga illustration
117
121
  - **Messaging**: OpenClaw Gateway API
118
- - **Supported Platforms**: Discord, Telegram, WhatsApp, Slack, Signal, MS Teams
122
+ - **Platforms**: Discord, Telegram, WhatsApp, Slack, Signal, MS Teams
123
+
124
+ ---
119
125
 
120
- ## Project Structure
126
+ ## 📂 Project Structure
121
127
 
122
128
  ```
123
- clawra/
124
- ├── bin/
125
- │ └── cli.js # npx installer
129
+ clawra-anime/
126
130
  ├── skill/
127
- │ ├── SKILL.md # Skill definition
128
- │ ├── scripts/ # Generation scripts
129
- │ └── assets/ # Reference image
131
+ │ ├── SKILL.md # Skill definition
132
+ │ ├── assets/
133
+ └── clawra.png # Anime character reference
134
+ │ └── scripts/
135
+ │ └── clawra-anime-selfie.sh # Main generation script
130
136
  ├── templates/
131
- │ └── soul-injection.md # Persona template
132
- └── package.json
137
+ │ └── soul-waifu-persona.md # Virtual girlfriend persona
138
+ ├── README.md
139
+ └── INSTALL.md
133
140
  ```
134
141
 
135
- ## License
142
+ ---
143
+
144
+ ## 🤝 Contributing
145
+
146
+ Contributions welcome! Feel free to:
147
+ - Report bugs
148
+ - Suggest features
149
+ - Submit pull requests
150
+ - Share your character customizations
151
+
152
+ ---
153
+
154
+ ## 📝 License
155
+
156
+ MIT License - Fork of [SumeLabs/clawra](https://github.com/SumeLabs/clawra)
157
+
158
+ ---
159
+
160
+ ## 🙏 Credits
161
+
162
+ - Original Clawra: [SumeLabs](https://github.com/SumeLabs)
163
+ - Image Generation: [fal.ai](https://fal.ai)
164
+ - OpenClaw: [OpenClaw Project](https://github.com/openclaw/openclaw)
165
+
166
+ ---
136
167
 
137
- MIT
168
+ **Enjoy your anime virtual girlfriend!** (。・ω・。)ノ♡
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "clawra-anime",
3
- "version": "1.0.1",
4
- "description": "Anime virtual girlfriend for OpenClaw - Generate anime-style selfies with AI",
3
+ "version": "1.0.2",
4
+ "description": "Anime virtual girlfriend for OpenClaw - AI-powered anime selfie generation",
5
5
  "main": "skill/SKILL.md",
6
6
  "bin": {
7
7
  "clawra-anime": "./bin/cli.js"