Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
 
← Back to list

Init First NanoClaw Agent

Walks an operator through creating the first NanoClaw DM agent and verifies end-to-end delivery with a welcome message.

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

What it does

  • Detects enabled channels from src/channels/index.ts and .env (Discord, Slack, Telegram, WhatsApp, Teams, Webex, Matrix, iMessage, Resend) and asks which one should host the first agent.
  • Resolves the operator's DM platform_id: direct-addressable channels reuse the user id, cold-DM channels require one inbound DM plus a messaging_groups lookup, and Telegram offers a pair-code flow.
  • Runs scripts/init-first-agent.ts to upsert the user, grant owner if none exists, create the agent group and its filesystem, wire messaging_group_agents, and hand the welcome message to the running service via data/cli.sock (with an inbound.db fallback). Everything is idempotent.
  • Gives concrete failure diagnostics instead of sleep loops: inspect outbound.db for stuck pending rows and grep the log for ACL rejections or container crashes.

Who it's for

  • Operators self-hosting NanoClaw and doing first-time bring-up.
  • Anyone confused about how agent groups, messaging groups, and destinations link together.
  • Operators who want DB-level troubleshooting for undelivered welcome DMs.

Examples

  1. After /setup and /add-discord, pick Discord, DM the bot once, confirm the newest platform_id, and receive the welcome DM.
  2. On Telegram, issue a pair code with --step pair-telegram so the user pairs without DMing first.
  3. If the DM never arrives, query outbound.db for pending rows and grep for Unauthorized channel destination to separate ACL issues from container crashes.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/init-first-agent/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

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.
  2. Clone the repo: git clone https://github.com/nanocoai/nanoclaw.git
  3. Create the skills directory: mkdir -p ~/.claude/skills
  4. Copy the skill: cp -r nanoclaw/.claude/skills/init-first-agent ~/.claude/skills/
    • Because the skill calls repo scripts, the safest path is to cd nanoclaw and run Claude Code from inside the repository.
  5. Satisfy prerequisites: run /setup so the service is active, run an /add-<channel> skill to store credentials, and uncomment the adapter in src/channels/index.ts.
  6. Start Claude Code and ask: "Initialize my first NanoClaw agent."
View source on GitHub ↗License: MIT