A comprehensive toolkit for diagnosing and fixing issues within Docker containers and multi-container Compose environments.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install container-debug
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install container-debug using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Container Debug?
The Container Debug skill is an essential utility for developers and DevOps engineers who need to maintain healthy containerized environments. It provides a structured approach to inspecting running containers, analyzing logs, and diagnosing complex networking or resource allocation issues within Docker and Docker Compose.
By leveraging this skill within Openclaw Skills, users can bridge the gap between application code and infrastructure. Whether you are dealing with a container that crashes immediately on start or a microservice that cannot reach its database, this skill offers the specific commands and methodologies required to identify the root cause quickly and restore service functionality.
Container Debug Use Cases
- Containers crashing immediately upon startup or exiting with non-zero codes.
- Investigating network connectivity issues between microservices in a Compose network.
- Analyzing high CPU or memory consumption to identify potential resource leaks.
- Debugging complex multi-stage Docker builds and verifying image layer contents.
- Monitoring and fixing failing health checks in production-like environments.
How Container Debug Works
- Access real-time and historical container logs to identify application-level errors and stderr outputs.
- Execute interactive shells within running containers to inspect the internal filesystem, environment variables, and active processes.
- Audit network configurations and test service-to-service communication via internal DNS and port reachability checks.
- Monitor resource utilization using live stats and cgroup inspection for performance tuning and OOM detection.
- Validate Dockerfile logic by building specific stages and inspecting image history for size and layer optimization.
Container Debug Setup
Ensure that the Docker engine is installed and running on your host machine. This skill is compatible with Linux, macOS (Darwin), and Windows (win32) environments.
# Verify Docker installation
docker --version
# Verify Docker Compose installation
docker compose version
Container Debug Data Schema & Taxonomy
The skill interacts with Docker metadata and the host filesystem to organize troubleshooting data as follows:
| Data Category | Key Metrics/Files | Description |
|---|---|---|
| Logs | stdout, stderr, LogPath |
Captured output streams and local log driver paths. |
| Container State | ExitCode, OOMKilled, Error |
Lifecycle metadata used to diagnose crash reasons. |
| Networking | IPAddress, Gateway, ExposedPorts |
Network topology details for the container's assigned networks. |
| Resource Stats | CPUPerc, MemUsage, NetIO |
Live performance data retrieved from the Docker engine. |
| Image Layers | History, SizeRw |
Metadata concerning image construction and filesystem changes. |
Container Debug Advanced Features
- Support for distroless and scratch image debugging using
nsenteror sidecar container attachment. - Deep inspection of container namespaces to capture network traffic with
tcpdumpandnetshoot. - Automated Docker Compose service dependency management using
service_healthyconditions for reliable startups. - Targeted multi-stage build debugging allowing developers to run shells inside intermediate build artifacts.
- Comprehensive system cleanup utilities to prune dangling images, volumes, and build caches for Openclaw Skills users.
SKILL.md
Loading
Related Openclaw Skills
CI/CD Pipeline (GitHub Actions)
Automate your development lifecycle with comprehensive GitHub Actions workflows for testing, building, and deploying code.
API Development
A comprehensive toolkit for scaffolding, testing, documenting, and debugging REST and GraphQL APIs using Openclaw Skills.
LastPass CLI Skill
A secure integration that allows AI agents to fetch credentials and secrets directly from a local LastPass vault using the lpass command-line interface.
Singapore Location Helper
An intelligent relocation and housing advisor for Singapore providing building-level recommendations, commute analysis, and site-visit checklists.
Cron & Scheduling
A comprehensive automation skill for managing recurring tasks, systemd timers, and one-off scheduling across Linux and macOS environments.
CSV Data Pipeline
A high-efficiency toolkit for processing, transforming, and analyzing CSV, TSV, and JSON data using standard Python and CLI utilities.
Featured*
