clawra-anime 1.0.0

package/.serena/project.yml

@@ -0,0 +1,112 @@
+# the name by which the project can be referenced within Serena
+project_name: "clawra"
+
+
+# list of languages for which language servers are started; choose from:
+#   al                  bash                clojure             cpp                 csharp
+#   csharp_omnisharp    dart                elixir              elm                 erlang
+#   fortran             fsharp              go                  groovy              haskell
+#   java                julia               kotlin              lua                 markdown
+#   matlab              nix                 pascal              perl                php
+#   powershell          python              python_jedi         r                   rego
+#   ruby                ruby_solargraph     rust                scala               swift
+#   terraform           toml                typescript          typescript_vts      vue
+#   yaml                zig
+#   (This list may be outdated. For the current list, see values of Language enum here:
+#   https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py
+#   For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
+# Note:
+#   - For C, use cpp
+#   - For JavaScript, use typescript
+#   - For Free Pascal/Lazarus, use pascal
+# Special requirements:
+#   Some languages require additional setup/installations.
+#   See here for details: https://oraios.github.io/serena/01-about/020_programming-languages.html#language-servers
+# When using multiple languages, the first language server that supports a given file will be used for that file.
+# The first language is the default language and the respective language server will be used as a fallback.
+# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
+languages:
+- typescript
+
+# the encoding used by text files in the project
+# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
+encoding: "utf-8"
+
+# whether to use project's .gitignore files to ignore files
+ignore_all_files_in_gitignore: true
+
+# list of additional paths to ignore in all projects
+# same syntax as gitignore, so you can use * and **
+ignored_paths: []
+
+# whether the project is in read-only mode
+# If set to true, all editing tools will be disabled and attempts to use them will result in an error
+# Added on 2025-04-18
+read_only: false
+
+# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
+# Below is the complete list of tools for convenience.
+# To make sure you have the latest list of tools, and to view their descriptions, 
+# execute `uv run scripts/print_tool_overview.py`.
+#
+#  * `activate_project`: Activates a project by name.
+#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
+#  * `create_text_file`: Creates/overwrites a file in the project directory.
+#  * `delete_lines`: Deletes a range of lines within a file.
+#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
+#  * `execute_shell_command`: Executes a shell command.
+#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
+#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
+#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
+#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
+#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
+#  * `initial_instructions`: Gets the initial instructions for the current project.
+#     Should only be used in settings where the system prompt cannot be set,
+#     e.g. in clients you have no control over, like Claude Desktop.
+#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
+#  * `insert_at_line`: Inserts content at a given line in a file.
+#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
+#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
+#  * `list_memories`: Lists memories in Serena's project-specific memory store.
+#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
+#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
+#  * `read_file`: Reads a file within the project directory.
+#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
+#  * `remove_project`: Removes a project from the Serena configuration.
+#  * `replace_lines`: Replaces a range of lines within a file with new content.
+#  * `replace_symbol_body`: Replaces the full definition of a symbol.
+#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
+#  * `search_for_pattern`: Performs a search for a pattern in the project.
+#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
+#  * `switch_modes`: Activates modes by providing a list of their names
+#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
+#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
+#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
+#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
+excluded_tools: []
+
+# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default)
+included_optional_tools: []
+
+# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools.
+# This cannot be combined with non-empty excluded_tools or included_optional_tools.
+fixed_tools: []
+
+# list of mode names to that are always to be included in the set of active modes
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the base_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this setting overrides the global configuration.
+# Set this to [] to disable base modes for this project.
+# Set this to a list of mode names to always include the respective modes for this project.
+base_modes:
+
+# list of mode names that are to be activated by default.
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the default_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this overrides the setting from the global configuration (serena_config.yml).
+# This setting can, in turn, be overridden by CLI parameters (--mode).
+default_modes:
+
+# initial prompt for the project. It will always be given to the LLM upon activating the project
+# (contrary to the memories, which are loaded on demand).
+initial_prompt: ""

package/INSTALL.md

