Where can I find the agent execution logs?

Host-side logs are in logs/nanoclaw.log, while specific container execution output, including stderr and stdout, is found in groups/{folder}/logs/container-*.log.

How do I verify the container image is built correctly?

The skill includes manual testing commands to run an interactive shell or execute a diagnostic script that checks for the Codex CLI version and necessary node_modules.

How do I handle environment variables in Apple Containers?

Because Apple Containers may lose variables passed via -e in interactive mode, this skill suggests mounting authentication keys in a dedicated directory for internal sourcing.

What is the primary purpose of the NanoClaw debug skill?

It provides standardized procedures for troubleshooting the containerized environment where NanoClaw agents execute, focusing on logs, mounts, and Codex CLI stability.

Why is my Codex session not resuming correctly?

This is often caused by incorrect mount paths. The container expects session files at /home/node/.codex/ rather than /root/.codex/ for the session to persist.

NanoClaw Container Debugger

Name: NanoClaw Container Debugger
Author: chrisfrantz

bychrisfrantz

•

Deployment & DevOps

Troubleshoots and resolves issues within the NanoClaw containerized agent execution system.

The NanoClaw Container Debugger provides a comprehensive framework for diagnosing and fixing problems within specialized containerized environments. It offers deep visibility into the architecture of Apple Containers on macOS, mapping complex host-to-container volume mounts and environment variable passthroughs. This skill is essential for developers needing to resolve Codex CLI exit codes, session resumption failures, and IPC (Inter-Process Communication) bottlenecks, ensuring that AI agents maintain persistence and perform reliably across isolated execution environments.

Key Features

01Architecture mapping for host-to-container volume and path relationships

02Resolution patterns for common Codex CLI errors and permission conflicts

031 GitHub stars

04Automated diagnostic scripts for verifying authentication and image integrity

05Comprehensive log location indexing for host, container, and Codex sessions

06Troubleshooting guides for Apple Container-specific mount and environment quirks

Use Cases

01Resolving Codex CLI exit code 1 failures caused by authentication or root user restrictions

02Debugging session persistence issues where conversation history fails to load between agent runs

03Verifying IPC file flow between the host application and the isolated container worker

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add chrisfrantz/nanoclaw debug

For use in Claude.ai and ChatGPT

Download Skill