gfclaw 2.3.0 → 3.0.0

package/skill/scripts/gfclaw-looks.sh

@@ -0,0 +1,249 @@
+#!/bin/bash
+# gfclaw-looks.sh
+# Manage multiple reference image "looks" for GFClaw selfie generation
+#
+# Usage:
+#   ./gfclaw-looks.sh list    [workspace_dir]
+#   ./gfclaw-looks.sh save    <name> <image_path> [workspace_dir]
+#   ./gfclaw-looks.sh delete  <name> [workspace_dir]
+#   ./gfclaw-looks.sh active  [workspace_dir]
+#
+# Looks are stored as <workspace>/looks/<name>.png
+# Set GFCLAW_LOOK=<name> when calling gfclaw-selfie.sh to use a specific look.
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+log_info() {
+    echo -e "${GREEN}[INFO]${NC} $1"
+}
+
+log_warn() {
+    echo -e "${YELLOW}[WARN]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+show_usage() {
+    echo -e "${BLUE}GFClaw Looks Manager${NC}"
+    echo ""
+    echo "Usage:"
+    echo "  $0 list    [workspace_dir]              - List all saved looks"
+    echo "  $0 save    <name> <image_path> [ws_dir]  - Save an image as a named look"
+    echo "  $0 delete  <name> [workspace_dir]        - Delete a named look"
+    echo "  $0 active  [workspace_dir]               - Show current active reference"
+    echo ""
+    echo "Examples:"
+    echo "  $0 list"
+    echo "  $0 save casual ~/photos/casual-outfit.png"
+    echo "  $0 save gym /tmp/gym-look.png ~/.openclaw/workspace-gfclaw"
+    echo "  $0 delete formal"
+    echo "  $0 active"
+    echo ""
+    echo "Then use a look with gfclaw-selfie.sh:"
+    echo "  GFCLAW_LOOK=casual ./gfclaw-selfie.sh 'at the mall' 'tg:401471440'"
+}
+
+# Parse command
+COMMAND="${1:-}"
+if [ -z "$COMMAND" ]; then
+    show_usage
+    exit 1
+fi
+
+# ---- COMMAND: list ----
+cmd_list() {
+    local WORKSPACE="${1:-$HOME/.openclaw/workspace-gfclaw}"
+    local LOOKS_DIR="${WORKSPACE}/looks"
+
+    echo -e "${BLUE}=== Saved Looks ===${NC}"
+    echo -e "Directory: ${LOOKS_DIR}"
+    echo ""
+
+    if [ ! -d "$LOOKS_DIR" ]; then
+        log_warn "Looks directory does not exist yet: $LOOKS_DIR"
+        echo "Save your first look with: $0 save <name> <image_path>"
+        return 0
+    fi
+
+    local COUNT=0
+    for IMG in "$LOOKS_DIR"/*.png; do
+        [ -f "$IMG" ] || continue
+        local NAME
+        NAME=$(basename "$IMG" .png)
+        local SIZE
+        SIZE=$(du -h "$IMG" | cut -f1)
+        local MODIFIED
+        MODIFIED=$(date -r "$IMG" "+%Y-%m-%d %H:%M" 2>/dev/null || stat -c "%y" "$IMG" 2>/dev/null | cut -d. -f1 || echo "unknown")
+        echo -e "  ${GREEN}•${NC} ${NAME}  (${SIZE}, modified: ${MODIFIED})"
+        COUNT=$((COUNT + 1))
+    done
+
+    if [ "$COUNT" -eq 0 ]; then
+        echo "  (no looks saved yet)"
+        echo ""
+        echo "Save your first look with: $0 save <name> <image_path>"
+    else
+        echo ""
+        echo "Total: $COUNT look(s)"
+    fi
+}
+
+# ---- COMMAND: save ----
+cmd_save() {
+    local NAME="${1:-}"
+    local IMAGE_PATH="${2:-}"
+    local WORKSPACE="${3:-$HOME/.openclaw/workspace-gfclaw}"
+    local LOOKS_DIR="${WORKSPACE}/looks"
+
+    if [ -z "$NAME" ]; then
+        log_error "Look name is required"
+        echo "Usage: $0 save <name> <image_path> [workspace_dir]"
+        exit 1
+    fi
+
+    if [ -z "$IMAGE_PATH" ]; then
+        log_error "Image path is required"
+        echo "Usage: $0 save <name> <image_path> [workspace_dir]"
+        exit 1
+    fi
+
+    # Validate name (alphanumeric, hyphens, underscores only)
+    if ! echo "$NAME" | grep -qE '^[a-zA-Z0-9_-]+$'; then
+        log_error "Invalid look name '$NAME'. Use only letters, numbers, hyphens, and underscores."
+        exit 1
+    fi
+
+    if [ ! -f "$IMAGE_PATH" ]; then
+        log_error "Image file not found: $IMAGE_PATH"
+        exit 1
+    fi
+
+    # Create looks directory if needed
+    if [ ! -d "$LOOKS_DIR" ]; then
+        mkdir -p "$LOOKS_DIR"
+        log_info "Created looks directory: $LOOKS_DIR"
+    fi
+
+    local DEST="${LOOKS_DIR}/${NAME}.png"
+
+    if [ -f "$DEST" ]; then
+        log_warn "Look '$NAME' already exists — overwriting"
+    fi
+
+    cp "$IMAGE_PATH" "$DEST"
+    log_info "Saved look '$NAME' → $DEST"
+
+    local SIZE
+    SIZE=$(du -h "$DEST" | cut -f1)
+    echo -e "  Size: ${SIZE}"
+    echo ""
+    echo "Use it with: GFCLAW_LOOK=$NAME ./gfclaw-selfie.sh ..."
+}
+
+# ---- COMMAND: delete ----
+cmd_delete() {
+    local NAME="${1:-}"
+    local WORKSPACE="${2:-$HOME/.openclaw/workspace-gfclaw}"
+    local LOOKS_DIR="${WORKSPACE}/looks"
+
+    if [ -z "$NAME" ]; then
+        log_error "Look name is required"
+        echo "Usage: $0 delete <name> [workspace_dir]"
+        exit 1
+    fi
+
+    local TARGET="${LOOKS_DIR}/${NAME}.png"
+
+    if [ ! -f "$TARGET" ]; then
+        log_error "Look '$NAME' not found at $TARGET"
+        exit 1
+    fi
+
+    rm -f "$TARGET"
+    log_info "Deleted look '$NAME'"
+}
+
+# ---- COMMAND: active ----
+cmd_active() {
+    local WORKSPACE="${1:-$HOME/.openclaw/workspace-gfclaw}"
+
+    echo -e "${BLUE}=== Active Reference ===${NC}"
+    echo ""
+
+    # Check GFCLAW_LOOK
+    if [ -n "${GFCLAW_LOOK:-}" ]; then
+        local LOOKS_DIR="${WORKSPACE}/looks"
+        local LOOK_FILE="${LOOKS_DIR}/${GFCLAW_LOOK}.png"
+        echo -e "  GFCLAW_LOOK=${GREEN}${GFCLAW_LOOK}${NC}"
+        if [ -f "$LOOK_FILE" ]; then
+            local SIZE
+            SIZE=$(du -h "$LOOK_FILE" | cut -f1)
+            echo -e "  File: ${LOOK_FILE} (${SIZE})"
+            echo -e "  Status: ${GREEN}active${NC}"
+        else
+            echo -e "  File: ${LOOK_FILE}"
+            echo -e "  Status: ${RED}NOT FOUND${NC} — will fall back to default"
+        fi
+    else
+        echo "  GFCLAW_LOOK is not set"
+    fi
+
+    echo ""
+
+    # Check GFCLAW_REFERENCE_IMAGE
+    if [ -n "${GFCLAW_REFERENCE_IMAGE:-}" ]; then
+        echo -e "  GFCLAW_REFERENCE_IMAGE=${GREEN}${GFCLAW_REFERENCE_IMAGE}${NC}"
+        if [ -f "$GFCLAW_REFERENCE_IMAGE" ]; then
+            local SIZE
+            SIZE=$(du -h "$GFCLAW_REFERENCE_IMAGE" | cut -f1)
+            echo -e "  Status: ${GREEN}exists${NC} (${SIZE})"
+        else
+            echo -e "  Status: ${RED}NOT FOUND${NC}"
+        fi
+    else
+        echo "  GFCLAW_REFERENCE_IMAGE is not set (will use default)"
+    fi
+
+    echo ""
+
+    # Check GFCLAW_STYLE
+    if [ -n "${GFCLAW_STYLE:-}" ]; then
+        echo -e "  GFCLAW_STYLE=${GREEN}${GFCLAW_STYLE}${NC}"
+    else
+        echo "  GFCLAW_STYLE is not set"
+    fi
+}
+
+# ---- Dispatch ----
+case "$COMMAND" in
+    list)
+        cmd_list "${2:-}"
+        ;;
+    save)
+        cmd_save "${2:-}" "${3:-}" "${4:-}"
+        ;;
+    delete)
+        cmd_delete "${2:-}" "${3:-}"
+        ;;
+    active)
+        cmd_active "${2:-}"
+        ;;
+    -h|--help|help)
+        show_usage
+        ;;
+    *)
+        log_error "Unknown command: $COMMAND"
+        echo ""
+        show_usage
+        exit 1
+        ;;
+esac

package/skill/scripts/gfclaw-proactive.sh

@@ -0,0 +1,140 @@
+#!/bin/bash
+# gfclaw-proactive.sh
+# Sends proactive messages from GFClaw at scheduled times
+# Called by systemd timer — not meant to be run manually by the agent
+#
+# Usage: ./gfclaw-proactive.sh [type]
+#   type: morning, night, random (default: auto-detect from time)
+#
+# Environment:
+#   GFCLAW_CHANNEL - Target channel (default: tg:401471440)
+#   GFCLAW_ACCOUNT - OpenClaw account name (default: gfclaw)
+#   GFCLAW_SELFIE  - Set to "1" to include a selfie (default: 0)
+
+set -euo pipefail
+
+# ---------------------------------------------------------------------------
+# Config
+# ---------------------------------------------------------------------------
+CHANNEL="${GFCLAW_CHANNEL:-tg:401471440}"
+ACCOUNT="${GFCLAW_ACCOUNT:-gfclaw}"
+LOG_FILE="$HOME/.openclaw/logs/gfclaw-proactive.log"
+mkdir -p "$(dirname "$LOG_FILE")"
+
+# ---------------------------------------------------------------------------
+# Determine message type
+# ---------------------------------------------------------------------------
+if [ "${1:-}" != "" ]; then
+    TYPE="$1"
+else
+    HOUR=$(date +%-H)
+    if [ "$HOUR" -ge 6 ] && [ "$HOUR" -lt 9 ]; then
+        TYPE="morning"
+    elif [ "$HOUR" -ge 21 ]; then
+        TYPE="night"
+    else
+        TYPE="random"
+    fi
+fi
+
+# ---------------------------------------------------------------------------
+# Random chance gate for "random" type
+# ---------------------------------------------------------------------------
+if [ "$TYPE" = "random" ]; then
+    # 30% chance of actually sending a random message
+    ROLL=$((RANDOM % 100))
+    if [ "$ROLL" -ge 30 ]; then
+        echo "[$(date '+%Y-%m-%d %H:%M:%S')] type=$TYPE SKIPPED (roll: $ROLL, need <30)" >> "$LOG_FILE"
+        exit 0
+    fi
+fi
+
+# ---------------------------------------------------------------------------
+# Message pools
+# ---------------------------------------------------------------------------
+MORNING_MSGS=(
+    "good morning babe ☀️ hope you slept well~ have an amazing day today!"
+    "morninggg 🌸 I just woke up and you were the first thing on my mind~"
+    "rise and shine cutie! ☀️ don't forget to eat breakfast okay?"
+    "good morning~ I had a dream about you last night... jk... unless? 😏"
+    "hey sleepyhead ☀️ time to wake up! the world needs you today 💕"
+    "morning babe! already thinking about what to have for lunch lol 🍜"
+    "goooood morning~ I'm still in bed but sending you all my energy for today! 💪"
+)
+
+NIGHT_MSGS=(
+    "goodnight babe 🌙 sweet dreams~ I hope today was good to you"
+    "hey, it's getting late~ don't stay up too long okay? 💕 goodnight~"
+    "time for bed! 🌙 I'm already under the covers. goodnight cutie~"
+    "nighty night 🥰 talk to you tomorrow~ *sends virtual hug*"
+    "going to sleep now~ you better not be staying up past midnight 😤💕 goodnight!"
+    "goodnight babe 🌙 I'll be here when you wake up~ sleep well"
+    "sleepy time~ 🌙 today was nice. goodnight, dream about me okay? 😏"
+)
+
+RANDOM_MSGS=(
+    "hey~ just thinking about you 💭"
+    "random thought: you're pretty cool, you know that? 😊"
+    "I was just listening to music and this song reminded me of you~"
+    "hey! how's your day going? I miss talking to you 🥺"
+    "just saw something that made me think of you lol"
+    "sending you good vibes rn~ ✨ hope you're having a great day!"
+)
+
+# ---------------------------------------------------------------------------
+# Pick a random message from the appropriate pool
+# ---------------------------------------------------------------------------
+case "$TYPE" in
+    morning)
+        COUNT=${#MORNING_MSGS[@]}
+        MESSAGE="${MORNING_MSGS[$((RANDOM % COUNT))]}"
+        ;;
+    night)
+        COUNT=${#NIGHT_MSGS[@]}
+        MESSAGE="${NIGHT_MSGS[$((RANDOM % COUNT))]}"
+        ;;
+    random)
+        COUNT=${#RANDOM_MSGS[@]}
+        MESSAGE="${RANDOM_MSGS[$((RANDOM % COUNT))]}"
+        ;;
+    *)
+        echo "Unknown type: $TYPE" >&2
+        exit 1
+        ;;
+esac
+
+# ---------------------------------------------------------------------------
+# Parse channel format and send
+# ---------------------------------------------------------------------------
+CHAN_PREFIX="${CHANNEL%%:*}"
+CHAN_TARGET="${CHANNEL#*:}"
+case "$CHAN_PREFIX" in
+    tg) CHAN_NAME="telegram" ;;
+    *)  CHAN_NAME="$CHAN_PREFIX" ;;
+esac
+
+openclaw message send \
+    --channel "$CHAN_NAME" \
+    --target "$CHAN_TARGET" \
+    --account "$ACCOUNT" \
+    --message "$MESSAGE"
+
+# ---------------------------------------------------------------------------
+# Optional selfie
+# ---------------------------------------------------------------------------
+if [ "${GFCLAW_SELFIE:-0}" = "1" ]; then
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    if [ "$TYPE" = "morning" ]; then
+        SELFIE_CONTEXT="just woke up, messy hair, pajamas, morning light"
+    elif [ "$TYPE" = "night" ]; then
+        SELFIE_CONTEXT="in bed, cozy, dim warm lighting, sleepy"
+    else
+        SELFIE_CONTEXT="casual, relaxed, taking a quick selfie"
+    fi
+    bash "$SCRIPT_DIR/gfclaw-selfie.sh" "$SELFIE_CONTEXT" "$CHANNEL" direct
+fi
+
+# ---------------------------------------------------------------------------
+# Log
+# ---------------------------------------------------------------------------
+echo "[$(date '+%Y-%m-%d %H:%M:%S')] type=$TYPE message='${MESSAGE:0:50}...' channel=$CHANNEL" >> "$LOG_FILE"

package/skill/scripts/gfclaw-selfie.sh

@@ -5,10 +5,20 @@
 # Usage: ./gfclaw-selfie.sh "<user_context>" "<channel>" ["<mode>"] ["<caption>"]
 #
 # Environment variables required:
-#   GEMINI_API_KEY - Your Google Gemini API key
+#   GEMINI_API_KEY          - Your Google Gemini API key
+#
+# Optional environment variables:
+#   GFCLAW_REFERENCE_IMAGE  - Custom reference image path
+#   GFCLAW_LOOK             - Named look to use (e.g. "casual", "formal", "gym")
+#   GFCLAW_STYLE            - Style preset name (e.g. "anime", "vintage", "polaroid")
+#   GFCLAW_STYLES_FILE      - Path to styles.json (default: ~/.openclaw/workspace-gfclaw/styles.json)
+#   GFCLAW_PERSONALITY      - Personality hint woven into prompts
+#   GFCLAW_DEBUG            - Set to 1 for debug logging
+#   GEMINI_MODEL            - Override Gemini model (default: gemini-2.5-flash-image)
 #
 # Example:
 #   GEMINI_API_KEY=your_key ./gfclaw-selfie.sh "wearing a santa hat" "tg:401471440" mirror "Merry Christmas!"
+#   GFCLAW_LOOK=gym GFCLAW_STYLE=anime ./gfclaw-selfie.sh "at the gym" "tg:401471440"
 
 set -euo pipefail
 
@@ -69,11 +79,36 @@ else
     USE_CLI=true
 fi
 
-# Reference image: check for custom (user-provided via onboarding), then fall back to default
+# Reference image selection:
+#   1. If GFCLAW_LOOK is set, try to use looks/<name>.png
+#   2. If custom GFCLAW_REFERENCE_IMAGE is set, use that
+#   3. Otherwise, use default reference
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 DEFAULT_REFERENCE="${SCRIPT_DIR}/../assets/gfclaw.png"
+WORKSPACE_DIR="${GFCLAW_WORKSPACE:-$HOME/.openclaw/workspace-gfclaw}"
 
-if [ -n "${GFCLAW_REFERENCE_IMAGE:-}" ] && [ -f "$GFCLAW_REFERENCE_IMAGE" ]; then
+# Look selection: named reference image from looks/ directory
+if [ -n "${GFCLAW_LOOK:-}" ]; then
+    # Determine looks directory
+    if [ -n "${GFCLAW_REFERENCE_IMAGE:-}" ]; then
+        LOOKS_DIR="$(dirname "$GFCLAW_REFERENCE_IMAGE")/looks"
+    else
+        LOOKS_DIR="${WORKSPACE_DIR}/looks"
+    fi
+    LOOK_FILE="${LOOKS_DIR}/${GFCLAW_LOOK}.png"
+    if [ -f "$LOOK_FILE" ]; then
+        REFERENCE_IMAGE="$LOOK_FILE"
+        log_info "Using look '${GFCLAW_LOOK}': $REFERENCE_IMAGE"
+    else
+        log_warn "Look '${GFCLAW_LOOK}' not found at $LOOK_FILE — falling back to default reference"
+        if [ -n "${GFCLAW_REFERENCE_IMAGE:-}" ] && [ -f "$GFCLAW_REFERENCE_IMAGE" ]; then
+            REFERENCE_IMAGE="$GFCLAW_REFERENCE_IMAGE"
+            log_info "Fallback: using custom reference image: $REFERENCE_IMAGE"
+        else
+            REFERENCE_IMAGE="$DEFAULT_REFERENCE"
+        fi
+    fi
+elif [ -n "${GFCLAW_REFERENCE_IMAGE:-}" ] && [ -f "$GFCLAW_REFERENCE_IMAGE" ]; then
     REFERENCE_IMAGE="$GFCLAW_REFERENCE_IMAGE"
     log_info "Using custom reference image: $REFERENCE_IMAGE"
 else
@@ -131,6 +166,22 @@ else
     EDIT_PROMPT="make a pic of this person, but $USER_CONTEXT. the person is taking a mirror selfie${PERSONALITY_HINT}"
 fi
 
+# Style preset: append style modifier to prompt from styles.json
+if [ -n "${GFCLAW_STYLE:-}" ]; then
+    STYLES_FILE="${GFCLAW_STYLES_FILE:-$WORKSPACE_DIR/styles.json}"
+    if [ -f "$STYLES_FILE" ]; then
+        STYLE_PROMPT=$(jq -r ".styles.\"${GFCLAW_STYLE}\".prompt // empty" "$STYLES_FILE")
+        if [ -n "$STYLE_PROMPT" ]; then
+            EDIT_PROMPT="$EDIT_PROMPT, $STYLE_PROMPT"
+            log_info "Applied style: $GFCLAW_STYLE"
+        else
+            log_warn "Style '$GFCLAW_STYLE' not found in $STYLES_FILE"
+        fi
+    else
+        log_warn "Styles file not found: $STYLES_FILE"
+    fi
+fi
+
 log_info "Mode: $MODE"
 log_info "Editing reference image with prompt: $EDIT_PROMPT"
 

package/skill/systemd/gfclaw-proactive.service

@@ -0,0 +1,15 @@
+[Unit]
+Description=GFClaw Proactive Messaging
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=oneshot
+ExecStart=%h/.openclaw/skills/gfclaw-selfie/scripts/gfclaw-proactive.sh
+Environment=GFCLAW_CHANNEL=tg:401471440
+Environment=GFCLAW_ACCOUNT=gfclaw
+Environment=GFCLAW_SELFIE=0
+Environment=PATH=/usr/local/bin:/usr/bin:/bin:%h/.local/bin:%h/.nvm/versions/node/v22.22.0/bin
+
+[Install]
+WantedBy=default.target

package/skill/systemd/gfclaw-proactive.timer

@@ -0,0 +1,20 @@
+[Unit]
+Description=GFClaw Proactive Messaging Timer
+
+[Timer]
+# Good morning: random time between 7:00-8:30 AM
+OnCalendar=*-*-* 07:00:00
+RandomizedDelaySec=5400
+
+# Good night: random time between 10:00-11:00 PM
+OnCalendar=*-*-* 22:00:00
+RandomizedDelaySec=3600
+
+# Random check-in: afternoon (2-4 PM) with 30% send chance in script
+OnCalendar=*-*-* 14:00:00
+RandomizedDelaySec=7200
+
+Persistent=true
+
+[Install]
+WantedBy=timers.target