setup

Automate NanoClaw installation and configuration across git, Node.js, and container runtimes.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/spyqs/nanoclaw-email-imap --skill setup-spyqs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/spyqs/nanoclaw-email-imap/tree/main/.claude/skills/setup
Command: npx skills add https://github.com/spyqs/nanoclaw-email-imap --skill setup-spyqs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the friction of getting NanoClaw running by automatically installing prerequisites, configuring the environment, setting up container runtime and services, and initializing your messaging channels.

Core Features & Use Cases

  • Bootstraps dependencies reliably: Ensures Node.js and build prerequisites are present, then bootstraps the app using the repo’s setup scripts.
  • Configures container runtime and builds: Selects Docker or macOS native container runtime, performs conversion when needed, builds the container images, and runs tests.
  • Sets up authentication and channels: Guides Claude authentication and delegates channel setup to the appropriate channel skills for credentials, registration, and JID correctness.
  • Hardens agent access: Sets mount allowlists based on your choices so agents only access approved directories.
  • Starts and verifies services: Starts the background service and runs verification checks, repairing common failures like stopped services, missing credentials, or mount configuration issues.

Quick Start

Run the setup skill when you first install NanoClaw so it installs dependencies, configures channels, mounts access, starts the service, and verifies everything is working.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bootstrap NanoClaw end-to-end on macOS and Windows?

NanoClaw setup automates the initial installation and configuration by running setup.sh and npx tsx setup/index.ts, which handles git setup, Node.js bootstrapping, container runtime selection, image building, channel authentication, and service verification across macOS and Windows/WSL.

What does NanoClaw service orchestration setup include for Docker sandboxes?

NanoClaw service orchestration setup selects Docker or native container runtime, performs image conversion when needed, builds the container images, runs tests, and configures mount allowlists so agents only access approved directories.

Why does my NanoClaw environment configuration fail to start the service?

NanoClaw environment configuration services fail when required components are missing, credentials are absent, or mount configurations are incorrect. The setup workflow runs verification checks and repairs common failures like stopped services and missing credentials automatically.

Can I use NanoClaw setup to configure messaging channel authentication?

Yes, NanoClaw setup sets up authentication and delegates channel provisioning to dedicated channel skills for credentials, registration, and JID correctness, handling interactive user questions for secrets and permissions during the workflow.

Do I need Docker installed to build NanoClaw container runtime images?

NanoClaw setup selects between Docker and macOS native container runtime, performing conversion when needed, building the container images, and running tests. It ensures Node.js and build prerequisites are present before bootstrapping the app.