debug

Diagnose and fix containerized NanoClaw agent issues via logs and environment checks.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/zhaosj0315/nanoclaw --skill debug-zhaosj0315
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/zhaosj0315/nanoclaw/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/zhaosj0315/nanoclaw --skill debug-zhaosj0315

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix issues in the containerized NanoClaw agent.

Core Features & Use Cases

  • Log analysis: Identify and interpret host and container logs to pinpoint failures.
  • Environment validation: Verify required environment variables and home directories for session resumption.
  • Container orchestration: Diagnose container-runner configurations, IPC paths, and session persistence.

Quick Start

Run a quick diagnostic by inspecting logs at groups//logs/container-.log, verify IPC paths and environment variables, and check session persistence under data/sessions for the current group. Use the Quick Diagnostic Script from the repository for a baseline check.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I debug container issues and decipher logs for a failed agent?

To debug container issues, inspect host and container logs at groups/*/logs/container-*.log to pinpoint failures, then verify IPC paths and environment variables to diagnose the root cause.

Why does my containerized agent fail session resumption?

Session resumption fails when required environment variables or home directories are misconfigured. Verify these settings and check session persistence under data/sessions for the current group.

What's the best way to diagnose container-runner configuration failures?

Diagnose container-runner failures by validating IPC paths, checking container orchestration configurations, and running the Quick Diagnostic Script from the repository to establish a baseline.

How do I validate environment variables for containerized agent deployments?

Validate environment variables by verifying required home directories and configurations against the expected container orchestration settings to ensure proper session persistence and IPC flows.

Can I restore normal operation after a container-related failure across development environments?

Yes, you can restore normal operation by following reproducible diagnostic steps, checking logs and IPC paths, and applying prescribed fixes to resolve common container-related failures across environments.

What logs do I need to inspect to identify container agent failures?

Inspect host and container logs located at groups/*/logs/container-*.log to identify and interpret failures, then cross-reference with IPC paths and session data for complete diagnosis.