NanoClaw AIO
NanoClaw AIO is an all-in-one Unraid container that turns Telegram into a chat interface for Claude-powered AI assistant workflows.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
40/100 Fair
- Maintained
- 67last commit 155 days ago
- Popular
- 61 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 304 GB minimum RAM
Availability: platform listings confirmed today, links checked 30 days ago
- GitHub stars
- 1
- Open issues
- 1
- Last commit
- 2026-06-18
- Latest release
- v2.1.17-aio.2
- Activity
- stale
Checked 9 days ago - source: GitHub (JSONbored/nanoclaw-aio)
Resources & Compatibility
Minimum requirements: 4 GB RAM, 4 CPU core(s), 64 GB disk. ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Run the provided install script first Clone the repo and run nanoclaw.sh; it checks for and installs missing tools such as Node (a JavaScript runtime), pnpm (a package manager), and Docker (a container runtime), then registers your Anthropic credentials (the API key that lets it use Anthropic's service). Without it, setup can stall or the agent may not be able to connect to Anthropic. source
- Start messages with @Andy When you message the agent, put the trigger word @Andy at the very start, like @Andy what's up? because matching is case-insensitive but only works when the trigger is first. If it is missing or comes after other words, the agent will ignore the message. source
- Choose your chat channel in setup During setup, you may be asked for a display name and a channel choice, such as Telegram; the setup flow records these choices in its progression log. Pick the channel you actually want to use, because if you choose the wrong one, you may end up with setup details for a chat service you do not use. source
- Setup Install the Community Apps template and leave the Appdata Directory and Host Appdata Path aligned unless intentionally using a custom path. Set TELEGRAM_BOT_TOKEN from BotFather and ANTHROPIC_API_KEY (or an advanced Claude credential option). source
- Pairing Start the container, copy the PAIR_TELEGRAM_CODE shown in the logs, and send that code to your Telegram bot to pair the main chat. source
Fetched 39 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
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.
Answers sourced from github.com, github.com
Community
- Reddit (reddit)
Collected 46 days ago - public community threads