← Back to Skills Marketplace
acastellana

Vpn Rotate Skill

by acastellana · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
1869
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install vpn-rotate-skill
Description
Bypass API rate limits by rotating VPN servers. Works with any OpenVPN-compatible VPN (ProtonVPN, NordVPN, Mullvad, etc.). Automatically rotates to new server every N requests for fresh IPs. Use for high-volume scraping, government APIs, geo-restricted data.
Usage Guidance
This skill is coherent with its stated purpose (rotating OpenVPN configs) but asks you to make security-sensitive system changes. Before installing or running it, consider the following: - Review the code yourself (you have the files) and confirm there are no remote endpoints or hidden behaviors beyond those documented. The included code is local and readable. - Do NOT blindly add the sudoers entry: granting NOPASSWD for openvpn and especially for kill/killall gives root-level capabilities that could be abused if an attacker can control the OpenVPN configs or the openvpn binary. If you need passwordless operation, prefer a tightly-scoped wrapper script with a fixed PID file or use sudoers argument restrictions, or run the skill in an isolated environment. - Store credentials securely: the skill writes username/password to ~/.vpn/creds.txt. If you must use a creds file, ensure strict permissions (chmod 600) and prefer OS credential stores or ephemeral credentials where possible. - Run in isolation: consider running this code inside a disposable VM, container, or dedicated machine — do not run on multi-user or sensitive hosts. - Consider alternatives: provider-approved APIs, paid proxy/rotating-IP services, or sanctioned rate-limit strategies may be safer and reduce legal/TOS risk. - If you proceed, limit the sudoers entry to the minimum required and audit it (review /etc/sudoers.d/vpn-rotate). Remove the sudoers entry and creds when you no longer need the skill. If you want, I can: (1) show specifically where the sudoers line is added and suggest a safer sudoers line or wrapper script; (2) highlight the exact places credentials are written/read so you can modify them to use a secure store; or (3) suggest how to run the skill inside a container with minimal privileges.
Capability Analysis
Type: OpenClaw Skill Name: vpn-rotate-skill Version: 0.1.0 The skill is classified as suspicious due to the `setup.sh` script modifying `/etc/sudoers.d/` to grant passwordless `sudo` access for `openvpn`, `killall`, and `kill` commands. While intended for VPN process management, the `NOPASSWD` permission for `killall` and `kill` is a broad privilege escalation that allows termination of any process on the system without a password, posing a significant security risk. Additionally, VPN credentials are stored in `~/.vpn/creds.txt` on disk, though with restrictive permissions.
Capability Assessment
Purpose & Capability
The name/description match the implementation: the package manipulates OpenVPN (.ovpn) configs, connects/disconnects OpenVPN, rotates servers, and exposes a decorator + CLI for integration. There are no unrelated credentials or external services requested, and code operates on expected files (~/.vpn/servers, creds file, ProtonVPN fallback paths).
Instruction Scope
SKILL.md and setup.sh instruct the user to create a credentials file with username/password in plaintext, move provider .ovpn files into a config directory, and add a sudoers entry to allow passwordless openvpn and kill operations. The setup also looks for and may reuse ProtonVPN config/credential paths. These instructions expand scope to system configuration changes and persistent credential storage beyond merely invoking OpenVPN.
Install Mechanism
There is no formal install spec (instruction-only), so nothing is pulled from remote sources; code files are bundled with the skill. The included setup.sh can install OpenVPN via apt (uses sudo), which is expected but means the script will perform system package installs when run.
Credentials
The skill does not request environment variables or external secrets, which matches its purpose. However, it writes VPN credentials to a local plaintext file (~/.vpn/creds.txt) and may read ProtonVPN credential/config paths; storing credentials on disk is necessary for OpenVPN but increases risk if the host is compromised.
Persistence & Privilege
The setup wizard adds a /etc/sudoers.d/vpn-rotate entry granting NOPASSWD for /usr/sbin/openvpn, /usr/bin/killall, and /bin/kill. Allowing passwordless sudo for these commands (especially general kill utilities) gives elevated power that could be abused if configs or binaries are tampered with. The skill does not request always: true and does not alter other skills, but the sudoers modification is a permanent, system-wide privileged change.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install vpn-rotate-skill
  3. After installation, invoke the skill by name or use /vpn-rotate-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of vpn-rotate-skill. - Rotate VPN servers automatically to bypass API rate limits, compatible with any OpenVPN-based provider. - Supports VPN rotation via decorator, class, context manager, or CLI interface. - Includes setup wizard and manual installation instructions. - Configuration options for rotation frequency, delay, credentials, and country filtering. - Example usage provided for both code and terminal. - Troubleshooting section and provider-specific setup guides included.
Metadata
Slug vpn-rotate-skill
Version 0.1.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Vpn Rotate Skill?

Bypass API rate limits by rotating VPN servers. Works with any OpenVPN-compatible VPN (ProtonVPN, NordVPN, Mullvad, etc.). Automatically rotates to new server every N requests for fresh IPs. Use for high-volume scraping, government APIs, geo-restricted data. It is an AI Agent Skill for Claude Code / OpenClaw, with 1869 downloads so far.

How do I install Vpn Rotate Skill?

Run "/install vpn-rotate-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Vpn Rotate Skill free?

Yes, Vpn Rotate Skill is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Vpn Rotate Skill support?

Vpn Rotate Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Vpn Rotate Skill?

It is built and maintained by acastellana (@acastellana); the current version is v0.1.0.

💬 Comments