Skip to content
Get packs

NanoClaw Container Debugging

Troubleshoot NanoClaw agent containers, logs, session databases and mounts

Source Download skill
Repository
nanocoai/nanoclaw
Stars
31,072
Licence
MIT
Files
1 file

What it does

This skill gives an AI agent a detailed troubleshooting guide for NanoClaw, a system that runs AI agents in isolated containers for chat channels. When something breaks, the agent knows where the logs live, how to inspect the message databases shared between the host and each container, how to turn on verbose debug logging, and how to recognise common failures such as messages being silently lost. It is a reference manual for diagnosing a NanoClaw installation rather than a general coding skill.

Great for

  • Developers who run a NanoClaw install and see messages not getting replies
  • Maintainers diagnosing container spawn, authentication or delivery failures
  • Anyone who wants an agent to explain how NanoClaw's host and container exchange messages

Skip it if

  • Projects unrelated to NanoClaw, since the paths, commands and architecture are specific to it
  • Non-technical users without access to a terminal and the NanoClaw checkout, because many steps require running commands and reading logs
  • Anyone who should not let an agent query or repair live credential gateway services, since the guide includes steps that re-run setup against the gateway and touch its database volumes and keys

Try asking

  • “My NanoClaw bot stopped replying on Telegram. Help me debug it using the logs and session databases.”
  • “Check whether my last message reached the container and whether the agent produced a reply.”
  • “The container fails to start. Walk me through the debug logging setup and what to look for.”
  • “Explain how the host and container communicate in NanoClaw.”
Step-by-step guide: how to use NanoClaw Container DebuggingInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    debug.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip debug.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip debug.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Start with logs/nanoclaw.error.log and the session DB checks, as the guide recommends, before changing configuration.
  • Run the agent from within the NanoClaw repository so relative paths like data/v2.db and scripts/q.ts resolve correctly.
  • Review any suggested gateway repair command before running it, especially steps that touch database volumes or keys.

What's inside

  • SKILL.md

Redistributed unmodified from nanocoai/nanoclaw under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.