Skip to content

NanoClaw Customization Guide

Guides an agent through adding channels, integrations, or behavior changes to a NanoClaw install

Stars
31,072
Licence
MIT
Files
1 file

What it does

When installed, this skill teaches the agent how NanoClaw (a personal AI assistant framework) is organized and how to safely change it. Before editing anything, the agent asks clarifying questions, then points you to dedicated install skills (such as /add-telegram or /manage-channels) where they exist, and otherwise edits the right place: a group's CLAUDE.md file, the container configuration, or core code. It also explains the steps to rebuild and restart the service afterward.

Great for

  • Developers running their own NanoClaw instance who want to add a messaging channel like Telegram or Slack
  • Maintainers who need help wiring an MCP tool or changing a group's trigger rules
  • Users who want guided, question-driven changes instead of hand-editing internals

Skip it if

  • People who have never set up NanoClaw: the skill assumes an existing project, pnpm, the ncl CLI and a running service, so it will not help with a fresh install
  • Production systems where config changes are made without review: the skill can modify core code and restart services, so changes should be checked before deployment

Try asking

  • “Add Telegram as an input channel to my NanoClaw assistant”
  • “Wire a new Slack channel to an existing agent group with mention-only triggers”
  • “Add a Notion MCP integration for my work agent group”
  • “Change the persona of my family group by editing its CLAUDE.md”
Step-by-step guide: how to use NanoClaw Customization GuideInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    customize.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip customize.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip customize.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Name the channel or service you want up front so the agent can pick the matching /add-<channel> skill
  • Review the diff and the wiring/trigger rules before accepting, especially for channels that reach shared groups
  • Keep a backup of data/v2.db before large entity-model changes

What's inside

  • SKILL.md

Redistributed unmodified from nanocoai/nanoclaw under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.