nanoclaw-aio

nanoclaw-aio

Aplicación Docker from JSONbored's Repository

Visión general

NanoClaw is a Telegram-first AI agent orchestrator for running Claude-powered assistant workflows from chat.

All-In-One Unraid Edition
nanoclaw-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)

  1. Install this template and leave [code]Appdata Directory[/code] and [code]Host Appdata Path[/code] aligned unless you intentionally use a custom appdata path.
  2. Set [code]TELEGRAM_BOT_TOKEN[/code] from BotFather.
  3. Set [code]ANTHROPIC_API_KEY[/code] or one of the advanced Claude credential options.
  4. Start the container and watch the logs for [code]PAIR_TELEGRAM_CODE[/code].
  5. 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].

Requisitos

NanoClaw requires a Telegram bot token and at least one Claude credential. Enable the advanced Docker socket mount for nested jsonbored/nanoclaw-agent helper containers; this grants host-level Docker control.

Argumentos en tiempo de ejecución

Red
bridge
Concha
sh
Privilegiado
false

Configuración de plantillas

Appdata DirectoryPathrw

Persistent NanoClaw data: databases, logs, groups, channel state, env files, and host-visible runtime files for nested agent containers.

Objetivo
/appdata
Por defecto
/mnt/user/appdata/nanoclaw-aio
Docker SocketPathrw

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.

Objetivo
/var/run/docker.sock
Telegram Bot TokenVariable

Bot token from @BotFather. After startup, send the PAIR_TELEGRAM_CODE from the logs to this bot.

Objetivo
TELEGRAM_BOT_TOKEN
Anthropic API KeyVariable

Claude API key. Use this or one of the advanced Claude credential options.

Objetivo
ANTHROPIC_API_KEY
Host Appdata PathVariable

Host-side path matching the Appdata Directory mount. Nested agent containers need this host path when the AIO talks to the host Docker daemon.

Objetivo
NANOCLAW_HOST_APPDATA_DIR
Por defecto
/mnt/user/appdata/nanoclaw-aio
Claude Code OAuth TokenVariable

Optional Claude Code OAuth-style credential. Use instead of ANTHROPIC_API_KEY when applicable.

Objetivo
CLAUDE_CODE_OAUTH_TOKEN
Anthropic Auth TokenVariable

Optional Claude/Anthropic auth token for runtimes that expect ANTHROPIC_AUTH_TOKEN.

Objetivo
ANTHROPIC_AUTH_TOKEN
Anthropic Base URLVariable

Optional Anthropic-compatible API endpoint override.

Objetivo
ANTHROPIC_BASE_URL
OneCLI URLVariable

Optional OneCLI gateway URL for NanoClaw agent credential injection.

Objetivo
ONECLI_URL
OneCLI API KeyVariable

Optional OneCLI API key.

Objetivo
ONECLI_API_KEY
Agent ImageVariable

Helper image used for spawned agent containers. Advanced users may point this to a custom built agent image.

Objetivo
CONTAINER_IMAGE
Por defecto
jsonbored/nanoclaw-agent:v2.0.64-agent.2
Agent Image BaseVariable

Base repository NanoClaw uses when building per-agent customized helper images.

Objetivo
CONTAINER_IMAGE_BASE
Por defecto
jsonbored/nanoclaw-agent
Container TimeoutVariable

Agent container timeout in milliseconds.

Objetivo
CONTAINER_TIMEOUT
Por defecto
1800000
Idle TimeoutVariable

Idle timeout in milliseconds for keeping agent containers warm after results.

Objetivo
IDLE_TIMEOUT
Por defecto
1800000
Max Output SizeVariable

Maximum captured output from an agent container in bytes.

Objetivo
CONTAINER_MAX_OUTPUT_SIZE
Por defecto
10485760
Max Messages Per PromptVariable

Maximum message history items NanoClaw passes into a prompt.

Objetivo
MAX_MESSAGES_PER_PROMPT
Por defecto
10
Max Concurrent ContainersVariable

Maximum number of concurrent NanoClaw agent containers.

Objetivo
MAX_CONCURRENT_CONTAINERS
Por defecto
5
Log LevelVariable

NanoClaw log level.

Objetivo
LOG_LEVEL
Por defecto
info
Assistant NameVariable

Assistant trigger name used by NanoClaw. Example trigger: @nanoclaw

Objetivo
ASSISTANT_NAME
Por defecto
nanoclaw
Assistant Has Own NumberVariable

Set true only when your NanoClaw assistant has its own dedicated channel identity.

Objetivo
ASSISTANT_HAS_OWN_NUMBER
Por defecto
false
Auto Pair TelegramVariable

When true, the container starts the pairing-code watcher on first boot.

Objetivo
NANOCLAW_AUTO_PAIR_TELEGRAM
Por defecto
true
TimezoneVariable

Timezone used by scheduled tasks and formatted timestamps.

Objetivo
TZ
Por defecto
UTC

Descargar estadísticas

1,171
Descargas totales

Detalles

Repositorio
jsonbored/nanoclaw-aio:latest
Última actualización2026-05-26
Visto por primera vez2026-05-18

Ejecute nanoclaw-aio en Unraid.

nanoclaw-aio se encuentra en Community Apps para Unraid OS. Explore Unraid para crear un servidor doméstico flexible, un NAS o un laboratorio doméstico.