V2rayn

Manage V2RayN on macOS to list nodes, test proxy connections, check current node status, view logs, and support auto-failover via scripted health checks.

Security Scan

The instructions and required actions line up with the stated purpose (managing a local V2RayN client on macOS); nothing requested is disproportionate or appears designed to exfiltrate data.

Purpose & Capability

The skill's name and description (manage V2RayN: list nodes, test connections, auto-failover) match the operations in SKILL.md: reading V2RayN config files, testing proxy ports with curl, inspecting logs, and restarting the app. No unrelated credentials, binaries, or external services are requested.

Instruction Scope

The runtime instructions read user V2RayN configuration (~/Library/Application Support/v2rayN/guiConfigs/guiNConfig.json) and log files, perform network requests (curl) through local proxies, and suggest creating a cron job that writes to $HOME/.openclaw/logs/v2rayn_check.log. Reading the V2RayN config is expected for node listing/failover, but that file can contain server details/credentials — this is consistent with the stated purpose, though it means the script will access sensitive connection configuration and store health-check logs locally.

Install Mechanism

Instruction-only skill with no install spec and no code files. Nothing is downloaded or written by an installer; the user (or agent) would create a local script and cron job. This is the lowest-risk install model.

Credentials

No environment variables, credentials, or unrelated config paths are requested. The instructions reference only the V2RayN config/log directories and $HOME for logs, which is proportionate to managing a local client.

Persistence & Privilege

Persistence is optional and user-driven: the guide suggests creating a cron job to run a local check script every 30 minutes. The skill does not request elevated privileges, system-wide changes, or always:true. Users should be aware that scheduling the job creates an ongoing local task that will read configs and write logs.

Assessment

This skill appears coherent for managing a local macOS V2RayN client, but take these precautions before installing/running the suggested script: 1) Inspect the check_v2rayn.sh contents yourself — it reads your V2RayN config file (which may contain server addresses and credentials) and writes a log under $HOME/.openclaw/logs. 2) If you enable the cron job, create the log directory with restrictive permissions (chmod 700) to avoid exposing logs to other local users. 3) Prefer using macOS-native scheduling (launchd) if you want better control and visibility than cron. 4) Do not run the script as root; run it as your user. 5) If you are uncomfortable with automatic reads of your config file, perform the checks manually instead. Overall, the skill is consistent with its stated purpose, but the user is responsible for safely creating the script and the scheduled job.

V2RayN Skill

Manage V2RayN proxy client on macOS with auto-failover.

Overview

V2RayN is a V2Ray client for macOS. This skill helps manage nodes, test connections, auto-check for failures, and update subscriptions.

Quick Status Check

# Check if V2RayN is running
ps aux | grep -i v2rayN | grep -v grep

# Check listening ports
lsof -i :10808 -i :10809 -i :10810 -i :7890 -i :7891 2>/dev/null

# Test connection
curl -s --max-time 5 https://www.google.com -w "\nStatus: %{http_code}\n"

Auto-Check Node Health (Every 30 min)

This skill automatically:

1. Check if current node is working
2. If failed, update subscription
3. Select a new working node

Implementation

Create a cron job:

*/30 * * * * /path/to/check_v2rayn.sh

Check Script

#!/bin/bash
# check_v2rayn.sh - Auto-check and failover for V2RayN

LOG_FILE="$HOME/.openclaw/logs/v2rayn_check.log"
CONFIG_DIR="$HOME/Library/Application Support/v2rayN/guiConfigs"
MAIN_CONFIG="$CONFIG_DIR/guiNConfig.json"

log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a "$LOG_FILE"
}

# Test connection
test_connection() {
    curl -s --max-time 5 -x socks5://127.0.0.1:10808 https://www.google.com -o /dev/null -w "%{http_code}" 2>/dev/null
}

# Get current node info
get_current_node() {
    python3 -c "
import json
with open('$MAIN_CONFIG') as f:
    d = json.load(f)
    idx = d.get('currentServerIndex')
    if idx is not None:
        servers = d.get('vmess',[]) + d.get('vless',[]) + d.get('trojan',[])
        if idx < len(servers):
            print(servers[idx].get('remarks', 'Unknown'))
        else:
            print('Invalid index')
    else:
        print('No server selected')
" 2>/dev/null
}

# Main check
log "=== Starting V2RayN health check ==="

# Test current connection
RESULT=$(test_connection)
log "Connection test result: $RESULT"

if [ "$RESULT" = "200" ]; then
    log "✅ Node is working: $(get_current_node)"
    exit 0
else
    log "❌ Node failed! Trying to recover..."
    
    # Try to update subscription
    log "Updating subscription..."
    # Note: V2RayN CLI is limited, manual or external script needed
    
    log "Please manually:"
    log "1. Open V2RayN"
    log "2. Update subscription"
    log "3. Select a new node"
    
    # Notify user
    echo "⚠️ V2RayN node failed! Please check manually."
    exit 1
fi

Manual Commands

1. Check Node Status

# Test all common proxy ports
for port in 10808 10809 10810 7890 7891; do
    result=$(curl -s --max-time 3 -x socks5://127.0.0.1:$port https://www.google.com -w "%{http_code}" 2>/dev/null)
    echo "Port $port: $result"
done

2. List All Nodes

cat ~/Library/Application\ Support/v2rayN/guiConfigs/guiNConfig.json | python3 -c "
import json,sys
d=json.load(sys.stdin)
servers = d.get('vmess',[]) + d.get('vless',[]) + d.get('trojan',[]) + d.get('shadowsocks',[])
print(f'Total nodes: {len(servers)}')
for i, s in enumerate(servers):
    print(f'{i+1}. {s.get(\"remarks\", s.get(\"name\", \"Unnamed\"))}')
"

3. Get Current Node

python3 -c "
import json
with open('$HOME/Library/Application Support/v2rayN/guiConfigs/guiNConfig.json') as f:
    d = json.load(f)
    idx = d.get('currentServerIndex')
    if idx:
        servers = d.get('vmess',[]) + d.get('vless',[]) + d.get('trojan',[])
        if idx < len(servers):
            s = servers[idx]
            print(f'Current: {s.get(\"remarks\", \"Unknown\")}')
            print(f'Protocol: {s.get(\"protocol\", \"trojan\")}')
"

4. Test Specific Node

# Test current node
curl -s --max-time 5 -x socks5://127.0.0.1:10808 https://www.google.com

# Test direct
curl -s --max-time 5 https://www.google.com

5. View Logs

ls -la ~/Library/Application\ Support/v2rayN/guiLogs/
tail -50 ~/Library/Application\ Support/v2rayN/guiLogs/*.log 2>/dev/null | tail -30

6. Restart V2RayN

# Kill and restart
pkill -f v2rayN
open /Applications/v2rayN.app

7. Force Update Subscription

Note: V2RayN doesn't have a CLI for subscription update. You'll need to:

1. Open V2RayN GUI
2. Click "Update" on your subscription

Configuration Files

File	Description
guiNConfig.json	Main GUI config (nodes, settings)
config.json	V2Ray/Xray runtime config
configPre.json	Sing-box config (if using TUN mode)

Troubleshooting

Node Not Working

1. Check logs: tail -50 ~/Library/Application Support/v2rayN/guiLogs/*.log
2. Test port: lsof -i :10808
3. Try different node in GUI
4. Update subscription

All Nodes Invalid

• Import new subscription
• Or add nodes manually in GUI

TUN Mode Not Working

• Check if TUN interface exists: ifconfig | grep -i tun
• Check configPre.json for TUN settings