Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

Init First NanoClaw Agent

Guides you through creating your first NanoClaw DM agent and verifies delivery with a welcome message.

AutomationAdvanced★ 30,471⑂ 12,865AI score 6/10Last updated: Aug 9, 2026

What it does

This skill walks an operator through standing up the first agent in NanoClaw, a multi-channel messaging agent runtime.

  • Reads src/channels/index.ts and .env to list enabled channels and asks which one should host the DM
  • Collects your channel user ID, display name, and the agent persona name
  • Resolves the DM platform_id: direct-addressable channels (Telegram, WhatsApp, iMessage, Matrix, Resend) reuse the user handle, while cold-DM channels (Discord, Slack, Teams, Webex, gChat) require you to DM the bot once so the router records a messaging_groups row
  • Runs scripts/init-first-agent.ts to upsert the user, create the agent group and its filesystem, and wire messaging group ↔ agent bindings
  • Sends a welcome DM through the service CLI socket for a true end-to-end test, with an inbound.db fallback
  • Ships a concrete troubleshooting section (stuck pending rows, ACL rejections, unknown-sender policy, name collisions)

Every step is idempotent, so reruns are safe.

Who it's for

  • Operators who just installed NanoClaw and need their first working agent
  • Anyone confused by the plumbing between a chat bot and an agent group
  • Users who need a systematic checklist when the welcome DM never arrives

Note: only meaningful inside the NanoClaw repo, with the service running and channel credentials already configured.

Examples

  1. First Discord agent: after /add-discord, invoke the skill, DM the bot once, confirm the returned platform_id, and receive the welcome DM.
  2. Telegram pair-code path: if you'd rather not DM first, use --step pair-telegram, send the issued code in Telegram, and the interceptor links your user automatically.
  3. Delivery debugging: nothing arrives in two minutes → query outbound.db for pending rows and grep the log for Unauthorized channel destination or container exits.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the .claude/skills/init-first-agent folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/init-first-agent/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/init-first-agent ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal and clone the repo: git clone https://github.com/nanocoai/nanoclaw.git
  2. Create the skills directory if needed: mkdir -p ~/.claude/skills
  3. Copy the skill: cp -r nanoclaw/.claude/skills/init-first-agent ~/.claude/skills/
    • (If you work directly inside the NanoClaw repo, the skill is already available — no copy needed.)
  4. Set up NanoClaw first by running /setup, then confirm the service is running under launchd (macOS) or systemd (Linux).
  5. Run a channel skill (/add-discord, /add-telegram, …) so credentials land in .env and the adapter is uncommented in src/channels/index.ts.
  6. Launch Claude Code from the NanoClaw repo directory and ask it to "create my first agent" or invoke init-first-agent.
  7. Wait for the welcome DM (first container cold start takes ~60s); if it doesn't arrive, follow the diagnostic commands the skill prints.
View source on GitHub ↗License: MIT