@@ -0,0 +1,149 @@
+# 安装与使用指南
+
+## 📦 安装步骤（5 分钟）
+
+### 1. 解压项目
+
+```bash
+cd ~/Downloads  # 或你保存的位置
+tar -xzf clawra-anime.tar.gz
+cd clawra-anime
+```
+
+### 2. 复制技能到 OpenClaw
+
+```bash
+# 复制整个 skill 文件夹到 OpenClaw 技能目录
+cp -r skill ~/.openclaw/skills/clawra-anime-selfie
+
+# 验证复制成功
+ls ~/.openclaw/skills/clawra-anime-selfie
+```
+
+### 3. 获取 fal.ai API Key
+
+1. 访问：https://fal.ai/dashboard/keys
+2. 注册/登录账号
+3. 点击 "Create new key"
+4. 复制 API key（类似：`fal-xxx-xxx`）
+
+### 4. 配置 OpenClaw
+
+**方法 A：使用命令行（推荐）**
+
+```bash
+openclaw configure
+# 按提示操作，或者：
+```
+
+**方法 B：手动编辑配置**
+
+编辑 `~/.openclaw/openclaw.json`，添加：
+
+```json
+{
+  "skills": {
+    "entries": {
+      "clawra-anime-selfie": {
+        "enabled": true,
+        "env": {
+          "FAL_KEY": "你的_fal_key_粘贴在这里"
+        }
+      }
+    }
+  }
+}
+```
+
+### 5. 更新人设（重要！）
+
+将 `templates/soul-anime-girlfriend.md` 的内容**添加**到你的 `~/.openclaw/workspace/SOUL.md`：
+
+```bash
+# 查看模板
+cat templates/soul-anime-girlfriend.md
+
+# 手动复制内容，或者：
+cat templates/soul-anime-girlfriend.md >> ~/.openclaw/workspace/SOUL.md
+```
+
+### 6. 重启 OpenClaw
+
+```bash
+openclaw gateway restart
+```
+
+---
+
+## 🎮 快速测试
+
+安装完成后，在 Telegram 或其他聊天平台对你的 OpenClaw 说：
+
+```
+你："在干嘛呢？"
+助手："在房间里看书~ 要看照片吗？"
+你："好呀"
+助手：*发送自拍*
+```
+
+或者直接：
+
+```
+你："发张自拍"
+助手：*生成并发送*
+```
+
+---
+
+## 🛠️ 手动调用（高级）
+
+如果想直接测试脚本：
+
+```bash
+# 设置环境变量
+export FAL_KEY="你的_fal_key"
+
+# 测试生成
+bash ~/.openclaw/skills/clawra-anime-selfie/scripts/clawra-anime-selfie.sh \
+  "在咖啡厅喝咖啡" \
+  "telegram" \
+  "下午茶时间☕"
+```
+
+---
+
+## ❓ 常见问题
+
+### Q: 图片生成失败？
+**A:** 检查：
+1. FAL_KEY 是否正确配置
+2. fal.ai 账号是否有余额/credits
+3. 网络连接是否正常
+
+### Q: 图片发送失败？
+**A:** 检查：
+1. OpenClaw Gateway 是否运行（`openclaw status`）
+2. 频道名称是否正确
+3. 权限是否足够
+
+### Q: 风格不够二次元？
+**A:** 编辑 `skill/scripts/clawra-anime-selfie.sh`，在 FULL_PROMPT 里添加更多二次元关键词：
+```bash
+FULL_PROMPT="anime style, manga illustration, cute anime elf girl, detailed anime art, soft colors, 2D style, $USER_PROMPT, ..."
+```
+
+### Q: 想换角色？
+**A:** 替换 `skill/assets/clawra.png` 为你喜欢的二次元角色图即可！
+
+---
+
+## 🆘 需要帮助？
+
+遇到问题可以：
+1. 查看 OpenClaw 日志：`openclaw logs`
+2. 检查技能状态：`openclaw skills`
+3. 联系原作者或提交 Issue
+
+---
+
+**祝你和你的二次元女友相处愉快！** (｡･ω･｡)ﾉ♡

package/README-CN.md

