setup

Automate NanoClaw setup with Docker or Apple Container, WhatsApp authentication, and service startup.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the lengthy, error-prone initial setup of the NanoClaw assistant so users can quickly get a secure, containerized Claude instance running without manual debugging of dependencies, runtimes, authentication, or services.

Core Features & Use Cases

  • End-to-end bootstrap: Runs the bootstrap script, installs Node and dependencies when missing, and retries failed native builds.
  • Container runtime management: Detects and chooses between Docker and Apple Container, performs conversion checks, installs or starts runtimes, builds images, and diagnoses build/test failures.
  • Authentication and channel registration: Guides WhatsApp authentication choices, configures triggers and channel types, mounts allowlists, and registers the main channel.
  • Service orchestration and verification: Starts the background service, handles systemd/launchctl edge cases, applies fixes like setfacl when needed, and verifies overall system health.

Quick Start

Run the setup skill to install dependencies, authenticate WhatsApp, select and prepare the container runtime, register your main channel, and start the NanoClaw services.

Frequently Asked Questions about setup

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

FAQPage Schema
How do I automate Docker container setup and WhatsApp authentication for a Claude assistant?

The setup process detects Docker and Apple Container runtimes, performs conversion checks, installs or starts the appropriate runtime, builds images, and diagnoses build or test failures automatically.

What's the best way to configure a containerized Claude instance without manually resolving dependencies?

Service orchestration handles systemd and launchctl edge cases automatically, applies fixes like setfacl when needed, and verifies overall system health after starting the NanoClaw services.

Does the NanoClaw setup process support both Docker and Apple Container runtimes?

Runtime selection happens automatically during the bootstrap phase, ensuring the container environment is prepared without manual intervention or separate configuration steps.

Why does WhatsApp authentication fail during initial NanoClaw installation?

Authentication issues are handled through structured status output parsing, which identifies the failure point and applies retry logic to complete the channel registration successfully.

Can I register a WhatsApp channel and mount allowlists without manually editing configuration files?

The automated process parses structured status outputs to confirm successful registration and provides diagnostic information if any step in the channel setup fails.

How do I fix NanoClaw service startup failures on systemd or launchctl?

Diagnostics parse structured status outputs to identify the specific failure point, then retry paths attempt to resolve the issue by installing missing dependencies or adjusting service configuration.