JSONbored

Nanoclaw Aio — DevOps skill for Claude Code

DevOps community

Telegram-first All-in-One Unraid container for NanoClaw.

How to install Nanoclaw Aio

This entry records only its repository, not the path inside it, so there is no exact command to give. Open JSONbored/nanoclaw-aio and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Nanoclaw Aio does

Telegram-first All-in-One Unraid container for NanoClaw. Runs Claude-powered agents in isolated Docker containers using the official Telegram fork and native credential proxy patch, with persistent runtime state under /appdata and safer upgrades than mounting the full project tree.

Alternatives in DevOps

Claude Code GitHub Actions — by Anthropic - Official GitHub Actions integration for Claude Code with examples and documentation for automat 6.4k ★
Proxy — route Claude Code requests through multiple upstream providers (OpenCode Go, OpenCode Zen, and AWS Bedrock) wi 957 ★
Code On Incus — Give each AI agent its own isolated machine with root, Docker, and systemd 670 ★

README

nanoclaw-aio

NanoClaw packaged as a Telegram-first, Unraid-oriented AIO container.

This repo ships one installable Community Apps template and two container images from the same source repo:

jsonbored/nanoclaw-aio: the Unraid app container
jsonbored/nanoclaw-agent: the nested helper image spawned by NanoClaw for isolated agent work

`nanoclaw-agent` is not a separate Community Apps template right now. It is a sandbox/helper image used by `nanoclaw-aio`.

Current Release

Upstream NanoClaw: `nanocoai/nanoclaw` `v2.0.64`
Upstream commit: 0683c6ec589ec0df74c2a3d99f9544127317b490
Channels branch commit: 36fb78092c27737a2313c07244748a98b26c7d03
AIO image tag: v2.0.64-aio.4
Agent helper image tag: v2.0.64-agent.2

NanoClaw `main` may move ahead of the latest release. This package tracks stable upstream releases, not unreleased `main`.

What This Image Includes

NanoClaw v2 pinned to the current stable upstream release.
A Telegram-first control surface for starting and managing agent work.
A paired jsonbored/nanoclaw-agent helper image for isolated task containers.
A Docker-socket sibling-container model, matching NanoClaw v2's current runtime architecture.
Persistent appdata for databases, logs, groups, channel state, generated env files, and the host-visible runtime source used by helper containers.
A vendored Telegram channel adapter and pinned channels branch commit so first boot does not depend on a runtime git fetch.
A validated Unraid XML template in `nanoclaw-aio.xml`.

Beginner Install

Install the nanoclaw-aio template from Unraid Community Applications.
Keep the default /appdata path unless you also update NANOCLAW_HOST_APPDATA_DIR.
Mount /var/run/docker.sock.
Set TELEGRAM_BOT_TOKEN.
Set one Claude credential:
- ANTHROPIC_API_KEY
- CLAUDE_CODE_OAUTH_TOKEN
- `ANTHROPIC_AUTH_TO