A streamlined API interface for managing Nginx Proxy Manager hosts, certificates, and access lists programmatically.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install npm-proxy
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 npm-proxy 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 NPM Proxy?
The NPM Proxy skill is designed to provide a robust bridge between your automation environment and the Nginx Proxy Manager (NPM) REST API. By leveraging this skill within the Openclaw Skills ecosystem, developers can programmatically handle the complexities of reverse proxy management, including host creation, certificate renewal, and traffic routing. This tool is particularly valuable for those maintaining self-hosted infrastructure who require a reliable way to automate domain pointing and security configurations without manual intervention.
Built with technical efficiency in mind, the skill allows for rapid deployment of proxy hosts and seamless integration with Let's Encrypt for automated SSL management. Whether you are scaling a home lab or managing multiple web services, this component of Openclaw Skills ensures your proxy configurations remain consistent and easily accessible via CLI or scriptable workflows.
NPM Proxy Use Cases
- Automating the creation of subdomains for new containerized services.
- Managing Let's Encrypt SSL certificates for custom domains.
- Quickly enabling or disabling proxy hosts during maintenance windows.
- Integrating proxy management into broader deployment pipelines using Openclaw Skills.
- Auditing existing proxy hosts and certificate expiration dates via CLI.
How NPM Proxy Works
- Authenticates with your Nginx Proxy Manager instance using the provided admin email and password environment variables.
- Establishes a connection to the NPM REST API to fetch or modify proxy host data.
- Executes specific commands through the Python-based client to list, enable, or delete proxy hosts.
- For new host creation, it constructs a detailed JSON payload defining the forward scheme, host, and port.
- Updates the NPM database in real-time to apply SSL settings or advanced configuration tweaks as part of the Openclaw Skills workflow.
NPM Proxy Setup
To get started with this skill in your Openclaw Skills setup, configure the following environment variables in your shell or configuration file:
export NPM_URL="https://npm.your-domain.com"
export NPM_EMAIL="[email protected]"
export NPM_PASSWORD="your-secure-password"
Once configured, you can interact with the client script:
# List all active hosts
python scripts/npm_client.py hosts
NPM Proxy Data Schema & Taxonomy
The skill interacts with the NPM API schema to organize proxy and security data efficiently. Below is the primary structure used for host management:
| Property | Type | Description |
|---|---|---|
| domain_names | Array | List of domains assigned to the proxy host |
| forward_host | String | The internal IP or hostname of the target service |
| forward_port | Integer | The destination port for the traffic |
| ssl_forced | Boolean | Whether to redirect all HTTP traffic to HTTPS |
| certificate_id | Integer | The ID of the SSL certificate to be applied |
NPM Proxy Advanced Features
- Support for WebSocket upgrades to allow real-time application traffic.
- Integrated exploit blocking and security headers via advanced proxy configuration.
- Automated HTTP/2 and HSTS support for enhanced web performance and security.
- Seamless integration with existing Let's Encrypt workflows within Openclaw Skills.
- Custom location support for complex URL routing and path-based proxying.
SKILL.md
Loading
Related Openclaw Skills
Literature Review
An AI-powered academic research assistant that searches multiple scientific databases to find, deduplicate, and synthesize scholarly literature.
Komodo Infrastructure Management
A comprehensive infrastructure management skill for controlling Komodo servers, Docker containers, stacks, and automated build procedures.
LinkedIn Account Warmup Agent
An automated LinkedIn warming agent designed to mimic human behavior and safely grow new accounts through daily lightweight interactions.
LinkedIn Human Warmup
Automate human-like LinkedIn interactions to safely warm up new or cold accounts using AdsPower and CDP.
Proxmox VE Management
A comprehensive interface to manage Proxmox VE clusters, virtual machines, and containers using the REST API.
b3ehive
b3ehive is a multi-agent framework that pits three AI agents against each other to implement, evaluate, and select the highest-quality code solution through objective competition.
Featured*
