setup

Automate NanoClaw installation, runtime setup, and channel authentication.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the initial NanoClaw installation and configuration, removing the need for manual dependency installs, runtime selection, channel authentication, and service troubleshooting that often block first-time use.

Core Features & Use Cases

  • Bootstrap and dependency repair: runs the bootstrap script, installs or upgrades Node.js, reinstalls dependencies, and installs native build tools when native modules fail.
  • Container runtime and build orchestration: detects Docker or Apple Container, prompts for conversion if required, builds and tests container images, and provides retry and log-driven diagnostics for build/test failures.
  • Channel authentication and registration: guides interactive WhatsApp authentication, collects tokens for Telegram/Slack/Discord, resolves chat IDs, and registers the main channel with trigger and assistant settings.
  • Service management and verification: configures mounts and allowlists, handles macOS, Linux, and WSL service edge cases, starts or restarts the NanoClaw service, and verifies runtime health with structured status checks. Use case example: preparing a developer laptop or server to run NanoClaw, authenticate a messaging channel, and reliably start background agents with automated fixes for common failures.

Quick Start

Ask the assistant to run the NanoClaw setup to install dependencies, authenticate selected channels, build the runtime, and start the background services.

Frequently Asked Questions about setup

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

FAQPage Schema
How do I automate NanoClaw installation and configure the container runtime?

NanoClaw installation is automated by running a bootstrap script that detects Docker or Apple Container, installs Node.js, resolves dependencies, and builds container images with interactive prompts and log-based diagnostics for failures.

How do I authenticate WhatsApp and register messaging channels for NanoClaw?

WhatsApp authentication is guided interactively during setup, while tokens for Telegram, Slack, or Discord are collected to resolve chat IDs and register the main channel with trigger and assistant settings.

Does NanoClaw setup support service management on macOS, Linux, and WSL?

NanoClaw setup handles service management across macOS, Linux, and WSL by configuring mounts and allowlists, addressing platform-specific edge cases, and starting or restarting background agents with structured health verification.

Why does my NanoClaw container build fail during initial setup?

Container build failures are diagnosed using log-driven outputs, with automated retries and native build tool installation to repair failed native modules and ensure the runtime image builds correctly.

What is the best way to provision a server for running NanoClaw background agents?

Provisioning a server for NanoClaw involves running the setup Skill to install dependencies, select the container runtime, authenticate messaging channels, and verify background service health through structured status checks.

Can I use Apple Container instead of Docker for NanoClaw runtime orchestration?

Apple Container is supported alongside Docker for NanoClaw runtime orchestration, with the setup process detecting the available runtime and prompting for conversion if required to build and test container images.