nanoclaw-aio
nanoclaw-aio
Docker app from JSONbored's Repository
Overview
NanoClaw is a Telegram-first AI agent orchestrator for running Claude-powered assistant workflows from chat.
All-In-One Unraid Editionnanoclaw-aio packages NanoClaw v2 into one Unraid-first container and uses the paired [code]jsonbored/nanoclaw-agent[/code] helper image for isolated agent work.
Quick Install (Beginners)
- Install this template and leave [code]Appdata Directory[/code] and [code]Host Appdata Path[/code] aligned unless you intentionally use a custom appdata path.
- Set [code]TELEGRAM_BOT_TOKEN[/code] from BotFather.
- Set [code]ANTHROPIC_API_KEY[/code] or one of the advanced Claude credential options.
- Start the container and watch the logs for [code]PAIR_TELEGRAM_CODE[/code].
- Send that pairing code to your Telegram bot to pair the main chat.
Power Users (Advanced View)
- Advanced View exposes Claude credential aliases, OneCLI gateway settings, helper image overrides, concurrency/timeouts, logging, and assistant identity controls.
- Keep [code]CONTAINER_IMAGE[/code] and [code]CONTAINER_IMAGE_BASE[/code] on the JSONbored defaults unless you build and maintain your own compatible agent helper image.
- [code]NANOCLAW_HOST_APPDATA_DIR[/code] must match the host-side path for [code]/appdata[/code] because nested helper containers are launched through the host Docker daemon.
Important Notes
- This template is marked beta while the NanoClaw v2 runtime gets more real-world Unraid soak time.
- The Docker socket mount is an advanced opt-in setting because NanoClaw launches paired helper containers through the host Docker daemon, which grants host-level Docker control. NanoClaw cannot run helper containers until that mount is enabled.
- Persistent databases, logs, groups, env files, and channel state live under [code]/appdata[/code].
Requirements
Runtime arguments
- Network
bridge- Shell
sh- Privileged
- false
Template configuration
Persistent NanoClaw data: databases, logs, groups, channel state, env files, and host-visible runtime files for nested agent containers.
- Target
- /appdata
- Default
- /mnt/user/appdata/nanoclaw-aio
Advanced opt-in security-sensitive mount. NanoClaw v2 needs the Docker socket to spawn nested jsonbored/nanoclaw-agent helper containers, which grants host-level Docker control access.
- Target
- /var/run/docker.sock
Bot token from @BotFather. After startup, send the PAIR_TELEGRAM_CODE from the logs to this bot.
- Target
- TELEGRAM_BOT_TOKEN
Claude API key. Use this or one of the advanced Claude credential options.
- Target
- ANTHROPIC_API_KEY
Host-side path matching the Appdata Directory mount. Nested agent containers need this host path when the AIO talks to the host Docker daemon.
- Target
- NANOCLAW_HOST_APPDATA_DIR
- Default
- /mnt/user/appdata/nanoclaw-aio
Optional Claude Code OAuth-style credential. Use instead of ANTHROPIC_API_KEY when applicable.
- Target
- CLAUDE_CODE_OAUTH_TOKEN
Optional Claude/Anthropic auth token for runtimes that expect ANTHROPIC_AUTH_TOKEN.
- Target
- ANTHROPIC_AUTH_TOKEN
Optional Anthropic-compatible API endpoint override.
- Target
- ANTHROPIC_BASE_URL
Optional OneCLI gateway URL for NanoClaw agent credential injection.
- Target
- ONECLI_URL
Optional OneCLI API key.
- Target
- ONECLI_API_KEY
Helper image used for spawned agent containers. Advanced users may point this to a custom built agent image.
- Target
- CONTAINER_IMAGE
- Default
- jsonbored/nanoclaw-agent:v2.0.64-agent.2
Base repository NanoClaw uses when building per-agent customized helper images.
- Target
- CONTAINER_IMAGE_BASE
- Default
- jsonbored/nanoclaw-agent
Agent container timeout in milliseconds.
- Target
- CONTAINER_TIMEOUT
- Default
- 1800000
Idle timeout in milliseconds for keeping agent containers warm after results.
- Target
- IDLE_TIMEOUT
- Default
- 1800000
Maximum captured output from an agent container in bytes.
- Target
- CONTAINER_MAX_OUTPUT_SIZE
- Default
- 10485760
Maximum message history items NanoClaw passes into a prompt.
- Target
- MAX_MESSAGES_PER_PROMPT
- Default
- 10
Maximum number of concurrent NanoClaw agent containers.
- Target
- MAX_CONCURRENT_CONTAINERS
- Default
- 5
NanoClaw log level.
- Target
- LOG_LEVEL
- Default
- info
Assistant trigger name used by NanoClaw. Example trigger: @nanoclaw
- Target
- ASSISTANT_NAME
- Default
- nanoclaw
Set true only when your NanoClaw assistant has its own dedicated channel identity.
- Target
- ASSISTANT_HAS_OWN_NUMBER
- Default
- false
When true, the container starts the pairing-code watcher on first boot.
- Target
- NANOCLAW_AUTO_PAIR_TELEGRAM
- Default
- true
Timezone used by scheduled tasks and formatted timestamps.
- Target
- TZ
- Default
- UTC
Download Statistics
Details
jsonbored/nanoclaw-aio:latestRun nanoclaw-aio on Unraid.
nanoclaw-aio is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.