debug

Diagnoses NanoClaw container agent issues via logs, environment, and permissions.

2|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/heuuLZP/nanoclaw-cn --skill debug-heuulzp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/heuuLZP/nanoclaw-cn/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/heuuLZP/nanoclaw-cn --skill debug-heuulzp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve issues with the containerized agent execution system, ensuring smooth operation and understanding of its architecture.

Core Features & Use Cases

  • Log Analysis: Pinpoints locations for main app, container run, and Claude session logs.
  • Environment Variable Debugging: Guides on verifying and troubleshooting environment variable passing into the container.
  • Mount Point Verification: Details expected container mount structures and how to check them.
  • Permission Issues: Addresses common user permission problems within the container.
  • Session Resumption: Explains and helps fix issues with Claude session persistence.
  • IPC Debugging: Provides insights into inter-process communication between host and container.
  • Use Case: If your agent is failing to start, returning authentication errors, or not resuming conversations, this skill provides the step-by-step diagnostics to identify and fix the root cause.

Quick Start

Run the quick diagnostic script to check common container setup issues.

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 startup failures and authentication errors?

Troubleshoot container agent startup failures by running a quick diagnostic script to check common setup issues, analyzing main app logs, verifying environment variables, and checking mount point structures to identify the root cause.

Why does my container agent fail to resume Claude session persistence?

Container agent session persistence fails due to incorrect mount structures or inter-process communication errors between host and container; diagnose by verifying session logs and checking IPC channels to restore conversation continuity.

How do I verify environment variables and mount points in a containerized agent system?

Verify containerized agent environment variables and mount points by checking expected container mount structures and troubleshooting variable passing mechanisms to ensure correct configuration and agent execution.

How do I fix user permission issues within a container agent environment?

Fix container agent user permission issues by following permission troubleshooting guides to address common access problems, ensuring the containerized execution system operates smoothly without authorization blocks.

What is the best way to diagnose inter-process communication between host and container for agents?

Diagnose host and container inter-process communication for agents by using provided IPC debugging insights to identify and resolve communication blockages affecting container agent execution and session stability.