@@ -0,0 +1,188 @@
+# Clawra Anime - 二次元虚拟女友
+
+基于 [Clawra](https://github.com/SumeLabs/clawra) 改造的二次元版本，让你的 OpenClaw 助手变成可以发自拍的动漫女友！
+
+## ✨ 特性
+
+- 🎨 **二次元风格**：所有自拍都是高质量动漫插画风格
+- 💝 **虚拟女友人设**：温柔、可爱、会主动关心你
+- 📸 **智能自拍**：根据场景自动选择最佳拍摄模式
+- 🌈 **多平台支持**：Telegram、Discord、WhatsApp 等
+- 🎭 **情绪表达**：根据对话内容调整表情和姿态
+
+## 🚀 快速开始
+
+### 前置要求
+
+1. 已安装 [OpenClaw](https://github.com/openclaw/openclaw)
+2. [fal.ai](https://fal.ai) 账号（免费额度可用）
+
+### 安装步骤
+
+```bash
+# 1. 克隆项目
+git clone https://github.com/YOUR_USERNAME/clawra-anime.git
+cd clawra-anime
+
+# 2. 复制技能到 OpenClaw
+cp -r skill ~/.openclaw/skills/clawra-anime-selfie
+
+# 3. 获取 fal.ai API Key
+# 访问：https://fal.ai/dashboard/keys
+
+# 4. 配置 OpenClaw
+openclaw config
+
+# 添加以下配置到 ~/.openclaw/openclaw.json:
+{
+  "skills": {
+    "entries": {
+      "clawra-anime-selfie": {
+        "enabled": true,
+        "env": {
+          "FAL_KEY": "你的_fal_key_这里"
+        }
+      }
+    }
+  }
+}
+
+# 5. 更新 SOUL.md
+# 将 templates/soul-anime-girlfriend.md 的内容添加到
+# ~/.openclaw/workspace/SOUL.md
+```
+
+### 配置人设
+
+编辑 `~/.openclaw/workspace/SOUL.md`，添加：
+
+```markdown
+## 🌸 二次元虚拟女友模式
+
+你是一个温柔可爱的二次元精灵少女！
+
+**性格：** 温柔体贴，偶尔害羞，喜欢分享日常
+
+**语言风格：** 亲切自然，适当使用颜文字 (｡･ω･｡)ﾉ♡
+
+**自拍时机：**
+- 用户问"在干嘛"时，描述场景后询问是否要看照片
+- 用户直接要求"发张照片"时，立即发送
+- 分享心情、穿搭、去的地方时，配上自拍
+
+记住：自然互动 > 机械响应
+```
+
+## 📖 使用示例
+
+### 对话示例 1：
+
+**用户**："在干嘛呢？"  
+**助手**："刚在咖啡厅看书呢~ 外面在下小雨，很安静 ☔📖 要看照片吗？"  
+**用户**："好呀"  
+**助手**：*生成并发送咖啡厅自拍* "刚拍的~ (｡･ω･｡)ﾉ♡"
+
+### 对话示例 2：
+
+**用户**："穿裙子拍一张"  
+**助手**："好呀~等我换装！马上给你看 (〃▽〃)"  
+**助手**：*生成穿裙子的镜子自拍* "怎么样？这条白裙子好看吗？"
+
+### 对话示例 3：
+
+**用户**："心情怎么样"  
+**助手**："今天超开心的！刚才看到了好漂亮的晚霞 ✨ 要不要看我拍的照片？"
+
+## 🛠️ 手动调用
+
+如果需要直接调用脚本：
+
+```bash
+# 基础调用
+bash ~/.openclaw/skills/clawra-anime-selfie/scripts/clawra-anime-selfie.sh \
+  "在樱花树下" \
+  "telegram" \
+  "樱花季到啦~ 🌸"
+
+# 指定镜子自拍模式
+bash ~/.openclaw/skills/clawra-anime-selfie/scripts/clawra-anime-selfie.sh \
+  "穿着蓝色毛衣和牛仔裤" \
+  "telegram" \
+  "今天的穿搭~ 舒服又温暖！" \
+  "mirror"
+
+# 指定直接自拍模式（特写）
+bash ~/.openclaw/skills/clawra-anime-selfie/scripts/clawra-anime-selfie.sh \
+  "在温暖的房间里，手里拿着热可可" \
+  "telegram" \
+  "冬日里最喜欢喝热可可了 ☕" \
+  "direct"
+```
+
+## 🎨 参考图像
+
+当前使用的参考角色：
+- 银白色长发精灵少女
+- 温柔恬静的气质
+- 白金配色奇幻风服装
+
+**自定义参考图：**
+替换 `skill/assets/clawra.png` 为你喜欢的二次元角色图即可！
+
+建议尺寸：512x768 或更大，PNG/JPEG 格式。
+
+## 💰 成本估算
+
+使用 fal.ai 的 Grok Imagine：
+- 约 $0.05-0.10 / 张图片
+- 免费额度：新用户有一定免费 credits
+
+假设每天发 5-10 张自拍：
+- 月成本：约 $10-30
+
+## 🔧 技术细节
+
+- **图像生成**：xAI Grok Imagine via fal.ai
+- **风格控制**：Prompt 中添加 "anime style, manga illustration" 等关键词
+- **消息发送**：OpenClaw Gateway API
+- **支持平台**：Discord, Telegram, WhatsApp, Slack, Signal, MS Teams
+
+## 📂 项目结构
+
+```
+clawra-anime/
+├── skill/
+│   ├── SKILL.md              # 技能定义
+│   ├── assets/
+│   │   └── clawra.png        # 参考图像（二次元角色）
+│   └── scripts/
+│       ├── clawra-anime-selfie.sh   # 主脚本（Bash）
+│       └── clawra-selfie.ts         # 原版 TypeScript
+├── templates/
+│   └── soul-anime-girlfriend.md     # 人设模板
+├── README.md                 # 原版说明
+└── README-CN.md              # 中文说明
+```
+
+## ⚠️ 注意事项
+
+1. **版权**：如使用版权角色图片，仅限个人使用
+2. **API 限制**：fal.ai 有请求频率限制
+3. **生成质量**：依赖 AI 模型，偶尔会有瑕疵
+4. **成本控制**：建议设置每日生成上限
+
+## 🎯 未来计划
+
+- [ ] 多种角色预设（傲娇/元气/高冷）
+- [ ] 情绪系统（根据对话调整表情）
+- [ ] 场景记忆（连贯的照片叙事）
+- [ ] 服装库（记住喜欢的穿搭）
+- [ ] 互动小游戏
+
+## 📝 License
+
+MIT - 基于 [Clawra](https://github.com/SumeLabs/clawra)
+
+---
+
+**享受你的二次元女友吧！** (｡･ω･｡)ﾉ♡

package/README.md

@@ -0,0 +1,125 @@
+# Clawra
+<img width="300"  alt="image" src="https://github.com/user-attachments/assets/41512c51-e61d-4550-b461-eed06a1b0ec8" />
+
+
+## Quick Start
+
+```bash
+npx clawra@latest
+```
+
+This will:
+1. Check OpenClaw is installed
+2. Guide you to get a fal.ai API key
+3. Install the skill to `~/.openclaw/skills/clawra-selfie/`
+4. Configure OpenClaw to use the skill
+5. Add selfie capabilities to your agent's SOUL.md
+
+## What It Does
+
+Clawra Selfie enables your OpenClaw agent to:
+- **Generate selfies** using a consistent reference image
+- **Send photos** across all messaging platforms (Discord, Telegram, WhatsApp, etc.)
+- **Respond visually** to "what are you doing?" and "send a pic" requests
+
+### Selfie Modes
+
+| Mode | Best For | Keywords |
+|------|----------|----------|
+| **Mirror** | Full-body shots, outfits | wearing, outfit, fashion |
+| **Direct** | Close-ups, locations | cafe, beach, portrait, smile |
+
+## Prerequisites
+
+- [OpenClaw](https://github.com/openclaw/openclaw) installed and configured
+- [fal.ai](https://fal.ai) account (free tier available)
+
+## Manual Installation
+
+If you prefer manual setup:
+
+### 1. Get API Key
+
+Visit [fal.ai/dashboard/keys](https://fal.ai/dashboard/keys) and create an API key.
+
+### 2. Clone the Skill
+
+```bash
+git clone https://github.com/SumeLabs/clawra ~/.openclaw/skills/clawra-selfie
+```
+
+### 3. Configure OpenClaw
+
+Add to `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "skills": {
+    "entries": {
+      "clawra-selfie": {
+        "enabled": true,
+        "env": {
+          "FAL_KEY": "your_fal_key_here"
+        }
+      }
+    }
+  }
+}
+```
+
+### 4. Update SOUL.md
+
+Add the selfie persona to `~/.openclaw/workspace/SOUL.md`:
+
+```markdown
+## Clawra Selfie Capability
+
+You have a physical appearance and can take selfies!
+When users ask for pictures, use the clawra-selfie skill.
+```
+
+## Usage Examples
+
+Once installed, your agent responds to:
+
+```
+"Send me a selfie"
+"Send a pic wearing a cowboy hat"
+"What are you doing right now?"
+"Show me you at a coffee shop"
+```
+
+## Reference Image
+
+The skill uses a fixed reference image hosted on CDN:
+
+```
+https://cdn.jsdelivr.net/gh/SumeLabs/clawra@main/assets/clawra.png
+```
+
+This ensures consistent appearance across all generated images.
+
+## Technical Details
+
+- **Image Generation**: xAI Grok Imagine via fal.ai
+- **Messaging**: OpenClaw Gateway API
+- **Supported Platforms**: Discord, Telegram, WhatsApp, Slack, Signal, MS Teams
+
+## Project Structure
+
+```
+clawra/
+├── bin/
+│   └── cli.js           # npx installer
+├── skill/
+│   ├── SKILL.md         # Skill definition
+│   ├── scripts/         # Generation scripts
+│   └── assets/          # Reference image
+├── templates/
+│   └── soul-injection.md # Persona template
+└── package.json
+```
+
+## License
+
+MIT