A comprehensive maintenance tool for the CLI Proxy API designed to handle secure image upgrades, configuration changes, and robust rollback procedures.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install cpa-update
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 cpa-update 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 CPA Update?
CPA Update is a specialized technical workflow within the Openclaw Skills ecosystem designed for the secure maintenance and configuration of the CLI Proxy API (CPA). This skill ensures that your AI gateway remains operational while undergoing critical updates, such as Docker image migrations, provider API key rotations, or model routing adjustments. It bridges the gap between raw CLI commands and production-grade stability by enforcing a safety-first methodology.
By integrating this skill into your Openclaw Skills library, you gain a standardized approach to managing complex AI proxy environments. It specifically addresses common pain points such as authentication directory permission conflicts, configuration loss during container recreation, and the need for zero-downtime testing before moving changes to production.
CPA Update Use Cases
- Upgrading CLI Proxy API to the latest official Docker release without losing session data.
- Updating provider configuration blocks for Gemini, Claude, Codex, or xAI models.
- Migrating authentication directories to fix mounting issues in container environments.
- Performing routine health checks and log monitoring for AI model proxy services.
- Executing rapid rollbacks to a previous stable state using saved image snapshots.
How CPA Update Works
- Environment Discovery: The skill scans for existing CPA containers to identify current image tags, ports, and configuration paths.
- Mandatory Backup: It generates timestamped backups of the active Docker image, the config.yaml file, and the sensitive authentication directory.
- Type Classification: The skill determines whether the maintenance task is a simple configuration reload or a full container replacement (Image Upgrade).
- Staging & Validation: A temporary test container is deployed on a non-production port to verify health checks and model availability.
- Production Deployment: Upon user confirmation, the skill swaps the production container with the validated new version.
- Archival & Cleanup: Successfully applied configurations and old backups are moved to a structured archive to maintain environment hygiene.
CPA Update Setup
To utilize this maintenance workflow within Openclaw Skills, ensure your deployment directory is standardized. Most operations assume the following baseline:
# Check current CPA container status
docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'
# Pull the latest official repository image
docker pull eceasy/cli-proxy-api:latest
# Ensure backup directory exists
mkdir -p /opt/cliproxyapi/backup /opt/cliproxyapi/archive
CPA Update Data Schema & Taxonomy
The skill manages a specific directory structure to ensure data persistence across Openclaw Skills operations:
| Directory/File | Purpose | Retention Policy |
|---|---|---|
/opt/cliproxyapi/config.yaml |
Main gateway configuration | Permanent |
/opt/cliproxyapi/auth/ |
Session and identity data | Permanent |
/opt/cliproxyapi/backup/ |
Current batch temporary files | Cleared after upgrade |
/opt/cliproxyapi/archive/ |
Historical version snapshots | Last 2 versions |
baseline-*.md |
Metadata snapshots of environment state | Permanent |
CPA Update Advanced Features
- Automated rollback scripts that utilize docker load to restore specific image snapshots instantly.
- Intelligent permission mapping for the /root/.cli-proxy-api internal container path.
- Custom Dockerfile generation for users requiring specific timezones or base OS dependencies.
- Multi-point health validation targeting the /v1/models endpoint to ensure upstream API availability.
- Log-streaming analysis to detect auth-related 401/403 errors or container panic loops.
SKILL.md
Loading
Related Openclaw Skills
Daily Report Writer
An automated tool to generate and store professional Markdown work reports based on your daily achievements and blockers.
Daily Report (joig)
A productivity skill for generating structured Chinese daily reports in Markdown format to streamline personal reflection and progress tracking.
A-Share Metrics Card
An AI-driven tool for generating standardized financial health reports and key metrics for Chinese A-share stocks.
A-Share Glossary Tutor
A structured tutor and note-taking assistant for mastering Chinese A-share financial indicators and market terminology.
Context7 MCP Skill
A high-performance bridge for AI agents to query live, version-accurate documentation for virtually any software library.
DeepWiki MCP Skill
A powerful tool to interact with GitHub repository documentation and get AI-grounded answers about codebases.
Featured*
