A comprehensive automation skill for managing CapRover PaaS instances, enabling full application lifecycle management via a REST API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install caprover-management
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 caprover-management 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 CapRover Management Skill?
The CapRover Management Skill provides a robust interface for interacting with CapRover, a self-hosted Platform as a Service (PaaS) built on top of Docker Swarm. By integrating with Openclaw Skills, this tool allows developers to programmatically create apps, manage persistent volumes, and handle complex container orchestration tasks without manually accessing the CapRover dashboard.
This skill is designed for technical users who need to automate their deployment pipelines, especially when dealing with non-standard configurations like game servers, database clusters, or multi-architecture hardware. It bridges the gap between raw Docker Swarm commands and a user-friendly management API, offering precise control over the deployment lifecycle.
CapRover Management Skill Use Cases
- Automated CI/CD pipelines that trigger app updates or redeployments on every code push.
- Scaling microservices dynamically by adjusting instance counts and environment variables.
- Deploying specialized services requiring specific TCP port mappings for non-HTTP traffic.
- Managing persistent data storage for stateful applications like databases or CMS platforms.
- Building and deploying container images natively on ARM64 hosts to ensure hardware compatibility.
How CapRover Management Skill Works
- The skill authenticates with the CapRover server using the admin password to obtain a secure x-captain-auth token.
- Users register new application definitions, specifying whether the app requires persistent data storage.
- Deployments are triggered either by referencing an external Docker image or by uploading a tarball containing a Dockerfile for local building.
- Configuration updates for environment variables, port mappings, and volume mounts are applied through the API.
- Advanced Docker Swarm settings are injected via serviceUpdateOverride for low-level container management.
- Real-time build and runtime logs are fetched to monitor the health and progress of the application.
CapRover Management Skill Setup
To get started with the CapRover integration in Openclaw Skills, you must first authenticate with your instance. Use the following Python snippet to establish a connection and retrieve your token:
import urllib.request, json, ssl
# Configure SSL context for self-signed certificates
ctx = ssl.create_default_context()
ctx.check_hostname = False
ctx.verify_mode = ssl.CERT_NONE
BASE = "https://captain.your-domain.com"
def api(path, data=None, token=None):
body = json.dumps(data).encode() if data else None
headers = {"Content-Type": "application/json"}
if token:
headers["x-captain-auth"] = token
req = urllib.request.Request(f"{BASE}{path}", data=body, headers=headers)
resp = urllib.request.urlopen(req, context=ctx)
return json.loads(resp.read())
# Login to get the token
login_resp = api("/api/v2/login", {"password": "your_password"})
token = login_resp["data"]["token"]
CapRover Management Skill Data Schema & Taxonomy
The skill organizes data around the CapRover API specification, utilizing the following primary structures:
| Component | Key Fields | Purpose |
|---|---|---|
| App Definition | appName, imageName, envVars, ports |
Defines the core container configuration. |
| Deployment Payload | sourceFile (.tar.gz), gitHash |
Contains the source code or build instructions. |
| Swarm Override | TaskTemplate, ContainerSpec, Mounts |
Provides low-level Docker Swarm adjustments. |
| Logs | lines, raw_logs |
Provides diagnostic output from build and runtime processes. |
CapRover Management Skill Advanced Features
- Support for custom Dockerfile builds natively on the host to resolve ARM64 vs amd64 architecture conflicts.
- Granular control over Docker Swarm via
serviceUpdateOverridefor advanced networking and volume mounting. - Automated handling of persistent data flags to ensure storage is correctly provisioned during app creation.
- Capability to read both build-time logs and runtime stdout/stderr logs for comprehensive debugging.
- System-wide node and cluster information retrieval to monitor host health and resource distribution.
SKILL.md
Loading
Related Openclaw Skills
CapRover Deploy
An AI agent skill to automate application deployments to CapRover via GitHub Actions, webhooks, or direct CLI triggers.
MoltWorld Dashboard Deploy
A comprehensive deployment and hardening skill for running the MoltWorld Dashboard reliably in production or local environments.
Tianlong Analyst
A high-precision requirement deconstruction engine that utilizes critical thinking models to transform vague ideas into structured, actionable project roadmaps.
tianlong-analyst
An AI-powered requirement analysis expert leveraging the Tianlong Engine V7.4 to provide deep deconstruction and critical evaluation of complex project needs.
OSINT Social Analyzer
A comprehensive username investigation tool for tracing digital footprints across 1000+ global and Chinese social media platforms.
Browsh
A modern text-based browser that renders full web pages, including JavaScript and video, directly within your terminal environment.
Featured*
