ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified system Safety 3/5

npm-proxy

Manage Nginx Proxy Manager (NPM) hosts, certificates, and access lists. Use when the user wants to add a new domain, point a domain to a server/port, enable SSL, or check the status of proxy hosts.

Why use this skill?

Automate Nginx Proxy Manager with the OpenClaw npm-proxy skill. Easily manage domains, SSL certificates, and proxy host configurations via AI commands.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/weird-aftertaste/npm-proxy
Or

What This Skill Does

The npm-proxy skill is a robust interface for managing Nginx Proxy Manager (NPM) instances directly through the OpenClaw AI agent. It allows users to automate the management of web traffic by programmatically interacting with the NPM REST API. Whether you are hosting services on a home lab, a cloud VPS, or an enterprise server, this skill streamlines the process of configuring proxy hosts, managing SSL/TLS certificates, and adjusting security settings like access lists and exploit blocking. By abstracting away the manual interface of NPM, it enables seamless infrastructure-as-code workflows within your AI agent environment.

Installation

To integrate this skill into your environment, use the OpenClaw CLI tool. Run the command: clawhub install openclaw/skills/skills/weird-aftertaste/npm-proxy. After installation, you must configure your environment variables to grant the agent access to your instance. Specifically, define NPM_URL (the address of your NPM server), NPM_EMAIL, and NPM_PASSWORD. Ensure that the account credentials provided have sufficient administrative privileges to modify proxy configurations.

Use Cases

This skill is ideal for sysadmins and developers who frequently spin up new web services or microservices. It is highly effective for automating the deployment of new subdomains, enabling HTTPS on local services, or quickly toggling public access to specific ports. It reduces the overhead of logging into a web dashboard for repetitive configuration tasks.

Example Prompts

  1. "Check the status of my current proxy hosts and list all available SSL certificates to see if my domain is covered."
  2. "Disable the proxy host with ID 15 immediately because the internal service is down for maintenance."
  3. "Create a new proxy entry for staging.example.com pointing to 192.168.1.50 on port 3000 and enable websocket support."

Tips & Limitations

While the CLI provides convenient status and listing commands, complex operations like creating brand-new hosts currently require raw JSON payloads as per the documentation. Always verify your forward_host and forward_port settings before committing a change to avoid accidental downtime. Note that this skill directly interacts with your network routing; misconfiguration could inadvertently expose internal services or break existing external connections. Always test changes on non-critical subdomains first to ensure the API call matches your expected routing logic.

Metadata

Stars919
Views1
Updated2026-02-12
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-weird-aftertaste-npm-proxy": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#nginx#proxy#networking#devops#automation
Safety Score: 3/5

Flags: network-access, external-api