К основному содержанию
скилл CX Codex

customize · nanocoai — скилл для Claude Code: настройка NanoClaw

Скилл customize помогает менять NanoClaw: добавлять каналы и интеграции, настраивать триггеры и поведение агента. Сначала он уточняет задачу, затем выбирает подходящую часть проекта.

MIT ★ 31 137 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add nanocoai/nanoclaw --skill customize -a claude-code
Открыть на GitHub

Что делает customize

Скилл начинает с вопросов, а затем определяет, где в NanoClaw нужны изменения: в модели сущностей, настройках контейнера группы, CLAUDE.md или основном коде. Если для задачи есть отдельный скилл, например /add-telegram или /manage-channels, он предлагает использовать его вместо ручной правки ядра.

Для каналов он помогает выбрать группу агента, уровень изоляции и правила триггеров. Настройки MCP-сервера можно добавить через ncl groups config add-mcp-server, затем перезапустить группу командой ncl groups restart. Инструкции и личность агента хранятся в groups/<folder>/CLAUDE.md; после изменений скилл подсказывает, как проверить результат. Для MCP-доступа из контейнера add_mcp_server требует одобрения администратора.

Установить его можно командой npx skills add nanocoai/nanoclaw --skill customize -a claude-code. Для работы с описанными настройками нужен корень проекта NanoClaw.

Какие задачи решает

  • добавить входящий канал и связать его с группой агента
  • изменить правила, по которым сообщения запускают агента
  • подключить MCP-сервер к настройкам контейнера группы
  • настроить инструкции и личность агента в CLAUDE.md
  • подготовить изменения конфигурации для другого способа развёртывания

Примеры запросов агенту

  • Добавь Telegram как входящий канал в NanoClaw и уточни, к какой группе агента его подключить.
  • Подключи MCP-сервер календаря к группе агента и объясни, как применить настройки.
  • Измени стиль ответов агента в groups/<folder>/CLAUDE.md и подскажи, как проверить изменения.

Как установить customize

1Через Skills CLI (Vercel)

npx skills add nanocoai/nanoclaw --skill customize -a claude-code

2Вручную: положить файлы

~/.claude/skills/customize/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/customize/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о customize

Как установить customize в Claude Code?

В корне проекта выполните npx skills add nanocoai/nanoclaw --skill customize -a claude-code. Файл скилла появится по пути ~/.claude/skills/customize/SKILL.md.

Что делает customize?

Он помогает спланировать и внести изменения в NanoClaw: например, добавить канал или MCP-интеграцию, изменить триггеры либо инструкции агента.

Нужно ли одобрение администратора для добавления MCP-сервера?

Да, если агент добавляет сервер из контейнера с помощью add_mcp_server, требуется одно одобрение администратора.

Исходный текст

SKILL.md · MIT
---
name: customize
description: Add new capabilities or modify NanoClaw behavior. Use when user wants to add channels (Telegram, Slack, email input), change triggers, add integrations, modify the router, or make any other customizations. This is an interactive skill that asks questions to understand what the user wants.
---

# NanoClaw Customization

This skill helps users add capabilities or modify behavior. Use AskUserQuestion to understand what they want before making changes.

## Workflow

1. **Understand the request** — Ask clarifying questions.
2. **Prefer a dedicated skill** — If a skill covers the request, invoke it instead of editing core by hand:
   - Channels: `/add-telegram`, `/add-slack`, `/add-discord`, `/add-whatsapp`, `/add-signal`, `/add-imessage`, and the rest of the `/add-<channel>` family.
   - Wiring channels to agents and isolation levels: `/manage-channels`.
   - Container directory access: `/manage-mounts`.
   - Agent providers (non-default): `/add-opencode`, `/add-codex`, `/add-ollama-provider`.
   - MCP tools: `/add-ollama-tool`, `/add-atomic-chat-tool`.
3. **Plan the changes** — Identify the v2 surface the change belongs to (entity model in the central DB, per-agent-group container config, per-group `CLAUDE.md`, or core code).
4. **Implement** — Make the change on the right surface.
5. **Test guidance** — Tell the user how to verify.

