debug

Diagnose NanoClaw container failures involving mounts, environment variables, and MCP initialization.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/LIMITLESS-LONGEVITY/limitless --skill debug-limitless-longevity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/LIMITLESS-LONGEVITY/limitless/tree/main/apps/nanoclaw/.claude/skills/debug
Command: npx skills add https://github.com/LIMITLESS-LONGEVITY/limitless --skill debug-limitless-longevity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers and operators quickly diagnose and resolve failures in the NanoClaw containerized agent system, including authentication errors, container crashes, missing mounts, and session persistence issues.

Core Features & Use Cases

  • Authentication checks: Validate presence and propagation of CLAUDE_CODE_OAUTH_TOKEN or ANTHROPIC_API_KEY and troubleshoot related error messages.
  • Mounts and permissions: Explain expected mount points and ownership for /workspace and /home/node/.claude and how to inspect mounts inside the container.
  • Logs and session recovery: Locate host and container logs, inspect container-run outputs, verify session resumption, and diagnose MCP server startup failures.

Quick Start

Run the quick diagnostic checklist to verify .env presence, container image availability, mount paths, log files, and session continuity.

Frequently Asked Questions about debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot container agent authentication failures and missing OAuth tokens?

Troubleshoot container agent authentication failures by validating the presence and propagation of CLAUDE_CODE_OAUTH_TOKEN or ANTHROPIC_API_KEY environment variables to resolve related error messages.

Why does my containerized agent crash due to incorrect mount targets or ownership?

Containerized agent crashes occur when mount targets and ownership for /workspace and /home/node/.claude are misconfigured; inspect mounts inside the container to verify expected paths and permissions.

How do I diagnose session persistence issues and recover container sessions?

Diagnose session persistence issues by verifying session directories, inspecting container-run outputs, and checking host and container logs to confirm session resumption and continuity.

What is the best way to debug MCP server initialization failures during container deployment?

Debug MCP server initialization failures by locating host and container logs, inspecting container-run outputs, and verifying session directories and environment variables during development and deployment.

How do I verify environment misconfigurations and .env file presence for local container runners?

Verify environment misconfigurations by running a quick diagnostic checklist to confirm .env file presence, container image availability, mount paths, and log files for local container runners.

When should I rebuild the container image to resolve runtime crashes or authentication errors?

Rebuild the container image to resolve runtime crashes or authentication errors after verifying mount targets, ownership, authentication tokens, and container logs indicate persistent environment misconfigurations.