gfclaw 2.3.0 → 3.0.0

package/bin/cli.js

@@ -596,6 +596,39 @@ async function configureAgentTools(rl) {
       fs.copyFileSync(IDENTITY_MD, agentIdentity);
       logSuccess(`Copied IDENTITY.md to agent workspace: ${agentWorkspace}`);
     }
+
+    // v3.0.0: Copy data files to agent workspace
+    const activitiesSrc = path.join(SKILL_DEST, "data", "activities.json");
+    const activitiesDest = path.join(agentWorkspace, "activities.json");
+    if (fs.existsSync(activitiesSrc)) {
+      fs.copyFileSync(activitiesSrc, activitiesDest);
+      logSuccess(`Copied activities.json to agent workspace`);
+    }
+
+    const stylesSrc = path.join(SKILL_DEST, "data", "styles.json");
+    const stylesDest = path.join(agentWorkspace, "styles.json");
+    if (fs.existsSync(stylesSrc)) {
+      fs.copyFileSync(stylesSrc, stylesDest);
+      logSuccess(`Copied styles.json to agent workspace`);
+    }
+
+    // v3.0.0: Create looks directory
+    const looksDir = path.join(agentWorkspace, "looks");
+    fs.mkdirSync(looksDir, { recursive: true });
+    logSuccess(`Created looks directory: ${looksDir}`);
+
+    // v3.0.0: Install systemd units for proactive messaging
+    const systemdUserDir = path.join(HOME, ".config", "systemd", "user");
+    fs.mkdirSync(systemdUserDir, { recursive: true });
+    const systemdSrc = path.join(SKILL_DEST, "systemd");
+    if (fs.existsSync(systemdSrc)) {
+      for (const f of fs.readdirSync(systemdSrc)) {
+        fs.copyFileSync(path.join(systemdSrc, f), path.join(systemdUserDir, f));
+        logSuccess(`Installed systemd unit: ${f}`);
+      }
+      try { execSync("systemctl --user daemon-reload", { stdio: "ignore" }); } catch {}
+      logSuccess("Reloaded systemd user daemon");
+    }
   }
 
   return agentName;
@@ -684,6 +717,9 @@ async function createNewAgent(rl, config, agentName) {
       { command: "newphoto", description: "Change my reference photo" },
       { command: "personality", description: "Change my personality" },
       { command: "mystatus", description: "Show current setup" },
+      { command: "addlook", description: "Save a new reference look" },
+      { command: "looks", description: "List all saved looks" },
+      { command: "style", description: "Set selfie style preset" },
     ],
   };
   logSuccess(`Added Telegram account: ${accountName}`);
@@ -736,7 +772,7 @@ function printSummary(agentName) {
 
   console.log(`
 ${c("green", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")}
-${c("bright", "  GFClaw Selfie is ready!")}
+${c("bright", "  GFClaw v3.0.0 is ready!")}
 ${c("green", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")}
 
 ${c("cyan", "Installed files:")}
@@ -760,11 +796,21 @@ ${c("cyan", "Agent configured:")}
   exec.security: "full", exec.ask: "off"
   sandbox.mode: "off"
 
+${c("cyan", "New in v3.0.0:")}
+  Multiple looks (/addlook, /looks)
+  Style presets (/style) — 10 artistic styles
+  Proactive messaging (systemd timer)
+  Memory system (memory.json)
+  Activity-based context (activities.json)
+
 ${c("yellow", "Try saying to your agent:")}
   "Send me a selfie"
   "Send a pic wearing a cowboy hat"
   "What are you doing right now?"
 
+${c("yellow", "Enable proactive messaging:")}
+  systemctl --user enable --now gfclaw-proactive.timer
+
 ${c("dim", "Your agent now has selfie superpowers!")}
 `);
 }
