nanoclaw/.claude/skills/new-setup-2/SKILL.md

name, description, allowed-tools

name	description	allowed-tools
new-setup-2	Follow-on to /new-setup. Captures the operator and agent names, wires a real messaging channel, and adds quality-of-life extras. Linear rollthrough; every step is skippable. Invoked when the user picks "continue setup" at the end of /new-setup.	Bash(bash setup/probe.sh) Bash(bash setup/install-telegram.sh:*) Bash(pnpm exec tsx setup/index.ts:*) Bash(pnpm exec tsx scripts/init-first-agent.ts:*) Bash(tail:*) Bash(head:*) Bash(grep:*)

NanoClaw phase-2 setup

Runs after /new-setup. At this point the host is running and a throwaway CLI-only agent exists (used during /new-setup for the end-to-end ping check — inferred name, not user-facing). This flow creates the real agent and wires it to a messaging channel.

Linear — one step at a time. Every step is skippable: if the user says "skip", "not now", "later", or similar, move on without complaint. If they say they're done at any point, stop cleanly — don't push the remaining steps.

Before each step, narrate in your own words what's about to happen — one short, friendly sentence, no jargon. Match the tone of /new-setup.

Current state

!bash setup/probe.sh

Parse the probe block above for INFERRED_DISPLAY_NAME and PLATFORM — referenced below.

Steps

1. What should the agent call you?

Plain-prose ask (do not use AskUserQuestion):

What should your agent call you? (Default: <INFERRED_DISPLAY_NAME>)

Capture the answer into a local variable OPERATOR_NAME. Don't persist yet — this value is consumed by step 3's channel wiring. If the user skips or confirms the default, set OPERATOR_NAME = INFERRED_DISPLAY_NAME.

2. What's your agent's name?

Plain-prose ask:

What would you like to call your agent? (Default: <OPERATOR_NAME>)

Capture as AGENT_NAME. If skipped, set AGENT_NAME = OPERATOR_NAME. Nothing persisted yet.

3. Timezone

Run pnpm exec tsx setup/index.ts --step timezone and parse the status block.

• RESOLVED_TZ is UTC or Etc/UTC — before leaving UTC in .env, confirm with the user in plain prose:

  Your system reports UTC as the timezone. Is that actually right, or are you somewhere else? If elsewhere, tell me the IANA zone (e.g. America/New_York, Europe/London, Asia/Tokyo). Skip to keep UTC.

  If they name a different IANA timezone, re-run pnpm exec tsx setup/index.ts --step timezone -- --tz <answer> to overwrite .env. If they skip, leave UTC in place — nothing else to do.

• NEEDS_USER_INPUT=true — autodetection failed. Ask for an IANA timezone (e.g. America/New_York, Europe/London, Asia/Tokyo), then re-run pnpm exec tsx setup/index.ts --step timezone -- --tz <answer>. If they skip, move on.

• Otherwise — timezone is already set; move on.

4. Pick a messaging channel

Print the list as plain prose. Do not use AskUserQuestion for this step — just the list, then wait for the user's reply:

Which messaging channel should I wire your agent to?

• WhatsApp (native) — /add-whatsapp
• WhatsApp Cloud (Meta official) — /add-whatsapp-cloud
• Telegram — /add-telegram
• Slack — /add-slack
• Discord — /add-discord
• iMessage — /add-imessage
• Teams — /add-teams
• Matrix — /add-matrix
• Google Chat — /add-gchat
• Linear — /add-linear
• GitHub — /add-github
• Webex — /add-webex
• Resend (email) — /add-resend
• Emacs — /add-emacs

Or say "skip" to leave this for later.

When the user picks one:

1. Install the adapter. For Telegram, run bash setup/install-telegram.sh directly — it bundles the preflight + fetch + copy + register + pnpm install + build from /add-telegram into one idempotent call, then continue with credentials and pairing (invoke /add-telegram afterwards and its preflight will skip straight to Credentials). For every other channel, invoke the matching /add-<channel> skill via the Skill tool; it copies the adapter source in from the channels branch, registers it, installs the pinned npm package, and handles credentials. Some channels also run a pairing step as part of their flow.

2. Capture platform IDs. After the /add-<channel> skill finishes, you need two values: the operator's user-id on that platform, and the chat/channel platform-id. Each channel surfaces these differently — consult the Channel Info section at the bottom of that skill's SKILL.md for the exact path. For Telegram, for example, the pair-telegram step emits PLATFORM_ID and ADMIN_USER_ID in a status block once the user sends the 4-digit code.

3. Wire the agent. Run init-first-agent.ts in DM mode with --no-cli-bonus (this keeps the new agent off the CLI messaging group so the pre-existing throwaway agent still owns CLI routing cleanly):

   pnpm exec tsx scripts/init-first-agent.ts \
     --channel <channel> \
     --user-id "<platform-user-id>" \
     --platform-id "<platform-chat-id>" \
     --display-name "<OPERATOR_NAME>" \
     --agent-name "<AGENT_NAME>" \
     --no-cli-bonus
   

4. Announce. On success, emit the encouragement line verbatim:

   Your agent is now available on {channel-name}, you can already start chatting — But I encourage you to continue and finish this setup, we're almost done!

   Substitute {channel-name} with the friendly name (e.g. "Telegram", "WhatsApp", "Slack").

If the user skipped, move on to step 5.

5. Host directory access

By default, agent containers can only touch their own workspace. If the user wants the agent to read or write files in specific host directories, those paths need to go on the mount allowlist.

Plain-prose ask:

Want your agent to be able to read or write files in any host directories (e.g. a code project, ~/Documents)? Name the paths and I'll add them — or skip to keep the default isolated workspace.

If the user names paths, invoke /manage-mounts via the Skill tool to add them. If they skip, move on.

6. Quality of life

Optional polish. Print the list; the user may pick zero, one, or several — invoke each chosen skill in sequence:

Want to add any of these? Pick any that sound useful — or skip:

• /add-dashboard — browser dashboard showing agent activity
• /add-compact — /compact slash command for managing long sessions
• /add-karpathy-llm-wiki — persistent knowledge-base memory for the agent

If the probe reports PLATFORM=darwin, also offer:

• /add-macos-statusbar — macOS menu bar indicator with Start/Stop/Restart controls

Do not list /add-macos-statusbar on Linux. If the user skips everything, just move on.

7. Done

Short wrap-up:

Setup complete. You can chat with your agent on {channel-name} — or via CLI with pnpm run chat <message>.

Substitute {channel-name} with whatever was wired in step 4. If step 4 was skipped, drop the "on {channel-name} — or" clause entirely so the line just mentions the CLI form.

If anything fails

Same rule as /new-setup: don't bypass errors to keep moving. Read logs/setup.log or logs/nanoclaw.log, diagnose, fix the underlying cause, re-run the failed step.