## Entity Model

Customizations route through the v2 entity model: users → messaging groups → agent groups → sessions. A messaging group is one chat/channel on one platform; an agent group holds the workspace, personality, and container config; a wiring links a messaging group to an agent group with a session mode and trigger rules. Inspect and edit all of this with the `ncl` admin CLI. See `docs/isolation-model.md` for the three isolation levels.

## Key Files

| File | Purpose |
|------|---------|
| `src/index.ts` | Entry point: init DB, migrations, channel adapters, delivery polls, sweep, shutdown |
| `src/router.ts` | Inbound routing: messaging group → agent group → session → `inbound.db` → wake |
| `src/delivery.ts` | Polls `outbound.db`, delivers via adapter, handles system actions |
| `src/session-manager.ts` | Resolves sessions; opens `inbound.db` / `outbound.db`; heartbeat path |
| `src/container-runner.ts` | Spawns per-agent-group containers with session DB + outbox mounts, OneCLI `ensureAgent` |
| `src/channels/` | Channel adapter infra (registry, Chat SDK bridge); specific adapters install from the `channels` branch |
| `src/config.ts` | Process-level config (assistant name, paths, timeouts) read from `.env` |
| `data/v2.db` | Central DB: users, roles, agent_groups, messaging_groups, wirings, container_configs |
| `data/v2-sessions/<session>/` | Per-session `inbound.db` (host→container) + `outbound.db` (container→host) |
| `groups/<folder>/CLAUDE.md` | Per-agent-group memory/persona and instructions |

For ad-hoc DB queries, use `pnpm exec tsx scripts/q.ts <db> "<sql>"`.

## Common Customization Patterns

### Adding a New Input Channel (e.g., Telegram, Slack, Email)

Questions to ask:
- Which channel? (Telegram, Slack, Discord, WhatsApp, Signal, email, etc.)
- Should this channel reach an existing agent group or a new one?
- What isolation level — share an agent group with other channels, or keep it separate?
- Same trigger rules as other channels on that agent group, or different?

Implementation:
1. Run the matching install skill (`/add-telegram`, `/add-slack`, …). It fetches the adapter from the `channels` branch, wires the registration import, installs the pinned package, and builds.
2. Run `/manage-channels` (or use `ncl messaging-groups` + `ncl wirings`) to create the messaging group, choose the isolation level, and wire it to an agent group with a session mode and trigger rules.

### Adding a New MCP Integration

Questions to ask:
- What service? (Calendar, Notion, database, etc.)
- What operations are needed? (read, write, both)
- Which agent group should have access?

Implementation:
- If a dedicated `/add-<service>-tool` skill exists, run it — it wires the MCP server and routes credentials through OneCLI so no raw keys reach the container.
- Otherwise wire the MCP server into the agent group's container config with either `--command <cmd> [--args <json-array>] [--env <json-object>]` for stdio or `--url <url>` for Streamable HTTP (HTTPS, or plain HTTP for localhost / host.docker.internal): `ncl groups config add-mcp-server --id <group-id> --name <name> ...`. Then run `ncl groups restart --id <group-id>` to take effect. From inside a container the agent uses the `add_mcp_server` self-mod tool, which requires one admin approval.

### Changing Assistant Behavior

Questions to ask:
- What aspect? (persona, response style, instructions)
- Apply to one agent group or several?

Implementation:
- Persona, instructions, and personality live per agent group in `groups/<folder>/CLAUDE.md` — edit that file for the target group.
- Container runtime behavior (provider, model, packages, MCP servers) lives in the `container_configs` table: `ncl groups config get/update --id <group-id>`.

### Adding New Commands

Questions to ask:
- What should the command do?
- Which agent group(s)?
- Does it need new MCP tools?

Implementation:
- The agent interprets requests naturally — add instructions to the agent group's `groups/<folder>/CLAUDE.md`.
- For routing or trigger changes (which messages wake which agent group), update the wiring's trigger rules: `ncl wirings update --id <wiring-id> ...`.

