Nginx Reverse Proxy for Openclaw

An automated utility for configuring Nginx reverse proxies, binding domains to specific ports, and securing traffic with SSL.

cloudswave
v1.0.0
Apr 11, 2026
0
617
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install nginx-reverse-proxy

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install nginx-reverse-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 Nginx Reverse Proxy?

The Nginx Reverse Proxy skill is designed to simplify the complex task of web server configuration. This Openclaw Skills tool allows developers and system administrators to quickly map domain names to internal services running on specific IP addresses and ports. By automating the creation of Nginx configuration files, it reduces the risk of manual syntax errors and streamlines the process of making internal applications publicly accessible.

Beyond basic routing, this skill handles the heavy lifting of security by integrating with Let's Encrypt via Certbot. It ensures that your applications are not only accessible but also protected by modern SSL/TLS protocols. Whether you are managing a single cloud server or a complex homelab, this automation provides a standard, reproducible way to manage web traffic.

Nginx Reverse Proxy Use Cases

  • Binding a custom domain name to a local development server or Docker container.
  • Setting up a secure HTTPS entry point for a backend API running on a specific port.
  • Migrating legacy HTTP services to secure HTTPS using automated Certbot integration.
  • Rapidly deploying Nginx configurations for new microservices in a devops environment.

How Nginx Reverse Proxy Works

  1. The agent extracts the desired domain name and the target IP:port from the user's natural language request.
  2. A customized Nginx server block is generated, including optimized proxy headers for headers like Host, X-Real-IP, and X-Forwarded-For.
  3. The skill uses the tee command to write the configuration to a unique file in /etc/nginx/conf.d/ based on the domain name.
  4. A configuration test (nginx -t) is performed to ensure there are no syntax errors before reloading the service.
  5. If SSL is requested, the skill automatically executes the Certbot process to obtain and install certificates.
  6. The Nginx service is reloaded to apply the new configuration live.

Nginx Reverse Proxy Setup

To use this skill, ensure Nginx is installed on your target machine and the agent has the necessary permissions to edit configuration files.

# Install Nginx and Certbot
sudo apt update
sudo apt install nginx certbot python3-certbot-nginx -y

# Ensure Nginx is running
sudo systemctl enable --now nginx

Once the environment is ready, simply trigger the skill by asking the agent to bind a domain to a specific target using Openclaw Skills commands.

Nginx Reverse Proxy Data Schema & Taxonomy

The skill manages configuration files and service states as follows:

Component Path / Detail Purpose
Config File /etc/nginx/conf.d/{domain}.conf Stores the specific reverse proxy rules for the domain.
SSL Certs /etc/letsencrypt/live/ Managed by Certbot for secure HTTPS communication.
Proxy Pass http://{target} The internal destination for incoming traffic.
Protocols TLSv1.2, TLSv1.3 Modern security standards applied to HTTPS configs.

Nginx Reverse Proxy Advanced Features

  • WebSocket Support: Automatically includes Upgrade and Connection headers for real-time application support.
  • Automated SSL Provisioning: Integrated Certbot workflow for one-click Let's Encrypt certificate deployment.
  • Error Prevention: Mandatory syntax checking (nginx -t) before reloading the service to prevent server downtime.
  • Clean Configuration: Uses the conf.d modular approach to keep the main nginx.conf clean and manageable within Openclaw Skills workflows.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*