setup-family

name	setup-family
description	Super-easy FamilyClaw family setup — base install (Telegram + native credential proxy) then auto-create a shared-memory family agent with an invite link for the rest of the household. Triggers on "set up family", "family setup", "setup familyclaw for my family".

Set up FamilyClaw for a family

Goal: one assistant for the whole household — each member chats privately, all share one family memory — with the fewest possible steps. This skill wires the existing pieces (Telegram is vendored in trunk, the native credential proxy, and scripts/init-family.ts) into one flow.

Prerequisites the human provides

1. A Telegram bot token — create one with @BotFather (/newbot), then turn Group Privacy → Off under Bot Settings. Copy the token.
2. One Anthropic credential — a Claude Pro/Max OAuth token (claude setup-token) or an API key.
3. The family name (e.g. "Smith") and the first parent's Telegram.

Flow

1. Pick the family name and bot username

Ask the human:

• Family name (becomes the agent group family-<name> and the shared memory title).
• Telegram bot username (the @..._bot handle) — used to build a tap-to-join deep link. Optional; the /join code works without it.

2. Default to the native credential proxy (simplest)

Unless the human wants the OneCLI vault, use the built-in proxy so the only credential is one value in .env. If OneCLI isn't already set up, run /use-native-credential-proxy (it reads ANTHROPIC_API_KEY / CLAUDE_CODE_OAUTH_TOKEN / ANTHROPIC_AUTH_TOKEN from .env).

3. Run setup in family mode

Set the family env vars, then run the installer. Family mode makes the Telegram channel bootstrap ONE family agent group (shared memory) with the paired user as the first parent — instead of a single-user DM agent.

export FAMILYCLAW_FAMILY_NAME="Smith"
export TELEGRAM_BOT_USERNAME="smith_family_bot"   # optional, for the deep link
export TELEGRAM_BOT_TOKEN="123456:ABC-..."        # or paste when prompted
bash familyclaw.sh

During setup the first parent scans the pairing code in Telegram. When it completes, FamilyClaw prints an invite link for the rest of the family.

4. Invite the rest of the family

Share the printed link (or run ncl family invite --role member|parent). Each member who taps it / sends /join fam_… is wired automatically into the family agent with shared memory — no per-member setup, works on Telegram/WhatsApp/iMessage.

Check the roster any time: ncl family roster.

Notes

• Already installed and just want to add the family? Skip setup and run pnpm init-family --family-name "Smith" --parent-id telegram:<id> --parent-platform-id telegram:<id> --parent-name "Mom" [--bot <username>].
• Full reference: docs/family-setup.md.
• Enable durable graph memory with /add-mnemon so the family memory persists richly across every member's session.