https://cdn.jsdelivr.net/gh/SudheerNaraharisetty/CLAWrity@main/assets/companion.png

{
  "skills": {
    "entries": {
      "clawrity": {
        "env": {
          "CLAWRITY_COMPANION_IMAGE": "https://your-custom-image-url.png"
        }
      }
    }
  }
}

FAL_KEY=your_fal_api_key                    # Optional: Get from https://fal.ai/dashboard/keys (text-only mode if not set)
OPENCLAW_GATEWAY_TOKEN=your_token            # From: openclaw doctor --generate-gateway-token
CLAWRITY_COMPANION_IMAGE=custom_url          # Optional: override default companion image

bash scripts/clawrity.sh "$user_context" "$channel" "$mode" "$caption"

# Start in background
bash scripts/body-double-timer.sh "$channel" "$interval" &

the companion character sitting at a desk working alongside the viewer, cozy warm lighting, focused but relaxed atmosphere, <USER_CONTEXT>, encouraging and supportive presence

the companion character sitting at a desk working alongside the viewer, cozy warm lighting, focused but relaxed atmosphere, studying together with books and notes, encouraging and supportive presence

a beautifully designed visual task board showing organized steps, clean minimal design, calming colors, <TASK_ITEMS_VISUAL>, motivating but not overwhelming, soft rounded edges

a beautifully designed visual task board showing organized steps, clean minimal design, calming colors, apartment cleaning broken into small friendly steps, motivating but not overwhelming, soft rounded edges

a peaceful illustrated pathway or bridge connecting two scenes, the left side shows <PREVIOUS_ACTIVITY>, the right side shows <NEXT_ACTIVITY>, dreamy soft atmosphere, gentle transition, calming pastels

a peaceful illustrated pathway or bridge connecting two scenes, the left side shows a cozy study desk with books, the right side shows a warm inviting kitchen, dreamy soft atmosphere, gentle transition, calming pastels

a serene <USER_CALM_PREFERENCE> scene, extremely soft lighting, muted gentle colors, no harsh contrasts, peaceful and grounding, minimal visual elements, <SENSORY_SAFE_DESCRIPTORS>

a serene forest clearing scene, extremely soft lighting, muted gentle colors, no harsh contrasts, peaceful and grounding, minimal visual elements, soft moss, gentle stream, dappled sunlight through leaves

a warm supportive illustration of two people having a comfortable conversation, friendly body language, speech bubbles with gentle text, <SOCIAL_CONTEXT>, approachable and non-threatening atmosphere

the companion character celebrating with <USER_REWARD_PREFERENCE>, joyful radiant energy, bright but not overwhelming colors, confetti and sparkles, achievement unlocked feeling, warm congratulatory atmosphere

the companion character celebrating with confetti and a golden star, joyful radiant energy, bright but not overwhelming colors, confetti and sparkles, achievement unlocked feeling, warm congratulatory atmosphere

COMPANION_IMAGE="${CLAWRITY_COMPANION_IMAGE:-https://cdn.jsdelivr.net/gh/SudheerNaraharisetty/CLAWrity@main/assets/companion.png}"

# Build JSON payload with jq (handles escaping properly)
JSON_PAYLOAD=$(jq -n \
  --arg image_url "$COMPANION_IMAGE" \
  --arg prompt "$PROMPT" \
  '{image_url: $image_url, prompt: $prompt, num_images: 1, output_format: "jpeg"}')

curl -X POST "https://fal.run/xai/grok-imagine-image/edit" \
  -H "Authorization: Key $FAL_KEY" \
  -H "Content-Type: application/json" \
  -d "$JSON_PAYLOAD"

{
  "images": [
    {
      "url": "https://v3b.fal.media/files/...",
      "content_type": "image/jpeg",
      "width": 1024,
      "height": 1024
    }
  ],
  "revised_prompt": "Enhanced prompt text..."
}

openclaw message send \
  --action send \
  --channel "<TARGET_CHANNEL>" \
  --message "<SUPPORTIVE_MESSAGE>" \
  --media "<IMAGE_URL>"

curl -X POST "http://localhost:18789/message" \
  -H "Authorization: Bearer $OPENCLAW_GATEWAY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "send",
    "channel": "<TARGET_CHANNEL>",
    "message": "<SUPPORTIVE_MESSAGE>",
    "media": "<IMAGE_URL>"
  }'

#!/bin/bash
# clawrity-support.sh
# Detect mode, generate companion visual, and send support via OpenClaw

if [ -z "$FAL_KEY" ]; then
  echo "[CLAWrity] FAL_KEY not set — running in text-only mode (no image generation)"
  IMAGE_GENERATION=false
else
  IMAGE_GENERATION=true
fi

COMPANION_IMAGE="${CLAWRITY_COMPANION_IMAGE:-https://cdn.jsdelivr.net/gh/SudheerNaraharisetty/CLAWrity@main/assets/companion.png}"

