An automated management tool for monitoring V2RayN proxy health, performing connection tests, and managing node failovers on macOS.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install v2rayn
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install v2rayn 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 V2RayN Proxy Manager for macOS?
The V2RayN skill is a specialized automation layer designed to manage the V2RayN proxy client on macOS. It provides a suite of tools for monitoring network stability, verifying node connectivity, and ensuring that your proxy environment remains operational without constant manual oversight. By integrating this skill into your workflow, you can leverage Openclaw Skills to maintain high availability for your proxy connections through intelligent monitoring and rapid troubleshooting scripts.
This skill bridges the gap between the V2RayN graphical interface and the command line, allowing for sophisticated health checks and status reporting. It is particularly useful for developers and power users who require consistent proxy performance and need immediate notification or automated recovery when a node fails.
V2RayN Proxy Manager for macOS Use Cases
- Automatically monitoring proxy node health every 30 minutes via cron jobs.
- Testing connectivity across multiple proxy ports (10808, 7890, etc.) simultaneously.
- Extracting and listing all configured nodes directly from the JSON configuration files.
- Troubleshooting TUN mode and interface issues on macOS.
- Programmatically restarting the V2RayN application when it becomes unresponsive.
How V2RayN Proxy Manager for macOS Works
- The skill periodically checks if the V2RayN process is running and monitors active listening ports.
- It executes a connection test using curl through the SOCKS5 proxy to verify internet accessibility.
- It parses the local guiNConfig.json file to identify the currently active server and its protocol (VMess, VLESS, Trojan, or Shadowsocks).
- If a connection failure is detected, the skill logs the event and triggers a notification for the user to update subscriptions.
- Manual commands can be issued to list nodes, view logs, or restart the client to restore connectivity.
V2RayN Proxy Manager for macOS Setup
To deploy this skill, ensure V2RayN is installed in your Applications folder. You can then set up the automated health check by creating a shell script and adding it to your system crontab.
# Add the health check script to your crontab for 30-minute intervals
*/30 * * * * /path/to/check_v2rayn.sh
Ensure that the skill has permissions to read from ~/Library/Application Support/v2rayN/guiConfigs/ to access your node configurations.
V2RayN Proxy Manager for macOS Data Schema & Taxonomy
The skill manages and interprets data across several key configuration files and logs:
| File | Description |
|---|---|
guiNConfig.json |
The primary GUI configuration containing node lists and the currentServerIndex. |
config.json |
The active runtime configuration for the V2Ray/Xray core. |
configPre.json |
Configuration specific to Sing-box or TUN mode settings. |
v2rayn_check.log |
A specialized log file used by the Openclaw Skills framework to track health check history. |
guiLogs/*.log |
Standard application logs used for deep troubleshooting and error analysis. |
V2RayN Proxy Manager for macOS Advanced Features
- Multi-protocol support including VMess, VLESS, Trojan, and Shadowsocks.
- Automated failover logic that triggers user notifications upon node expiration or failure.
- Python-integrated JSON parsing for fast extraction of server remarks and protocol details.
- Port-scanning capabilities to verify proxy availability across different local listener ports.
- Process-level management for force-restarting the GUI client and core services.
SKILL.md
Loading
Related Openclaw Skills
Activity Analyzer
An AI-powered productivity coach that analyzes local ActivityWatch data to provide actionable time-management insights.
Ragtop Planner
A sophisticated orchestration skill that automates the generation of influencer marketing plans by retrieving rules, cases, and pricing from RAGTOP knowledge bases.
RAGTOP Agent
An advanced RAG assistant designed to automate knowledge base management and perform deep, agentic research via the RAGTOP backend.
AIAPI-Doc
A comprehensive unified API gateway providing access to over 300 AI models for chat, image, video, and audio generation.
Marriott Hotel Search & Booking
A comprehensive automation tool for searching availability and booking rooms on the Marriott Bonvoy portal via an AI agent.
DeepSeek OCR
DeepSeek OCR is a specialized skill for converting images, screenshots, and documents into high-quality text or markdown using advanced AI models.
Featured*
