Turn your OpenClaw agent into a boyfriend persona that can send selfies on command.

Upload your demo file to assets/demo.mp4 and link it here:

• Watch demo video

Inspired by the Clawra workflow, this package installs a plug-and-play OpenClaw skill with:

Security note: No API keys are bundled / user-provided only.

• relationship-style persona injection
• selfie generation flow (fal.ai)
• boyfriend-specific prompt modes and presets

npx @soulomonlab/heartsync@latest

The installer will:

1. Check OpenClaw installation
2. Ask for your FAL_KEY (fal.ai)
3. Install skill to ~/.openclaw/skills/heartsync/
4. Update ~/.openclaw/openclaw.json
5. Inject boyfriend selfie capability into your workspace SOUL.md

cp .env.example .env
# add your FAL_KEY in .env
./scripts/heartsync-selfie.sh "warm casual cafe selfie" "telegram:8415830962" "test" "1:1" "jpeg" "casual"

Telegram tip: use numeric chat_id (telegram:8415830962) instead of telegram:@username.

heartsync-selfie enables your agent to:

• send selfie photos when asked
• keep a consistent visual identity (reference image based)
• respond naturally to relationship-style requests like:
  • “send me a selfie”
  • “show me your date-night look”
  • “good morning selfie”
  • “what are you doing right now?”

• soft: emotionally warm, supportive, comforting
• chill: casual, playful daily vibe
• flirty: romantic but respectful and consent-first

• good morning selfie
• good night selfie
• date-night look
• work-mode check-in

• OpenClaw installed
• fal.ai account
• FAL_KEY from https://fal.ai/dashboard/keys

• Never commit .env, API tokens, or gateway secrets.
• Rotate FAL_KEY immediately if exposed.
• Use a dedicated bot/account for testing.
• Prefer private test chats while validating prompts/images.

git clone https://github.com/soulomonlab/heartsync ~/.openclaw/skills/heartsync-selfie

Add to ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "heartsync-selfie": {
        "enabled": true,
        "env": {
          "FAL_KEY": "your_fal_key_here"
        }
      }
    }
  }
}

## HeartSync Selfie Capability
You have a visual identity and can send selfies/photos when users ask.
Use the `heartsync-selfie` skill for photo requests.

Your agent can respond to:

"Send me a selfie"
"Show me your date-night look"
"Good morning selfie please"
"Send a pic at a cozy cafe"
"What are you doing right now?"

Default reference image URL:

https://cdn.jsdelivr.net/gh/soulomonlab/heartsync@main/assets/main.png

You can replace this with your own image in scripts/config for custom visual identity.

• Image generation: fal.ai (xai/grok-imagine-image/edit or compatible model)
• Distribution: OpenClaw messaging channels
• Platforms: Telegram, Discord, WhatsApp, Slack, Signal, etc.

heartsync/
├── bin/
│   └── cli.js
├── skill/
│   ├── SKILL.md
│   ├── scripts/
│   └── assets/
├── templates/
│   └── soul-injection.md
├── scripts/
│   ├── heartsync-selfie.sh
│   └── heartsync-selfie.ts
├── assets/
│   ├── main.png
│   ├── casual.png
│   ├── formal.png
│   └── outdoor.png
├── .env.example
├── SKILL.md
├── SECURITY.md
├── CONTRIBUTING.md
├── package.json
└── README.md

• Update version in package.json
• Confirm README links and repo URL
• Test installer: npx . or local package
• Push to GitHub main branch
• Publish npm package (npm publish)

MIT