USER_CONTEXT="$1"
CHANNEL="$2"
MODE="${3:-auto}"
CAPTION="${4:-}"

if [ -z "$USER_CONTEXT" ] || [ -z "$CHANNEL" ]; then
  echo "Usage: $0 <user_context> <channel> [mode] [caption]"
  echo "Modes: body-double, task-decompose, transition, sensory-break, social-script, celebration, auto"
  exit 1
fi

# Auto-detect mode
if [ "$MODE" == "auto" ]; then
  if echo "$USER_CONTEXT" | grep -qiE "can't start|body double|sit with me|focus|procrastinat|co-work"; then
    MODE="body-double"
  elif echo "$USER_CONTEXT" | grep -qiE "overwhelmed|break it down|too much|simplify|where to start"; then
    MODE="task-decompose"
  elif echo "$USER_CONTEXT" | grep -qiE "finished|what's next|switch|move on|perseverat|next task"; then
    MODE="transition"
  elif echo "$USER_CONTEXT" | grep -qiE "overload|sensory|meltdown|shutdown|calm down|stim|break"; then
    MODE="sensory-break"
  elif echo "$USER_CONTEXT" | grep -qiE "how do I say|respond|email|awkward|phrase|social|reply"; then
    MODE="social-script"
  elif echo "$USER_CONTEXT" | grep -qiE "did it|done|finished|completed|finally|accomplished"; then
    MODE="celebration"
  else
    MODE="body-double"  # default fallback
  fi
  echo "Auto-detected mode: $MODE"
fi

# Build prompt based on mode
case "$MODE" in
  body-double)
    EDIT_PROMPT="the companion character sitting at a desk working alongside the viewer, cozy warm lighting, focused but relaxed atmosphere, $USER_CONTEXT, encouraging and supportive presence"
    [ -z "$CAPTION" ] && CAPTION="I'm here with you. Let's work on this together. No pressure, just presence. 💛"
    ;;
  task-decompose)
    EDIT_PROMPT="a beautifully designed visual task board showing organized steps, clean minimal design, calming colors, $USER_CONTEXT, motivating but not overwhelming, soft rounded edges"
    [ -z "$CAPTION" ] && CAPTION="Here's your task broken into small, manageable pieces. Pick just one to start with."
    ;;
  transition)
    EDIT_PROMPT="a peaceful illustrated pathway or bridge connecting two scenes, $USER_CONTEXT, dreamy soft atmosphere, gentle transition, calming pastels"
    [ -z "$CAPTION" ] && CAPTION="Let's gently move to the next thing. Take a breath first — transitions are hard and that's okay."
    ;;
  sensory-break)
    EDIT_PROMPT="a serene natural scene, extremely soft lighting, muted gentle colors, no harsh contrasts, peaceful and grounding, minimal visual elements, $USER_CONTEXT"
    [ -z "$CAPTION" ] && CAPTION="Everything can wait. Right now, just breathe. You're safe. 🌿"
    ;;
  social-script)
    EDIT_PROMPT="a warm supportive illustration of two people having a comfortable conversation, friendly body language, $USER_CONTEXT, approachable and non-threatening atmosphere"
    [ -z "$CAPTION" ] && CAPTION="Here are a few ways you could say that. Pick whichever feels most like you."
    ;;
  celebration)
    EDIT_PROMPT="the companion character celebrating with confetti and sparkles, joyful radiant energy, bright but not overwhelming colors, $USER_CONTEXT, achievement unlocked feeling, warm congratulatory atmosphere"
    [ -z "$CAPTION" ] && CAPTION="YOU DID IT! 🎉 That took real effort and you showed up for it. I'm proud of you."
    ;;
esac

echo "Mode: $MODE"
echo "Editing companion image with prompt: $EDIT_PROMPT"

# Generate visual via fal.ai (only if FAL_KEY is set)
if [ "$IMAGE_GENERATION" = true ]; then
  JSON_PAYLOAD=$(jq -n \
    --arg image_url "$COMPANION_IMAGE" \
    --arg prompt "$EDIT_PROMPT" \
    '{image_url: $image_url, prompt: $prompt, num_images: 1, output_format: "jpeg"}')

  RESPONSE=$(curl -s -X POST "https://fal.run/xai/grok-imagine-image/edit" \
    -H "Authorization: Key $FAL_KEY" \
    -H "Content-Type: application/json" \
    -d "$JSON_PAYLOAD")

  IMAGE_URL=$(echo "$RESPONSE" | jq -r '.images[0].url')

  if [ "$IMAGE_URL" == "null" ] || [ -z "$IMAGE_URL" ]; then
    echo "Error: Failed to generate image"
    echo "Response: $RESPONSE"
    exit 1
  fi

  echo "Image generated: $IMAGE_URL"
else
  IMAGE_URL=""
  echo "Skipping image generation (text-only mode)"
fi

echo "Sending to channel: $CHANNEL"

