How do I authenticate with Codex during setup?

You can choose between Codex OAuth (using the Codex CLI) or manually entering an API key which the skill will securely store in your environment variables.

Does this skill work on both macOS and Linux?

Yes, the skill automatically detects your operating system and configures the appropriate container runtime, using Apple Container for macOS and Docker for Linux.

How do I start the background service after setup?

The skill automatically creates and loads a launchd plist on macOS, ensuring NanoClaw runs in the background and starts automatically on reboot.

Can I control which folders the AI agent can access?

Absolutely. The setup includes a dedicated step for configuring a 'Mount Allowlist' where you can specify read-only or read-write permissions for specific directories.

What happens if the setup process is interrupted?

The skill is designed to be idempotent; you can trigger 'setup' again to resume or verify specific sections like Telegram registration or dependency installation.

NanoClaw Setup

Name: NanoClaw Setup
Author: chrisfrantz

bychrisfrantz

•

Deployment & DevOps

Automates the end-to-end installation, container configuration, and service deployment for the NanoClaw agent framework.

The NanoClaw Setup skill provides a comprehensive, guided workflow for initializing the NanoClaw AI agent environment. It automates technical hurdles such as detecting platform-specific container runtimes (Apple Container or Docker), managing Codex CLI authentication, and configuring Telegram bot integrations. Beyond simple installation, it helps users establish secure directory access patterns through a mount allowlist and sets up persistent background services using launchd, ensuring the assistant is ready for production use with minimal manual effort.

Key Features

01Streamlined Codex OAuth and API key authentication management

02Guided Telegram bot creation and automated chat registration

03Persistent background service deployment and log configuration

04Automatic platform detection and container runtime setup (Docker or Apple Container)

051 GitHub stars

06Granular filesystem security with external directory mount allowlists

Use Cases

01Configuring secure local directory access for AI agents to edit codebases

02First-time installation of the NanoClaw framework on macOS or Linux

03Migrating NanoClaw environments between different container runtimes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add chrisfrantz/nanoclaw setup

For use in Claude.ai and ChatGPT

Download Skill