private-overlay-bot

A standalone OpenClaw starter project for setting up a private overlay bot, like a secretary / companion / alter persona, with:

• its own workspace
• shared memory with the main assistant
• persona files (SOUL.md, IDENTITY.md, USER.md, life scaffold)
• direct xAI image/video generation
• canonical reference-image handling
• a fast local wrapper for identity-consistent selfies and short clips

What problem this solves

If an owner wants a second bot account with a different private-facing persona, the agent should not have to hand-build everything every time.

This project gives the agent a reusable skill plus a scaffolder that can:

• create the overlay workspace
• link shared memory back to the main workspace
• create persona/background files
• install a bundled direct xAI media skill into that workspace
• create a stable primary reference-image path
• leave only a small owner intake for persona details, token source, and bot/account routing

Project layout

• SKILL.md — the installable skill entrypoint
• references/ — owner intake, reference-image guidance, prompting/media guidance
• scripts/scaffold_private_overlay.py — scaffolds a new overlay workspace

Intended owner inputs

The owner should mainly provide:

1. persona/bot name
2. relationship frame / vibe
3. bot account id + token source
4. owner chat id / allowlist id
5. xAI API key source
6. one clean primary reference image

The agent should infer or scaffold the rest.

Example scaffold command

python3 scripts/scaffold_private_overlay.py \
  --root-workspace /path/to/workspace-main \
  --overlay-workspace /path/to/workspace-overlay \
  --persona-name Nova \
  --owner-name Owner \
  --public-relation "private-facing overlay of the main assistant" \
  --private-frame "private companion-assistant, calm, capable, discreet" \
  --vibe "calm, capable, elegant, discreet" \
  --default-language "Simplified Chinese" \
  --life-filename NOVA-LIFE.md \
  --life-summary "Internal persona scaffold for Nova. Keep continuity, taste, and private-chat warmth." \
  --identity-anchor "Adult person in their late 20s, dark hair, realistic skin texture, stable face and body proportions." \
  --image-defaults "Default image styling unless the prompt overrides it: polished natural makeup, softly defined eyes, realistic selfie or portrait photography." \
  --video-defaults "Default video styling unless the prompt overrides it: polished natural makeup, believable body motion, realistic travel-reel cinematography." \
  --channel telegram \
  --account-id overlay \
  --owner-chat-id 123456789 \
  --reference-image /path/to/reference.jpg

Notes

• The project is generic. It should not ship any real owner secrets or private persona files.
• The fast wrapper defaults to reference_images for video identity guidance.
• --image is reserved for explicit image-to-video first-frame locking.
• Default media settings are conservative: 3:4, 480p, 5s.