LaunchKit · 2026
Back to Skills

Manage V2RayN proxy client on macOS with auto-failover.

2
298 downloads
by @qiangwang375-wq

Setup & Installation

openclaw skills install @qiangwang375-wq/v2rayn

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install v2rayn

What This Skill Does

Manages a V2RayN proxy client on macOS by monitoring node health, testing connections, and reading configuration files. Includes a cron-based script that checks every 30 minutes whether the current node is reachable and logs the result. Subscription updates and node switching still require manual action in the V2RayN GUI.

Scheduled health checks catch failing nodes automatically instead of requiring manual spot-checks every time a connection seems slow.

When to use it

  • Checking which proxy ports V2RayN is listening on
  • Testing if the active node can reach the internet
  • Listing all configured nodes from the local config file
  • Running automated 30-minute health checks via cron
  • Diagnosing connection failures using V2RayN log files

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: Is my current V2RayN node working?

AGENT
  1. 1Check if the V2RayN process is running with ps aux
  2. 2Verify port 10808 is listening using lsof
  3. 3Send a test request through socks5://127.0.0.1:10808 to google.com
  4. 4Read guiNConfig.json to identify the current node name
  5. 5Report the node name and whether the connection returned HTTP 200
OUTPUT

Current node is 'HK-Node-3' and is working (HTTP 200)

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

V2RayN macOS application installed