NanoClaw AIO

NanoClaw AIO is an all-in-one Unraid container that turns Telegram into a chat interface for Claude-powered AI assistant workflows.

  • AI
  • Network Services
  • Productivity
  • Tools & Utilities
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
  • 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

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

Collected 46 days ago - public community threads