### Changing Deployment

Questions to ask:
- Target platform? (Linux server, different Mac)
- Service manager? (launchd, systemd)

Implementation:
1. Create the appropriate service files.
2. Update paths in `.env` / config.
3. Provide setup instructions.

## After Changes

Always tell the user.

Run from your NanoClaw project root:

```bash
# Rebuild and restart
pnpm run build
source setup/lib/install-slug.sh
# macOS:
launchctl unload ~/Library/LaunchAgents/$(launchd_label).plist
launchctl load ~/Library/LaunchAgents/$(launchd_label).plist
# Linux:
# systemctl --user restart $(systemd_unit)
```

## Example Interaction

User: "Add Telegram as an input channel"

1. Run `/add-telegram` to install the adapter, wire its registration, and build.
2. Ask: "Should Telegram reach an existing agent group, or a new one?"
3. Ask: "Share an agent group with your other channels, or keep Telegram separate?"
4. Run `/manage-channels` (or `ncl messaging-groups create` + `ncl wirings create`) to create the messaging group and wire it to the chosen agent group with a session mode and trigger rules.
5. Tell the user how to authenticate and test.

© nanocoai · MIT · nanocoai/nanoclaw

Похожие скиллы

Каталог скиллов SKILL.md →

Сначала — customize от других авторов.

customize официальный anthropics Скилл customize для переноса уязвимостей-pipeline с C/C++ на другие языки, домены и типы целей. Превращает опциональный демо в шаблон: замени детектор, промпты и целевую среду — и pipeline начнёт искать то, что нужно тебе. CX Codex +1 1 100установок customize официальный anthropics Скилл customize меняет отдельные разделы профиля практики AI governance без повторного стартового интервью. Подходит для правки рисков, контактов эскалации и рабочих путей. CX Codex +1 644установок customize официальный Anthropic Скилл customize для Claude Code меняет отдельные параметры профиля регуляторной практики. Запускается по запросу изменить список регуляторов, порог существенности или другой раздел. CX Codex +1 ★ 10 060звёзд репо customize официальный Anthropic Скилл customize для Claude Code меняет отдельные настройки профиля продуктового юриста. Он запускается по просьбе обновить профиль, калибровку рисков или раздел ревью. CX Codex +1 ★ 10 060звёзд репо customize официальный Anthropic Скилл customize для Claude Code меняет отдельные настройки профиля privacy practice. Он запускается по просьбе обновить профиль, playbook или конкретный раздел. CX Codex +1 ★ 10 060звёзд репо community-marketing coreyhaines31 Скилл community-marketing для Claude Code, Codex, Cursor и других ИИ-сред. Помогает проектировать, запускать и растить сообщества вокруг продукта. CX Codex +1 101 200установок slack-gif-creator официальный anthropics Скилл slack-gif-creator помогает создавать анимированные GIF для Slack и проверять их параметры. Подходит для эмодзи и GIF в сообщениях. CX Codex +1 75 256установок Nia nozomio-labs Индексирует репозитории, документацию, статьи, датасеты и рабочие чаты, ищет по ним через API Nia — возвращает полный исходник вместо обрезанной веб-выдачи. CX Codex +1 56 300установок connector-slack caffeinelabs Скилл connector-slack учит агента отправлять сообщения в канал Slack из Caffeine-канистры через пакет slack-client. Рецепт помечен как экспериментальный. CX Codex +1 18 400установок developer-community-launch Samuel Berthe Скилл developer-community-launch помогает решить, нужен ли разработчикам отдельный канал общения, выбрать площадку и спланировать запуск сообщества с нуля. CX Codex +1 13 800установок devrel-radar Samuel Berthe Скилл devrel-radar собирает личный список источников по developer relations под ваш недельный бюджет времени и следит, чтобы он не протух. CX Codex +1 13 800установок

Из того же набора4

Спонсоры проекта

Компании, которые помогают держать аналитику открытой