# NanoClaw AIO

NanoClaw AIO is an all-in-one Unraid container that turns Telegram into a chat interface for Claude-powered AI assistant workflows. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2224/nanoclaw-aio

## Description

NanoClaw AIO is an all-in-one Unraid container that turns Telegram into a chat interface for Claude-powered AI assistant workflows. It packages upstream NanoClaw v2 with a nested helper image for isolated agent work, and its advanced view exposes Claude credential aliases and a OneCLI gateway, making it suited for homelab users who want a chat-driven agent without building the stack themselves.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

40/100 (Fair), based on 4 of 4 factors.
- Maintained: 67 (last commit 155 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/jsonbored/nanoclaw-aio
- Official website: https://aethereal.dev
- GitHub: https://github.com/JSONbored/nanoclaw-aio
- Unraid: https://ca.unraid.net/apps/nanoclaw-aio-1sjta5o0dpwsbk?q=nanoclaw-aio

## Common questions

### What Unraid mount does nanoclaw-aio need to spawn isolated agent containers?

Mount /var/run/docker.sock. Keep the container /appdata path aligned with the host path if you use a custom appdata location, because helper containers use that host-visible runtime source.

### Do I need to install the nanoclaw-agent helper as a separate Unraid app?

No, jsonbored/nanoclaw-agent is a sandbox helper image used by nanoclaw-aio. It is not a separate Community Apps template at present.

### How do I pair the main Telegram chat after first start?

Start the container and watch the logs for PAIR_TELEGRAM_CODE. Send that code to your Telegram bot to pair the main chat.

### What Claude credentials can I use in the AIO template?

Set one Claude credential: ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN, or ANTHROPIC_AUTH_TOKEN. You can also override related endpoints like ANTHROPIC_BASE_URL if needed.

### Why does the agent ignore some Telegram messages?

Start the message with the trigger word, such as @Andy, because matching is case-insensitive but only works when the trigger is first. If the trigger is missing or comes after other words, the agent ignores the message.

---
Source: Our Local Host (https://ourlocalhost.com/app/2224/nanoclaw-aio), the self-hosted and open-source app directory.