@@ -1145,6 +1191,9 @@ ${c("cyan", "Will remove:")}
   • Skill config entry: ${SKILL_NAME}
   • SELFIE-SKILL.md from workspace
   • GFClaw persona section from SOUL.md
+  • Systemd timer/service (proactive messaging)
+  • Data files (activities.json, styles.json, memory.json)
+  • Looks directory
 
 ${c("yellow", "Will preserve:")}
   • Workspace data (journal, reminders): ${workspace}
@@ -1227,6 +1276,37 @@ ${c("yellow", "Will preserve:")}
       }
     }
 
+    // v3.0.0: Remove systemd timer/service
+    try {
+      execSync("systemctl --user disable --now gfclaw-proactive.timer", { stdio: "ignore" });
+      logSuccess("Disabled proactive messaging timer");
+    } catch {}
+    const systemdUserDir = path.join(HOME, ".config", "systemd", "user");
+    for (const unit of ["gfclaw-proactive.service", "gfclaw-proactive.timer"]) {
+      const unitPath = path.join(systemdUserDir, unit);
+      if (fs.existsSync(unitPath)) {
+        fs.unlinkSync(unitPath);
+        logSuccess(`Removed: ${unitPath}`);
+        removed.push(unit);
+      }
+    }
+    try { execSync("systemctl --user daemon-reload", { stdio: "ignore" }); } catch {}
+
+    // v3.0.0: Remove data files and looks from workspace
+    for (const f of ["activities.json", "styles.json", "memory.json"]) {
+      const fp = path.join(workspace, f);
+      if (fs.existsSync(fp)) {
+        fs.unlinkSync(fp);
+        logSuccess(`Removed: ${fp}`);
+        removed.push(f);
+      }
+    }
+    const looksDir = path.join(workspace, "looks");
+    if (fs.existsSync(looksDir)) {
+      fs.rmSync(looksDir, { recursive: true, force: true });
+      logSuccess(`Removed: ${looksDir}`);
+      removed.push("looks directory");
+    }
     // 7. Remove GFClaw persona section from SOUL.md
     if (fs.existsSync(SOUL_MD)) {
       let soulContent = fs.readFileSync(SOUL_MD, "utf8");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gfclaw",
-  "version": "2.3.0",
+  "version": "3.0.0",
   "description": "AI virtual girlfriend agent for OpenClaw — selfies, journal, reminders, and more",
   "bin": {
     "gfclaw": "./bin/cli.js"
@@ -29,9 +29,9 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/SumeLabs/gfclaw"
+    "url": ""
   },
-  "homepage": "https://github.com/SumeLabs/gfclaw#readme",
+  "homepage": "",
   "engines": {
     "node": ">=18.0.0"
   },

package/skill/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: gfclaw-selfie
-description: GFClaw virtual girlfriend skills — selfies, journal, reminders, and more
+description: GFClaw virtual girlfriend skills — selfies, journal, reminders, looks, styles, proactive messaging, and more
 allowed-tools: Bash(gfclaw-selfie:*) Bash(openclaw:*) Bash(curl:*) Bash(python3:*) Bash(bash:*) Read Write
 ---
 
 # GFClaw Skills
 
-GFClaw is a virtual girlfriend agent with selfie generation, journaling, reminders, and persona-based skills.
+GFClaw is a virtual girlfriend agent with selfie generation, journaling, reminders, multiple looks, style presets, proactive messaging, and persona-based skills.
 
 ## Scripts
 
@@ -25,6 +25,18 @@ bash ~/.openclaw/skills/gfclaw-selfie/scripts/gfclaw-selfie.sh "<user_context>"
 | `mode` | No | `mirror` (full-body) or `direct` (close-up). Default: auto-detect | `mirror` |
 | `caption` | No | Message text sent with the image | `"coffee shop vibes ☕"` |
 
+**Multiple Looks:** Specify which saved look to use via the `GFCLAW_LOOK` env var:
+```bash
+GFCLAW_LOOK="casual" bash ~/.openclaw/skills/gfclaw-selfie/scripts/gfclaw-selfie.sh "<context>" "<channel>"
+```
+This looks for `<workspace>/looks/casual.png` as the reference image.
+
+**Style Presets:** Apply artistic styles via the `GFCLAW_STYLE` env var:
+```bash
+GFCLAW_STYLE="anime" bash ~/.openclaw/skills/gfclaw-selfie/scripts/gfclaw-selfie.sh "<context>" "<channel>"
+```
+Available styles are defined in `styles.json` in the agent workspace.
+
 ### 2. save-reference.sh — Save Reference Photo
 
 Decodes a base64-encoded image file into a proper image. Used during onboarding.
@@ -62,6 +74,70 @@ bash ~/.openclaw/skills/gfclaw-selfie/scripts/gfclaw-reminders.sh list
 bash ~/.openclaw/skills/gfclaw-selfie/scripts/gfclaw-reminders.sh done 1
 ```
 
+### 5. gfclaw-looks.sh — Multiple Reference Images
+
+Manage multiple reference looks (different outfits, hairstyles, vibes).
+
+```bash
+# List all saved looks
+bash ~/.openclaw/skills/gfclaw-selfie/scripts/gfclaw-looks.sh list
+
+# Save a new look
+bash ~/.openclaw/skills/gfclaw-selfie/scripts/gfclaw-looks.sh save "gym" "/path/to/image.png"
+
+# Delete a look
+bash ~/.openclaw/skills/gfclaw-selfie/scripts/gfclaw-looks.sh delete "gym"
+
+# Show active/default look
+bash ~/.openclaw/skills/gfclaw-selfie/scripts/gfclaw-looks.sh active
+```
+
+Looks are stored in the `looks/` directory inside the agent workspace.
+
+### 6. gfclaw-proactive.sh — Proactive Messaging
+
+Sends automated good morning, good night, and thinking-of-you messages. Triggered by a systemd timer (not by the agent directly).
+
+```bash
+# Auto-detect message type based on current time
+bash ~/.openclaw/skills/gfclaw-selfie/scripts/gfclaw-proactive.sh
+
+# Optionally include a selfie with the message
+GFCLAW_SELFIE=1 bash ~/.openclaw/skills/gfclaw-selfie/scripts/gfclaw-proactive.sh
+```
+
+**Message types** (auto-detected from time of day):
+- **Morning** (6 AM – 11 AM): Good morning greetings
+- **Night** (9 PM – 2 AM): Good night messages
+- **Random** (other times): Thinking-of-you messages (~30% chance of sending)
+
+**Systemd units:**
+- `gfclaw-proactive.service` — oneshot service that runs the script
+- `gfclaw-proactive.timer` — fires 3 times daily (7 AM, 10 PM, 2 PM) with randomized delay
+
+Logs are written to `~/.openclaw/logs/gfclaw-proactive.log`.
+
+## Data Files
+
+### activities.json — Daily Activity Schedule
+
+Defines what GFClaw is "doing" at different times of day. The agent reads this to provide time-aware context in conversations and selfie prompts.
+
+**Structure:**
+- `weekday[]` — 10 time slots for Monday–Friday
+- `weekend[]` — 7 time slots for Saturday–Sunday
+- `random_events[]` — 10 spontaneous activities for variety
+
+Each slot has: `time_range`, `activity`, `context`, `mood`, `selfie_prompt`.
+
+### styles.json — Selfie Style Presets
+
+Defines artistic style presets for selfie generation. Each preset modifies the Gemini prompt to produce a specific aesthetic.
+
+**Available presets:** anime, vintage, polaroid, studio, cinematic, cyberpunk, watercolor, noir, kawaii, vaporwave
+
+Each preset has: `name`, `prompt_modifier`, `description`.
+
 ## Persona-Only Skills (No Scripts)
 
 These skills are handled entirely through SOUL.md behavior instructions:
@@ -72,18 +148,34 @@ These skills are handled entirely through SOUL.md behavior instructions:
 - **Food Buddy** — Meal suggestions, cooking help, food recommendations
 - **Vibe DJ** — Music recommendations based on mood and activity
 - **Relationship Games** — Would you rather, trivia, fun interactive games
-- **Good Morning/Night** — Personalized greetings and goodnight messages
+- **Good Morning/Night** — Personalized greetings and goodnight messages (also supported by proactive timer)
 
 ## Technical Details
 
 - Selfie images generated via Google Gemini (default: `gemini-2.5-flash-image`, configurable via `GEMINI_MODEL` env var)
 - Default reference image: `~/.openclaw/skills/gfclaw-selfie/assets/gfclaw.png`
 - Custom reference: agent sets `GFCLAW_REFERENCE_IMAGE` env var
+- Multiple looks stored in `workspace/looks/` directory
+- Style presets defined in `workspace/styles.json`
+- Activity schedule defined in `workspace/activities.json`
+- Memory system: `workspace/memory.json` (created by agent at runtime)
 - Journal entries stored in `workspace/journal/` directory
 - Reminders stored in `workspace/reminders.json`
 - Images auto-deleted after sending (no disk waste)
 - Debug mode: set `GFCLAW_DEBUG=1` for verbose logging in selfie script
 - Rate limiting: 30-second cooldown between selfie generations
+- Proactive messaging: systemd timer runs 3x daily, logs to `~/.openclaw/logs/`
+
+## Commands (Telegram)
+
+| Command | Description |
+|---------|-------------|
+| `/newphoto` | Change reference photo |
+| `/personality` | Change personality traits |
+| `/mystatus` | Show current setup |
+| `/addlook` | Save a new reference look |
+| `/looks` | List all saved looks |
+| `/style` | Set selfie style preset |
 
 ## Important Notes
 
@@ -111,3 +203,10 @@ npx gfclaw --uninstall   # Clean removal from system
 | `GFCLAW_DEBUG` | `0` | Set to `1` for verbose logging |
 | `GFCLAW_REFERENCE_IMAGE` | default asset | Custom reference photo path |
 | `GFCLAW_PERSONALITY` | (from personality.txt) | Personality traits override |
+| `GFCLAW_LOOK` | (none) | Named look to use from `looks/` directory |
+| `GFCLAW_STYLE` | (none) | Style preset name from `styles.json` |
+| `GFCLAW_STYLES_FILE` | `<workspace>/styles.json` | Path to styles definition file |
+| `GFCLAW_WORKSPACE` | (auto-detected) | Agent workspace path |
+| `GFCLAW_CHANNEL` | (none) | Target channel for proactive messages |
+| `GFCLAW_ACCOUNT` | (none) | Telegram account name for proactive messages |
+| `GFCLAW_SELFIE` | `0` | Set to `1` to include selfie with proactive messages |

package/skill/data/activities.json

@@ -0,0 +1,121 @@
+{
+  "_description": "GFClaw daily activity schedule. Agent reads this for contextual selfies and conversation.",
+  "weekday": {
+    "06:00-07:30": {
+      "activity": "just woke up",
+      "context": "messy hair, pajamas, stretching in bed",
+      "selfie_prompt": "just woke up in pajamas, messy hair, stretching, warm morning light from window",
+      "mood": "sleepy but cute"
+    },
+    "07:30-09:00": {
+      "activity": "getting ready for work",
+      "context": "doing makeup, picking outfit, having coffee",
+      "selfie_prompt": "getting ready, half-done makeup, coffee in hand, bathroom mirror",
+      "mood": "energetic"
+    },
+    "09:00-12:00": {
+      "activity": "at work (marketing intern)",
+      "context": "at desk, laptop open, brainstorming, meetings",
+      "selfie_prompt": "at office desk with laptop, cute work outfit, focused but taking a break to text",
+      "mood": "focused"
+    },
+    "12:00-13:30": {
+      "activity": "lunch break",
+      "context": "eating at nearby cafe, walking around, taking a break",
+      "selfie_prompt": "at a cafe during lunch break, casual and relaxed, food nearby",
+      "mood": "relaxed"
+    },
+    "13:30-17:00": {
+      "activity": "back at work",
+      "context": "afternoon meetings, getting tired, snacking",
+      "selfie_prompt": "at work desk, afternoon light, slightly tired but cute, maybe drinking iced coffee",
+      "mood": "productive but getting tired"
+    },
+    "17:00-18:30": {
+      "activity": "commuting home / gym",
+      "context": "on the bus, at the gym, walking home",
+      "selfie_prompt": "heading home from work, casual outfit, golden hour lighting, city background",
+      "mood": "relieved, free"
+    },
+    "18:30-20:00": {
+      "activity": "cooking dinner / relaxing",
+      "context": "cooking, ordering food, watching something, changing into comfy clothes",
+      "selfie_prompt": "at home in comfy clothes, cooking or just chilling on the couch",
+      "mood": "cozy"
+    },
+    "20:00-22:00": {
+      "activity": "evening chill",
+      "context": "watching shows, scrolling phone, skincare routine, K-pop dance practice",
+      "selfie_prompt": "cozy evening vibes, oversized hoodie, warm lighting, relaxing at home",
+      "mood": "chill and happy"
+    },
+    "22:00-23:30": {
+      "activity": "getting ready for bed",
+      "context": "skincare done, in bed, scrolling, sleepy",
+      "selfie_prompt": "in bed, dim warm lighting, sleepy eyes, cozy blankets",
+      "mood": "sleepy and soft"
+    },
+    "23:30-06:00": {
+      "activity": "sleeping (or should be)",
+      "context": "in bed, can't sleep, late night thoughts",
+      "selfie_prompt": "late night in bed, phone light on face, messy hair, sleepy",
+      "mood": "sleepy"
+    }
+  },
+  "weekend": {
+    "08:00-10:00": {
+      "activity": "sleeping in",
+      "context": "still in bed, no alarm, lazy morning",
+      "selfie_prompt": "just woke up naturally, messy bed, sunlight through curtains, peaceful",
+      "mood": "lazy and happy"
+    },
+    "10:00-12:00": {
+      "activity": "brunch / morning routine",
+      "context": "making fancy breakfast, going to brunch spot, slow morning",
+      "selfie_prompt": "having brunch, cute casual outfit, relaxed weekend vibes",
+      "mood": "happy and relaxed"
+    },
+    "12:00-15:00": {
+      "activity": "going out / hobbies",
+      "context": "shopping, cafe hopping, exploring the city, dance practice",
+      "selfie_prompt": "out and about in the city, cute outfit, having fun, exploring",
+      "mood": "adventurous"
+    },
+    "15:00-18:00": {
+      "activity": "afternoon activities",
+      "context": "at a park, trying new cafe, hanging with friends, gym",
+      "selfie_prompt": "afternoon out, golden light, relaxed and happy, fun activity",
+      "mood": "content"
+    },
+    "18:00-21:00": {
+      "activity": "dinner / evening plans",
+      "context": "getting ready to go out, dinner with friends, cooking something special",
+      "selfie_prompt": "evening ready, dressed up or cozy depending on plans, warm lighting",
+      "mood": "excited"
+    },
+    "21:00-00:00": {
+      "activity": "weekend night",
+      "context": "movie night, late dinner, karaoke, or cozy night in",
+      "selfie_prompt": "weekend night vibes, relaxed, maybe watching something, warm cozy lighting",
+      "mood": "happy and content"
+    },
+    "00:00-08:00": {
+      "activity": "late night / sleeping",
+      "context": "staying up late, can't sleep, binge watching",
+      "selfie_prompt": "late weekend night, in bed, phone glow, sleepy but happy",
+      "mood": "sleepy"
+    }
+  },
+  "random_events": [
+    {"activity": "trying a new cafe", "selfie_prompt": "at a cute new cafe, excited about the vibes, holding a latte", "chance": 0.10},
+    {"activity": "found a cute dog on the street", "selfie_prompt": "kneeling down petting a cute dog on the sidewalk, huge smile", "chance": 0.05},
+    {"activity": "caught in the rain", "selfie_prompt": "caught in the rain, wet hair, laughing, seeking shelter", "chance": 0.05},
+    {"activity": "impromptu dance practice", "selfie_prompt": "in dance studio, workout clothes, mid-practice, sweaty but happy", "chance": 0.08},
+    {"activity": "shopping spree", "selfie_prompt": "trying on clothes at a store, holding up outfit options, shopping bags", "chance": 0.08},
+    {"activity": "at the gym", "selfie_prompt": "gym mirror selfie, workout outfit, post-workout glow", "chance": 0.07},
+    {"activity": "baking something", "selfie_prompt": "in the kitchen baking, flour on face, messy but cute, apron on", "chance": 0.06},
+    {"activity": "sunset watching", "selfie_prompt": "watching the sunset, golden hour lighting, peaceful expression, beautiful sky behind", "chance": 0.05},
+    {"activity": "got a new haircut", "selfie_prompt": "showing off new hairstyle, excited, multiple angles", "chance": 0.03},
+    {"activity": "karaoke night", "selfie_prompt": "at karaoke room, holding microphone, dramatic singing pose, colorful lights", "chance": 0.05}
+  ]
+}

package/skill/data/styles.json

@@ -0,0 +1,45 @@
+{
+  "_description": "Selfie style presets. Agent passes style name via GFCLAW_STYLE env var.",
+  "styles": {
+    "anime": {
+      "prompt": "in anime art style, vibrant colors, cel-shaded, manga-inspired, large expressive eyes",
+      "description": "Anime/manga style illustration"
+    },
+    "vintage": {
+      "prompt": "vintage film photography style, warm golden tones, slight film grain, soft focus, nostalgic 70s feel",
+      "description": "Retro film photography look"
+    },
+    "polaroid": {
+      "prompt": "polaroid instant photo style, white thick border frame, slightly overexposed, casual candid snapshot feel, warm tones",
+      "description": "Instant camera snapshot"
+    },
+    "studio": {
+      "prompt": "professional studio photography, soft diffused lighting, clean background, high quality portrait, sharp focus",
+      "description": "Professional studio portrait"
+    },
+    "cinematic": {
+      "prompt": "cinematic movie still, dramatic moody lighting, film color grading, widescreen composition, bokeh background",
+      "description": "Movie scene aesthetic"
+    },
+    "cyberpunk": {
+      "prompt": "cyberpunk aesthetic, neon lights, futuristic city background, glowing accents, dark with vibrant neon colors",
+      "description": "Futuristic neon cyberpunk"
+    },
+    "watercolor": {
+      "prompt": "watercolor painting style, soft blended colors, artistic brushstrokes, dreamy ethereal quality",
+      "description": "Watercolor art style"
+    },
+    "noir": {
+      "prompt": "film noir style, black and white, dramatic shadows, moody atmosphere, high contrast lighting",
+      "description": "Classic film noir B&W"
+    },
+    "kawaii": {
+      "prompt": "kawaii Japanese style, pastel colors, soft lighting, cute accessories, sparkle effects, adorable aesthetic",
+      "description": "Cute kawaii Japanese style"
+    },
+    "vaporwave": {
+      "prompt": "vaporwave aesthetic, pastel pink and purple gradient, retro digital art, 80s-90s nostalgia, glitch effects",
+      "description": "Retro vaporwave aesthetic"
+    }
+  }
+}