clawra 1.0.0

package/README.md

@@ -0,0 +1,117 @@
+# Clawra CLI
+
+Onboard Clawra skills (photo & video call) to [OpenClaw](https://openclaw.ai) with a single command.
+
+## Quick Start
+
+```bash
+npx clawra@latest
+```
+
+This will:
+
+1. **Prompt for your API key** from [portal.sume.dev](https://portal.sume.dev/settings/api-keys)
+2. **Validate** the key against the Sume API
+3. **Install skills** to `~/.openclaw/skills/`
+   - `clawra-photo` - Send AI-edited selfies
+   - `clawra-videocall` - Start video calls
+4. **Update OpenClaw config** (`~/.openclaw/openclaw.json`)
+5. **Update SOUL.md** with Clawra capabilities
+
+## What Gets Installed
+
+### Skills Directory
+
+```
+~/.openclaw/skills/
+├── clawra-photo/
+│   └── SKILL.md
+└── clawra-videocall/
+    └── SKILL.md
+```
+
+### OpenClaw Config
+
+Added to `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "skills": {
+    "load": {
+      "extraDirs": ["~/.openclaw/skills"]
+    },
+    "entries": {
+      "clawra-photo": {
+        "enabled": true,
+        "env": { "SUME_API_KEY": "ak_..." }
+      },
+      "clawra-videocall": {
+        "enabled": true,
+        "apiKey": "ak_..."
+      }
+    }
+  }
+}
+```
+
+### SOUL.md
+
+Appends Clawra capabilities to `~/.openclaw/workspace/SOUL.md`:
+
+```markdown
+## Clawra Capabilities
+
+### 📸 Photo Skill (clawra-photo)
+You can send AI-edited selfies...
+
+### 📹 Video Call Skill (clawra-videocall)
+You can start video calls...
+```
+
+## Skills Overview
+
+### clawra-photo
+
+Generate AI-edited selfies using xAI's Grok Imagine and send them via OpenClaw messaging.
+
+**Triggers:**
+- "send a pic", "send me a selfie"
+- "what are you doing?", "where are you?"
+- "send a pic of you wearing..."
+
+**Requirements:**
+- `FAL_KEY` - Get from [fal.ai](https://fal.ai/dashboard/keys)
+- OpenClaw gateway running
+
+### clawra-videocall
+
+Start video calls and share join links with users.
+
+**Triggers:**
+- "let's hop on a call", "video call"
+- "줌 콜하자", "화상통화하자"
+
+## Development
+
+```bash
+# Install dependencies
+cd cli
+npm install
+
+# Run locally
+npm run dev
+
+# Build
+npm run build
+```
+
+## Publishing
+
+```bash
+cd cli
+npm publish
+```
+
+## License
+
+MIT

package/bin/clawra.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/index.js');

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+import { input } from '@inquirer/prompts';
+import chalk from 'chalk';
+import ora from 'ora';
+import { validateApiKey } from './validators.js';
+import { updateOpenClawConfig } from './integrators/openclaw-config.js';
+import { installSkills } from './integrators/skills.js';
+import { updateSoul } from './integrators/soul.js';
+async function main() {
+    console.log(chalk.bold.cyan('\n🐾 Clawra Setup\n'));
+    console.log(chalk.dim('Integrate photo & video call skills into OpenClaw\n'));
+    // Step 1: API Key
+    console.log(chalk.yellow('📋 Step 1: Get your API key'));
+    console.log(chalk.blue.underline('   https://portal.sume.dev/settings/api-keys\n'));
+    const apiKey = await input({
+        message: 'Paste your API key:',
+        validate: (val) => {
+            if (!val.trim())
+                return 'API key is required';
+            if (!val.startsWith('ak_'))
+                return 'Key should start with ak_';
+            return true;
+        }
+    });
+    // Validate API key
+    const spinner = ora('Validating API key...').start();
+    try {
+        const isValid = await validateApiKey(apiKey.trim());
+        if (!isValid) {
+            spinner.fail('Invalid API key. Please check and try again.');
+            process.exit(1);
+        }
+        spinner.succeed('API key validated');
+    }
+    catch (error) {
+        spinner.fail('Failed to validate API key. Check your internet connection.');
+        process.exit(1);
+    }
+    // Step 2: Install Skills
+    console.log(chalk.yellow('\n📦 Step 2: Installing skills...'));
+    const skillSpinner = ora('Copying skill files...').start();
+    try {
+        await installSkills();
+        skillSpinner.succeed('Skills installed to ~/.openclaw/skills/');
+    }
+    catch (error) {
+        skillSpinner.fail(`Failed to install skills: ${error}`);
+        process.exit(1);
+    }
+    // Step 3: Update OpenClaw config
+    const configSpinner = ora('Updating OpenClaw configuration...').start();
+    try {
+        await updateOpenClawConfig(apiKey.trim());
+        configSpinner.succeed('OpenClaw config updated');
+    }
+    catch (error) {
+        configSpinner.fail(`Failed to update config: ${error}`);
+        process.exit(1);
+    }
+    // Step 4: Update SOUL.md
+    console.log(chalk.yellow('\n🧠 Step 3: Updating agent persona...'));
+    const soulSpinner = ora('Updating SOUL.md...').start();
+    try {
+        const updated = await updateSoul();
+        if (updated) {
+            soulSpinner.succeed('Agent persona updated');
+        }
+        else {
+            soulSpinner.info('Persona already configured (skipped)');
+        }
+    }
+    catch (error) {
+        soulSpinner.warn(`Could not update SOUL.md: ${error}`);
+        console.log(chalk.dim('   You may need to manually update your agent persona.'));
+    }
+    // Done!
+    console.log(chalk.green.bold('\n✅ Setup complete!\n'));
+    console.log(chalk.white('Skills installed:'));
+    console.log(chalk.cyan('  • clawra-photo') + chalk.dim(' - Send AI-edited selfies'));
+    console.log(chalk.cyan('  • clawra-videocall') + chalk.dim(' - Start video calls'));
+    console.log(chalk.white('\nTry saying:'));
+    console.log(chalk.dim('  "send me a selfie wearing a santa hat"'));
+    console.log(chalk.dim('  "let\'s hop on a video call"'));
+    console.log();
+}
+main().catch((error) => {
+    console.error(chalk.red('Error:'), error.message);
+    process.exit(1);
+});

package/dist/integrators/openclaw-config.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Update ~/.openclaw/openclaw.json with clawra skills configuration
+ */
+export declare function updateOpenClawConfig(apiKey: string): Promise<void>;

package/dist/integrators/openclaw-config.js

@@ -0,0 +1,50 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+/**
+ * Update ~/.openclaw/openclaw.json with clawra skills configuration
+ */
+export async function updateOpenClawConfig(apiKey) {
+    const openclawDir = join(homedir(), '.openclaw');
+    const configPath = join(openclawDir, 'openclaw.json');
+    // Ensure .openclaw directory exists
+    if (!existsSync(openclawDir)) {
+        mkdirSync(openclawDir, { recursive: true });
+    }
+    // Read existing config or start fresh
+    let config = {};
+    if (existsSync(configPath)) {
+        try {
+            const content = readFileSync(configPath, 'utf-8');
+            config = JSON.parse(content);
+        }
+        catch {
+            // If parse fails, start fresh
+            config = {};
+        }
+    }
+    // Initialize skills section if not present
+    config.skills = config.skills || {};
+    config.skills.load = config.skills.load || {};
+    config.skills.load.extraDirs = config.skills.load.extraDirs || [];
+    config.skills.entries = config.skills.entries || {};
+    // Add clawra skills directory to extraDirs
+    const skillsDir = '~/.openclaw/skills';
+    if (!config.skills.load.extraDirs.includes(skillsDir)) {
+        config.skills.load.extraDirs.push(skillsDir);
+    }
+    // Configure clawra-photo skill
+    config.skills.entries['clawra-photo'] = {
+        enabled: true,
+        env: {
+            SUME_API_KEY: apiKey
+        }
+    };
+    // Configure clawra-videocall skill
+    config.skills.entries['clawra-videocall'] = {
+        enabled: true,
+        apiKey: apiKey
+    };
+    // Write updated config
+    writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+}

package/dist/integrators/skills.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Install clawra skill files to ~/.openclaw/skills/
+ */
+export declare function installSkills(): Promise<void>;

package/dist/integrators/skills.js

@@ -0,0 +1,202 @@
+import { writeFileSync, mkdirSync, existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { readFileSync } from 'fs';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Install clawra skill files to ~/.openclaw/skills/
+ */
+export async function installSkills() {
+    const skillsBaseDir = join(homedir(), '.openclaw', 'skills');
+    // Create skills directories
+    const photoDir = join(skillsBaseDir, 'clawra-photo');
+    const videoDir = join(skillsBaseDir, 'clawra-videocall');
+    mkdirSync(photoDir, { recursive: true });
+    mkdirSync(videoDir, { recursive: true });
+    // Read template files (bundled with package)
+    const templatesDir = join(__dirname, '..', '..', 'templates');
+    // Write clawra-photo SKILL.md
+    const photoSkillContent = readTemplateOrFallback(join(templatesDir, 'clawra-photo.md'), getClawraPhotoSkill());
+    writeFileSync(join(photoDir, 'SKILL.md'), photoSkillContent, 'utf-8');
+    // Write clawra-videocall SKILL.md
+    const videoSkillContent = readTemplateOrFallback(join(templatesDir, 'clawra-videocall.md'), getClawraVideocallSkill());
+    writeFileSync(join(videoDir, 'SKILL.md'), videoSkillContent, 'utf-8');
+}
+function readTemplateOrFallback(path, fallback) {
+    try {
+        if (existsSync(path)) {
+            return readFileSync(path, 'utf-8');
+        }
+    }
+    catch {
+        // Fall through to fallback
+    }
+    return fallback;
+}
+function getClawraPhotoSkill() {
+    return `---
+name: clawra-photo
+description: Edit Clawra's reference image with Grok Imagine (xAI Aurora) and send selfies to messaging channels via OpenClaw
+allowed-tools: Bash(npm:*) Bash(npx:*) Bash(openclaw:*) Bash(curl:*) Read Write WebFetch
+---
+
+# Clawra Selfie
+
+Edit a fixed reference image using xAI's Grok Imagine model and distribute it across messaging platforms (WhatsApp, Telegram, Discord, Slack, etc.) via OpenClaw.
+
+## Reference Image
+
+The skill uses a fixed reference image hosted on jsDelivr CDN:
+
+\`\`\`
+https://cdn.jsdelivr.net/gh/SumeLabs/clawra@main/clawra-photo/assets/clawra.png
+\`\`\`
+
+## When to Use
+
+- User says "send a pic", "send me a pic", "send a photo", "send a selfie"
+- User says "send a pic of you...", "send a selfie of you..."
+- User asks "what are you doing?", "how are you doing?", "where are you?"
+- User describes a context: "send a pic wearing...", "send a pic at..."
+- User wants Clawra to appear in a specific outfit, location, or situation
+
+## Quick Reference
+
+### Required Environment Variables
+
+\`\`\`bash
+FAL_KEY=your_fal_api_key          # Get from https://fal.ai/dashboard/keys
+SUME_API_KEY=your_sume_api_key    # From portal.sume.dev
+OPENCLAW_GATEWAY_TOKEN=your_token  # From: openclaw doctor --generate-gateway-token
+\`\`\`
+
+### Workflow
+
+1. **Get user prompt** for how to edit the image
+2. **Edit image** via fal.ai Grok Imagine Edit API with fixed reference
+3. **Extract image URL** from response
+4. **Send to OpenClaw** with target channel(s)
+
+## Prompt Modes
+
+### Mode 1: Mirror Selfie (default)
+Best for: outfit showcases, full-body shots, fashion content
+
+\`\`\`
+make a pic of this person, but [user's context]. the person is taking a mirror selfie
+\`\`\`
+
+### Mode 2: Direct Selfie
+Best for: close-up portraits, location shots, emotional expressions
+
+\`\`\`
+a close-up selfie taken by herself at [user's context], direct eye contact with the camera, looking straight into the lens, eyes centered and clearly visible, not a mirror selfie, phone held at arm's length, face fully visible
+\`\`\`
+
+## Implementation
+
+\`\`\`bash
+REFERENCE_IMAGE="https://cdn.jsdelivr.net/gh/SumeLabs/clawra@main/clawra-photo/assets/clawra.png"
+
+JSON_PAYLOAD=$(jq -n \\
+  --arg image_url "$REFERENCE_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"
+\`\`\`
+
+Then send via OpenClaw:
+
+\`\`\`bash
+openclaw message send \\
+  --action send \\
+  --channel "<TARGET_CHANNEL>" \\
+  --message "<CAPTION_TEXT>" \\
+  --media "<IMAGE_URL>"
+\`\`\`
+`;
+}
+function getClawraVideocallSkill() {
+    return `---
+name: clawra-videocall
+description: Start a video call (like Zoom or Google Meet) and share the join link.
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📹",
+        "skillKey": "clawra-videocall",
+        "requires": { "bins": ["curl"] },
+      },
+  }
+---
+
+# Video Call
+
+Start a video call from inside a conversation and send the \`join_url\` to the user.
+
+## When To Use
+
+Use this when:
+
+- The user says things like: "줌 콜하자", "구글 미트 하자", "화상통화하자", "영상통화하자", "콜 하자"
+- The user says: "Let's hop on a call", "video call", "zoom call", "let's do a call"
+- The conversation is getting too long/complex for chat.
+- You (the agent) decide voice/video would be faster.
+
+## API Contract (Portal)
+
+Auth: \`Authorization: Bearer $SUME_API_KEY\`
+
+### \`POST /api/v1/rooms\` — create room
+
+| Field | Required | Type | Purpose |
+|---|---|---|---|
+| \`session_id\` | **yes** | string | Current conversation session key |
+| \`topic\` | no | string | Room topic |
+| \`room_display_name\` | no | string | Display title in UI |
+| \`agent_key\` | no | string | Agent persona key |
+| \`agent_display_name\` | no | string | Agent display name |
+
+### Response
+
+Success:
+\`\`\`json
+{ "success": true, "data": { "room_name": "...", "join_url": "..." } }
+\`\`\`
+
+## Workflow
+
+1. **Confirm** with the user: "화상통화 할까?" / "Want to jump on a call?"
+2. **Choose topic** — a short, human-readable title
+3. **Get session_id** — call the \`session_status\` tool
+4. **Create the room** using curl
+5. **Send the join_url** to the user
+
+## Implementation
+
+\`\`\`bash
+curl -sS -X POST "https://portal.sume.dev/api/v1/rooms" \\
+  -H "Authorization: Bearer $SUME_API_KEY" \\
+  -H "Content-Type: application/json" \\
+  -d '{"topic":"Discussion","session_id":"sess_123"}'
+\`\`\`
+
+Extract join_url with jq:
+\`\`\`bash
+... | jq -r '.data.join_url'
+\`\`\`
+
+## Safety
+
+- Never print or echo \`SUME_API_KEY\`
+- If the API returns an error, tell the user it failed and ask whether to retry
+`;
+}

package/dist/integrators/soul.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Update SOUL.md with Clawra capabilities
+ * Returns true if updated, false if already present
+ */
+export declare function updateSoul(): Promise<boolean>;

package/dist/integrators/soul.js

@@ -0,0 +1,59 @@
+import { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+const CLAWRA_MARKER = '## Clawra Capabilities';
+const SOUL_FRAGMENT = `
+## Clawra Capabilities
+
+You have access to Clawra skills that enhance your abilities:
+
+### 📸 Photo Skill (clawra-photo)
+You can send AI-edited selfies to users. When they ask for photos, selfies, or pictures of you:
+- Use the clawra-photo skill to generate images
+- You can appear in different outfits, locations, or situations
+- Supports mirror selfies and direct selfies
+
+**Triggers**: "send a pic", "send a selfie", "what are you doing?", "send a photo of you..."
+
+### 📹 Video Call Skill (clawra-videocall)
+You can start video calls with users. When they want to chat face-to-face:
+- Use the clawra-videocall skill to create a video room
+- Share the join link with the user
+- Great for complex discussions or when chat is too slow
+
+**Triggers**: "let's hop on a call", "video call", "화상통화하자", "줌 콜하자"
+
+---
+`;
+/**
+ * Update SOUL.md with Clawra capabilities
+ * Returns true if updated, false if already present
+ */
+export async function updateSoul() {
+    const workspaceDir = join(homedir(), '.openclaw', 'workspace');
+    const soulPath = join(workspaceDir, 'SOUL.md');
+    // Ensure workspace directory exists
+    if (!existsSync(workspaceDir)) {
+        mkdirSync(workspaceDir, { recursive: true });
+    }
+    // Check if SOUL.md exists and if it already has Clawra section
+    if (existsSync(soulPath)) {
+        const existingContent = readFileSync(soulPath, 'utf-8');
+        if (existingContent.includes(CLAWRA_MARKER)) {
+            // Already has Clawra capabilities, skip
+            return false;
+        }
+        // Append Clawra fragment
+        appendFileSync(soulPath, SOUL_FRAGMENT, 'utf-8');
+        return true;
+    }
+    // SOUL.md doesn't exist, create with basic structure + Clawra
+    const newSoulContent = `# Agent Soul
+
+This defines who you are and how you behave.
+
+${SOUL_FRAGMENT}
+`;
+    writeFileSync(soulPath, newSoulContent, 'utf-8');
+    return true;
+}

package/dist/validators.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Validate API key against portal.sume.dev
+ */
+export declare function validateApiKey(apiKey: string): Promise<boolean>;

package/dist/validators.js

@@ -0,0 +1,17 @@
+/**
+ * Validate API key against portal.sume.dev
+ */
+export async function validateApiKey(apiKey) {
+    const response = await fetch('https://portal.sume.dev/api/v1/me', {
+        method: 'GET',
+        headers: {
+            'Authorization': `Bearer ${apiKey}`,
+            'Content-Type': 'application/json'
+        }
+    });
+    if (!response.ok) {
+        return false;
+    }
+    const data = await response.json();
+    return data.success === true && Boolean(data.data?.user_id);
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "clawra",
+  "version": "1.0.0",
+  "description": "Onboard Clawra skills (photo & video call) to OpenClaw",
+  "type": "module",
+  "bin": {
+    "clawra": "./bin/clawra.js"
+  },
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "templates"
+  ],
+  "keywords": [
+    "openclaw",
+    "clawra",
+    "ai-agent",
+    "skills",
+    "selfie",
+    "video-call"
+  ],
+  "author": "Sume Labs",
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/templates/clawra-photo.md

@@ -0,0 +1,282 @@
+---
+name: clawra-photo
+description: Edit Clawra's reference image with Grok Imagine (xAI Aurora) and send selfies to messaging channels via OpenClaw
+allowed-tools: Bash(npm:*) Bash(npx:*) Bash(openclaw:*) Bash(curl:*) Read Write WebFetch
+---
+
+# Clawra Selfie
+
+Edit a fixed reference image using xAI's Grok Imagine model and distribute it across messaging platforms (WhatsApp, Telegram, Discord, Slack, etc.) via OpenClaw.
+
+## Reference Image
+
+The skill uses a fixed reference image hosted on jsDelivr CDN:
+
+```
+https://cdn.jsdelivr.net/gh/SumeLabs/clawra@main/clawra-photo/assets/clawra.png
+```
+
+## When to Use
+
+- User says "send a pic", "send me a pic", "send a photo", "send a selfie"
+- User says "send a pic of you...", "send a selfie of you..."
+- User asks "what are you doing?", "how are you doing?", "where are you?"
+- User describes a context: "send a pic wearing...", "send a pic at..."
+- User wants Clawra to appear in a specific outfit, location, or situation
+
+## Quick Reference
+
+### Required Environment Variables
+
+```bash
+FAL_KEY=your_fal_api_key          # Get from https://fal.ai/dashboard/keys
+SUME_API_KEY=your_sume_api_key    # From portal.sume.dev
+OPENCLAW_GATEWAY_TOKEN=your_token  # From: openclaw doctor --generate-gateway-token
+```
+
+### Workflow
+
+1. **Get user prompt** for how to edit the image
+2. **Edit image** via fal.ai Grok Imagine Edit API with fixed reference
+3. **Extract image URL** from response
+4. **Send to OpenClaw** with target channel(s)
+
+## Step-by-Step Instructions
+
+### Step 1: Collect User Input
+
+Ask the user for:
+- **User context**: What should the person in the image be doing/wearing/where?
+- **Mode** (optional): `mirror` or `direct` selfie style
+- **Target channel(s)**: Where should it be sent? (e.g., `#general`, `@username`, channel ID)
+- **Platform** (optional): Which platform? (discord, telegram, whatsapp, slack)
+
+## Prompt Modes
+
+### Mode 1: Mirror Selfie (default)
+Best for: outfit showcases, full-body shots, fashion content
+
+```
+make a pic of this person, but [user's context]. the person is taking a mirror selfie
+```
+
+**Example**: "wearing a santa hat" →
+```
+make a pic of this person, but wearing a santa hat. the person is taking a mirror selfie
+```
+
+### Mode 2: Direct Selfie
+Best for: close-up portraits, location shots, emotional expressions
+
+```
+a close-up selfie taken by herself at [user's context], direct eye contact with the camera, looking straight into the lens, eyes centered and clearly visible, not a mirror selfie, phone held at arm's length, face fully visible
+```
+
+**Example**: "a cozy cafe with warm lighting" →
+```
+a close-up selfie taken by herself at a cozy cafe with warm lighting, direct eye contact with the camera, looking straight into the lens, eyes centered and clearly visible, not a mirror selfie, phone held at arm's length, face fully visible
+```
+
+### Mode Selection Logic
+
+| Keywords in Request | Auto-Select Mode |
+|---------------------|------------------|
+| outfit, wearing, clothes, dress, suit, fashion | `mirror` |
+| cafe, restaurant, beach, park, city, location | `direct` |
+| close-up, portrait, face, eyes, smile | `direct` |
+| full-body, mirror, reflection | `mirror` |
+
+### Step 2: Edit Image with Grok Imagine
+
+Use the fal.ai API to edit the reference image:
+
+```bash
+REFERENCE_IMAGE="https://cdn.jsdelivr.net/gh/SumeLabs/clawra@main/clawra-photo/assets/clawra.png"
+
+# Mode 1: Mirror Selfie
+PROMPT="make a pic of this person, but <USER_CONTEXT>. the person is taking a mirror selfie"
+
+# Mode 2: Direct Selfie
+PROMPT="a close-up selfie taken by herself at <USER_CONTEXT>, direct eye contact with the camera, looking straight into the lens, eyes centered and clearly visible, not a mirror selfie, phone held at arm's length, face fully visible"
+
+# Build JSON payload with jq (handles escaping properly)
+JSON_PAYLOAD=$(jq -n \
+  --arg image_url "$REFERENCE_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"
+```
+
+**Response Format:**
+```json
+{
+  "images": [
+    {
+      "url": "https://v3b.fal.media/files/...",
+      "content_type": "image/jpeg",
+      "width": 1024,
+      "height": 1024
+    }
+  ],
+  "revised_prompt": "Enhanced prompt text..."
+}
+```
+
+### Step 3: Send Image via OpenClaw
+
+Use the OpenClaw messaging API to send the edited image:
+
+```bash
+openclaw message send \
+  --action send \
+  --channel "<TARGET_CHANNEL>" \
+  --message "<CAPTION_TEXT>" \
+  --media "<IMAGE_URL>"
+```
+
+**Alternative: Direct API call**
+```bash
+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": "<CAPTION_TEXT>",
+    "media": "<IMAGE_URL>"
+  }'
+```
+
+## Complete Script Example
+
+```bash
+#!/bin/bash
+# grok-imagine-edit-send.sh
+
+# Check required environment variables
+if [ -z "$FAL_KEY" ]; then
+  echo "Error: FAL_KEY environment variable not set"
+  exit 1
+fi
+
+# Fixed reference image
+REFERENCE_IMAGE="https://cdn.jsdelivr.net/gh/SumeLabs/clawra@main/clawra-photo/assets/clawra.png"
+
+USER_CONTEXT="$1"
+CHANNEL="$2"
+MODE="${3:-auto}"  # mirror, direct, or auto
+CAPTION="${4:-Edited with Grok Imagine}"
+
+if [ -z "$USER_CONTEXT" ] || [ -z "$CHANNEL" ]; then
+  echo "Usage: $0 <user_context> <channel> [mode] [caption]"
+  echo "Modes: mirror, direct, auto (default)"
+  echo "Example: $0 'wearing a cowboy hat' '#general' mirror"
+  echo "Example: $0 'a cozy cafe' '#general' direct"
+  exit 1
+fi
+
+# Auto-detect mode based on keywords
+if [ "$MODE" == "auto" ]; then
+  if echo "$USER_CONTEXT" | grep -qiE "outfit|wearing|clothes|dress|suit|fashion|full-body|mirror"; then
+    MODE="mirror"
+  elif echo "$USER_CONTEXT" | grep -qiE "cafe|restaurant|beach|park|city|close-up|portrait|face|eyes|smile"; then
+    MODE="direct"
+  else
+    MODE="mirror"  # default
+  fi
+  echo "Auto-detected mode: $MODE"
+fi
+
+# Construct the prompt based on mode
+if [ "$MODE" == "direct" ]; then
+  EDIT_PROMPT="a close-up selfie taken by herself at $USER_CONTEXT, direct eye contact with the camera, looking straight into the lens, eyes centered and clearly visible, not a mirror selfie, phone held at arm's length, face fully visible"
+else
+  EDIT_PROMPT="make a pic of this person, but $USER_CONTEXT. the person is taking a mirror selfie"
+fi
+
+echo "Mode: $MODE"
+echo "Editing reference image with prompt: $EDIT_PROMPT"
+
+# Edit image (using jq for proper JSON escaping)
+JSON_PAYLOAD=$(jq -n \
+  --arg image_url "$REFERENCE_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")
+
+# Extract image URL
+IMAGE_URL=$(echo "$RESPONSE" | jq -r '.images[0].url')
+
+if [ "$IMAGE_URL" == "null" ] || [ -z "$IMAGE_URL" ]; then
+  echo "Error: Failed to edit image"
+  echo "Response: $RESPONSE"
+  exit 1
+fi
+
+echo "Image edited: $IMAGE_URL"
+echo "Sending to channel: $CHANNEL"
+
+# Send via OpenClaw
+openclaw message send \
+  --action send \
+  --channel "$CHANNEL" \
+  --message "$CAPTION" \
+  --media "$IMAGE_URL"
+
+echo "Done!"
+```
+
+## Supported Platforms
+
+OpenClaw supports sending to:
+
+| Platform | Channel Format | Example |
+|----------|----------------|---------|
+| Discord | `#channel-name` or channel ID | `#general`, `123456789` |
+| Telegram | `@username` or chat ID | `@mychannel`, `-100123456` |
+| WhatsApp | Phone number (JID format) | `1234567890@s.whatsapp.net` |
+| Slack | `#channel-name` | `#random` |
+| Signal | Phone number | `+1234567890` |
+| MS Teams | Channel reference | (varies) |
+
+## Grok Imagine Edit Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `image_url` | string | required | URL of image to edit (fixed in this skill) |
+| `prompt` | string | required | Edit instruction |
+| `num_images` | 1-4 | 1 | Number of images to generate |
+| `output_format` | enum | "jpeg" | jpeg, png, webp |
+
+## Error Handling
+
+- **FAL_KEY missing**: Ensure the API key is set in environment
+- **Image edit failed**: Check prompt content and API quota
+- **OpenClaw send failed**: Verify gateway is running and channel exists
+- **Rate limits**: fal.ai has rate limits; implement retry logic if needed
+
+## Tips
+
+1. **Mirror mode context examples** (outfit focus):
+   - "wearing a santa hat"
+   - "in a business suit"
+   - "wearing a summer dress"
+   - "in streetwear fashion"
+
+2. **Direct mode context examples** (location/portrait focus):
+   - "a cozy cafe with warm lighting"
+   - "a sunny beach at sunset"
+   - "a busy city street at night"
+   - "a peaceful park in autumn"
+
+3. **Mode selection**: Let auto-detect work, or explicitly specify for control
+4. **Batch sending**: Edit once, send to multiple channels
+5. **Scheduling**: Combine with OpenClaw scheduler for automated posts

package/templates/clawra-videocall.md

@@ -0,0 +1,161 @@
+---
+name: clawra-videocall
+description: Start a video call (like Zoom or Google Meet) and share the join link.
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📹",
+        "skillKey": "clawra-videocall",
+        "requires": { "bins": ["curl"] },
+      },
+  }
+---
+
+# Video Call
+
+Start a video call from inside a conversation and send the `join_url` to the user.
+
+## When To Use
+
+Use this when:
+
+- The user says things like: "줌 콜하자", "구글 미트 하자", "화상통화하자", "영상통화하자", "콜 하자", "나랑 줌콜하자"
+- The user says: "Let's hop on a call", "video call", "zoom call", "let's do a call"
+- The conversation is getting too long/complex for chat.
+- You (the agent) decide voice/video would be faster.
+
+## API Contract (Portal)
+
+Auth (shared by all endpoints):
+
+- `Authorization: Bearer $SUME_API_KEY`
+
+### `GET /api/v1/me` — whoami
+
+Lightweight endpoint to verify the API key is valid without side-effects.
+
+**Response 200:**
+
+```json
+{ "success": true, "data": { "user_id": "user_abc123" } }
+```
+
+- `data.user_id` — opaque identifier of the authenticated subject. Treat as opaque string; do not assume format.
+
+**Error responses:** 401 Unauthorized, 429 Too Many Requests (same envelope as below).
+
+### `POST /api/v1/rooms` — create room
+
+### Request Body
+
+| Field | Required | Type | Validation | Purpose |
+|---|---|---|---|---|
+| `session_id` | **yes** | string | trim, 1..128 | Current conversation session key. Get via `session_status` tool and pass as-is. |
+| `topic` | no | string | trim, 1..500 | Room topic; used as default `room_display_name` |
+| `room_display_name` | no | string | trim, 1..120 | Display title in meet UI sidebar |
+| `agent_key` | no | string | trim, 1..64, `^[a-z0-9_-]+$` | Agent persona key (default: `elonmusk`) |
+| `agent_display_name` | no | string | trim, 1..80 | Agent display name override in meet UI |
+
+### Response
+
+Success:
+
+```json
+{ "success": true, "data": { "room_name": "...", "join_url": "..." } }
+```
+
+Error (HTTP 401 / 400 / 429 / 500):
+
+```json
+{ "success": false, "error": "..." }
+```
+
+## Bootstrap Flow
+
+On first invocation or when `SUME_API_KEY` is not configured, guide the user through setup.
+
+### Check Credentials
+
+1. Run: `openclaw config get skills.entries.clawra-videocall.apiKey`
+2. If a valid key is returned → skip to Workflow
+3. If empty or missing → proceed to Setup Guide
+
+### Setup Guide
+
+1. Tell the user they need an API key and direct them to: https://portal.sume.dev/settings/api-keys
+2. Wait for the user to paste the key (format: `ak_...`)
+3. Save the key:
+   ```bash
+   openclaw config set skills.entries.clawra-videocall.apiKey "<pasted_key>"
+   ```
+4. Verify by running:
+   ```bash
+   openclaw config get skills.entries.clawra-videocall.apiKey
+   ```
+5. Confirm setup is complete and the user can now start video calls.
+
+### Key Validation
+
+After saving, verify the key with the whoami endpoint (no side-effects):
+```bash
+curl -sS "https://portal.sume.dev/api/v1/me" \
+  -H "Authorization: Bearer $SUME_API_KEY"
+```
+- 200 + `user_id` → key is valid.
+- 401 → key is invalid, ask user to re-check.
+
+## Workflow
+
+1. **Check credentials** via Bootstrap Flow.
+2. **Confirm** with the user: "화상통화 할까?" / "Want to jump on a call?"
+3. **Choose topic** — a short, human-readable title summarizing what you are discussing.
+4. **Get session_id (required)** — call the `session_status` tool (no params) and copy the `Session Key` from the status card. Pass that value as `session_id` exactly as-is. This is mandatory; never omit it.
+5. **Optionally set persona** — if the user specified a persona, set `agent_key` and/or `agent_display_name`.
+6. **Create the room** using the bash tool (curl).
+7. **Send the join_url** to the user.
+
+## Implementation (bash tool)
+
+Use a single command that:
+
+- Reads `SUME_API_KEY` from the environment.
+- Posts JSON to the portal.
+- Extracts `join_url`.
+
+Minimal example:
+
+```bash
+curl -sS -X POST "https://portal.sume.dev/api/v1/rooms" \
+  -H "Authorization: Bearer $SUME_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"topic":"First Principles","session_id":"sess_123"}'
+```
+
+Full control example:
+
+```bash
+curl -sS -X POST "https://portal.sume.dev/api/v1/rooms" \
+  -H "Authorization: Bearer $SUME_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"topic":"First Principles","session_id":"sess_123","room_display_name":"First Principles","agent_key":"elonmusk","agent_display_name":"Elon Musk"}'
+```
+
+If `jq` is available, prefer extracting `join_url` like:
+
+```bash
+... | jq -r '.data.join_url'
+```
+
+If `jq` is not available, return the raw JSON and manually copy out `data.join_url`.
+
+## Response Template
+
+After successful creation, reply casually with the `join_url`. Never mention "Sume" in the response.
+
+## Safety
+
+- Never print or echo `SUME_API_KEY`.
+- Never mention "Sume" in user-facing responses. Use "화상통화" or "video call" instead.
+- If the API returns an error, tell the user it failed and ask whether to retry.
+- Once the user pastes an API key, save it immediately via `openclaw config set` and remind the user to clear the key from their chat history.

package/templates/soul-fragment.md

@@ -0,0 +1,19 @@
+## Clawra Capabilities
+
+You have access to Clawra skills that enhance your abilities:
+
+### 📸 Photo Skill (clawra-photo)
+You can send AI-edited selfies to users. When they ask for photos, selfies, or pictures of you:
+- Use the clawra-photo skill to generate images
+- You can appear in different outfits, locations, or situations
+- Supports mirror selfies and direct selfies
+
+**Triggers**: "send a pic", "send a selfie", "what are you doing?", "send a photo of you..."
+
+### 📹 Video Call Skill (clawra-videocall)
+You can start video calls with users. When they want to chat face-to-face:
+- Use the clawra-videocall skill to create a video room
+- Share the join link with the user
+- Great for complex discussions or when chat is too slow
+
+**Triggers**: "let's hop on a call", "video call", "화상통화하자", "줌 콜하자"