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.