Manage Docker infrastructure and git-based stacks through the Portainer REST API using simple CLI commands or AI agent interactions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install portainer
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 portainer 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 Portainer?
The Portainer skill provides a robust interface for managing Docker containers and stacks directly through Portainer's REST API. By integrating this capability into Openclaw Skills, developers can automate infrastructure tasks that usually require manual navigation of a web UI. It enables seamless control over container lifecycles, environment monitoring, and deployment workflows.
This skill is designed for developers and sysadmins who want to bring infrastructure management into their AI-driven development environment. Whether you are running a local development setup or managing remote production clusters, this tool bridges the gap between your code and your running services by providing direct API access to your Portainer instance.
Portainer Use Cases
- Automated redeploying of Docker Compose stacks after merging a PR by pulling the latest code from git.
- Real-time debugging of containerized applications by fetching logs via AI agent commands.
- Remote starting, stopping, or restarting of specific services across different Docker environments.
- Quick auditing of system health and container status across multiple Portainer endpoints using Openclaw Skills.
How Portainer Works
- The skill establishes a secure connection to the Portainer REST API using a provided URL and API access token.
- It identifies available Docker environments (endpoints) and maps them to human-readable names and IDs.
- Upon receiving a command (like redeploy or restart), the skill sends a structured HTTP request to the Portainer server.
- For stack redeployments, it triggers Portainer to pull the latest git commit and update the associated containers automatically.
- The skill parses the JSON response from the API and returns formatted status updates or logs to the user interface.
Portainer Setup
To utilize this skill within the Openclaw Skills ecosystem, follow these configuration steps:
- Generate API Token: In your Portainer Web UI, go to My Account -> Access tokens and create a new token.
- Environment Configuration: Add your credentials to your configuration file (e.g.,
~/.clawdbot/.env):
PORTAINER_URL=https://your-portainer-server:9443
PORTAINER_API_KEY=ptr_your_token_here
- System Dependencies: Ensure
curlandjqare installed on your host system to enable API communication and data processing.
Portainer Data Schema & Taxonomy
The Portainer skill organizes data based on the Portainer API schema to ensure compatibility across environments:
| Component | Key Metadata Fields |
|---|---|
| Endpoints | ID, Name, Status (online/offline), Environment Type |
| Containers | Name, State (running/exited), Health Status, Uptime |
| Stacks | ID, Name, Git Repository URL, Status (active/inactive), Last Update |
| Logs | Container standard output and error streams (tailing support) |
Portainer Advanced Features
- Automatic git credential management for secure redeployments of private repository stacks.
- Multi-endpoint support allowing the management of local and remote Docker environments simultaneously.
- Flexible log retrieval with adjustable line counts for tailored debugging sessions.
- Deep integration with Openclaw Skills allowing for natural language triggers like "Redeploy the website" or "Show me running containers."
SKILL.md
Loading
Related Openclaw Skills
PM2 Process Manager
A production-grade process manager for Node.js applications with built-in load balancing and auto-restart capabilities.
Home Music
Automate whole-house audio scenes by synchronizing Spotify playback with Airfoil speaker routing on macOS.
ClawFlight
ClawFlight is an AI-first flight search tool that filters and ranks air travel specifically by Starlink satellite WiFi availability and quality.
CC Changelog Monitor
A lightweight bash-driven utility for Openclaw Skills that tracks @anthropic-ai/claude-code updates and delivers automated Telegram notifications.
Quality Convergence Engine
A multi-dimensional engine that deconstructs requirements into objective acceptance and failure criteria to eliminate implementation defects.
DeepBook CLI Skill
A powerful command-line interface for end-to-end DeepBook operations including market data, account management, and on-chain execution.
Featured*