# Send via OpenClaw
if [ -n "$IMAGE_URL" ]; then
  openclaw message send \
    --action send \
    --channel "$CHANNEL" \
    --message "$CAPTION" \
    --media "$IMAGE_URL"
else
  openclaw message send \
    --action send \
    --channel "$CHANNEL" \
    --message "$CAPTION"
fi

echo "Done!"

import { fal } from "@fal-ai/client";
import { exec } from "child_process";
import { promisify } from "util";

const execAsync = promisify(exec);

const DEFAULT_COMPANION =
  "https://cdn.jsdelivr.net/gh/SudheerNaraharisetty/CLAWrity@main/assets/companion.png";

type SupportMode =
  | "body-double"
  | "task-decompose"
  | "transition"
  | "sensory-break"
  | "social-script"
  | "celebration"
  | "auto";

function detectMode(userContext: string): Exclude<SupportMode, "auto"> {
  const patterns: Record<Exclude<SupportMode, "auto">, RegExp> = {
    "body-double":
      /can't start|body double|sit with me|focus|procrastinat|co-work/i,
    "task-decompose":
      /overwhelmed|break it down|too much|simplify|where to start/i,
    transition:
      /finished|what's next|switch|move on|perseverat|next task/i,
    "sensory-break":
      /overload|sensory|meltdown|shutdown|calm down|stim|break/i,
    "social-script":
      /how do I say|respond|email|awkward|phrase|social|reply/i,
    celebration:
      /did it|done|finished|completed|finally|accomplished/i,
  };

  for (const [mode, regex] of Object.entries(patterns)) {
    if (regex.test(userContext)) return mode as Exclude<SupportMode, "auto">;
  }
  return "body-double"; // default
}

function buildPrompt(
  userContext: string,
  mode: Exclude<SupportMode, "auto">
): string {
  const templates: Record<Exclude<SupportMode, "auto">, string> = {
    "body-double": `the companion character sitting at a desk working alongside the viewer, cozy warm lighting, focused but relaxed atmosphere, ${userContext}, encouraging and supportive presence`,
    "task-decompose": `a beautifully designed visual task board showing organized steps, clean minimal design, calming colors, ${userContext}, motivating but not overwhelming, soft rounded edges`,
    transition: `a peaceful illustrated pathway or bridge connecting two scenes, ${userContext}, dreamy soft atmosphere, gentle transition, calming pastels`,
    "sensory-break": `a serene natural scene, extremely soft lighting, muted gentle colors, no harsh contrasts, peaceful and grounding, minimal visual elements, ${userContext}`,
    "social-script": `a warm supportive illustration of two people having a comfortable conversation, friendly body language, ${userContext}, approachable and non-threatening atmosphere`,
    celebration: `the companion character celebrating with confetti and sparkles, joyful radiant energy, bright but not overwhelming colors, ${userContext}, achievement unlocked feeling, warm congratulatory atmosphere`,
  };

  return templates[mode];
}

function getDefaultCaption(mode: Exclude<SupportMode, "auto">): string {
  const captions: Record<Exclude<SupportMode, "auto">, string> = {
    "body-double":
      "I'm here with you. Let's work on this together. No pressure, just presence. 💛",
    "task-decompose":
      "Here's your task broken into small, manageable pieces. Pick just one to start with.",
    transition:
      "Let's gently move to the next thing. Take a breath first — transitions are hard and that's okay.",
    "sensory-break":
      "Everything can wait. Right now, just breathe. You're safe. 🌿",
    "social-script":
      "Here are a few ways you could say that. Pick whichever feels most like you.",
    celebration:
      "YOU DID IT! 🎉 That took real effort and you showed up for it. I'm proud of you.",
  };

  return captions[mode];
}

async function supportAndSend(
  userContext: string,
  channel: string,
  mode: SupportMode = "auto",
  caption?: string
): Promise<string> {
  fal.config({ credentials: process.env.FAL_KEY! });

  const companionImage =
    process.env.CLAWRITY_COMPANION_IMAGE || DEFAULT_COMPANION;
  const resolvedMode = mode === "auto" ? detectMode(userContext) : mode;

  console.log(`Mode: ${resolvedMode}`);

  const editPrompt = buildPrompt(userContext, resolvedMode);
  console.log(`Generating visual: "${editPrompt}"`);

  const result = await fal.subscribe("xai/grok-imagine-image/edit", {
    input: {
      image_url: companionImage,
      prompt: editPrompt,
      num_images: 1,
      output_format: "jpeg",
    },
  });

  const imageUrl = (result.data as any).images[0].url;
  console.log(`Image generated: ${imageUrl}`);

  const message = caption || getDefaultCaption(resolvedMode);

  await execAsync(
    `openclaw message send --action send --channel "${channel}" --message "${message}" --media "${imageUrl}"`
  );

  console.log(`Sent to ${channel}`);
  return imageUrl;
}

npm install @fal-ai/client

npm install -g openclaw

openclaw config set gateway.mode=local
openclaw doctor --generate-gateway-token

openclaw gateway start