nanoclaw-aio

nanoclaw-aio

Docker 应用程序 from JSONbored's Repository

概述

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].

要求

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.

运行时参数

网络
bridge
外壳
sh
特权
false

模板配置

Appdata DirectoryPathrw

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

目标
/appdata
默认值
/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.

目标
/var/run/docker.sock
Telegram Bot TokenVariable

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

目标
TELEGRAM_BOT_TOKEN
Anthropic API KeyVariable

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

目标
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.

目标
NANOCLAW_HOST_APPDATA_DIR
默认值
/mnt/user/appdata/nanoclaw-aio
Claude Code OAuth TokenVariable

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

目标
CLAUDE_CODE_OAUTH_TOKEN
Anthropic Auth TokenVariable

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

目标
ANTHROPIC_AUTH_TOKEN
Anthropic Base URLVariable

Optional Anthropic-compatible API endpoint override.

目标
ANTHROPIC_BASE_URL
OneCLI URLVariable

Optional OneCLI gateway URL for NanoClaw agent credential injection.

目标
ONECLI_URL
OneCLI API KeyVariable

Optional OneCLI API key.

目标
ONECLI_API_KEY
Agent ImageVariable

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

目标
CONTAINER_IMAGE
默认值
jsonbored/nanoclaw-agent:v2.0.64-agent.2
Agent Image BaseVariable

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

目标
CONTAINER_IMAGE_BASE
默认值
jsonbored/nanoclaw-agent
Container TimeoutVariable

Agent container timeout in milliseconds.

目标
CONTAINER_TIMEOUT
默认值
1800000
Idle TimeoutVariable

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

目标
IDLE_TIMEOUT
默认值
1800000
Max Output SizeVariable

Maximum captured output from an agent container in bytes.

目标
CONTAINER_MAX_OUTPUT_SIZE
默认值
10485760
Max Messages Per PromptVariable

Maximum message history items NanoClaw passes into a prompt.

目标
MAX_MESSAGES_PER_PROMPT
默认值
10
Max Concurrent ContainersVariable

Maximum number of concurrent NanoClaw agent containers.

目标
MAX_CONCURRENT_CONTAINERS
默认值
5
Log LevelVariable

NanoClaw log level.

目标
LOG_LEVEL
默认值
info
Assistant NameVariable

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

目标
ASSISTANT_NAME
默认值
nanoclaw
Assistant Has Own NumberVariable

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

目标
ASSISTANT_HAS_OWN_NUMBER
默认值
false
Auto Pair TelegramVariable

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

目标
NANOCLAW_AUTO_PAIR_TELEGRAM
默认值
true
TimezoneVariable

Timezone used by scheduled tasks and formatted timestamps.

目标
TZ
默认值
UTC

下载统计数据

1,171
下载总数

详细信息

存储库
jsonbored/nanoclaw-aio:latest
最后更新2026-05-26
初见2026-05-18

在Unraid 上运行 nanoclaw-aio 。

nanoclaw-aio 已被列入Unraid OS 的社区应用程序。探索Unraid ,构建灵活的家庭服务器、NAS 或家庭实验室。