← Back to Skills Marketplace
qiangwang375-wq

V2rayn

by qiangwang375-wq · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
502
Downloads
2
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install v2rayn
Description
Manage V2RayN on macOS to list nodes, test proxy connections, check current node status, view logs, and support auto-failover via scripted health checks.
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill Name: v2rayn Version: 1.0.0 The skill is designed to manage the V2RayN proxy client on macOS, including status checks, node listing, connection testing, and application restart. All code snippets access local V2RayN configuration files, test connectivity to `google.com` (either direct or via proxy), and manage the V2RayN application process. While it instructs the agent to set up a cron job for periodic health checks, the associated script (`check_v2rayn.sh`) is benign, only performing local checks and logging. There is no evidence of data exfiltration, malicious execution, obfuscation, or prompt injection attempts to subvert the agent's purpose.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install v2rayn
  3. After installation, invoke the skill by name or use /v2rayn
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
V2RayN Skill 1.0.0 — Initial Release - Manage V2RayN proxy client on macOS with auto-failover and node health checks. - Provides scripts and cron job setup for automated node testing and troubleshooting. - Includes manual commands for checking status, listing nodes, viewing logs, and restarting V2RayN. - Documents config file locations and troubleshooting steps for common issues.
Metadata
Slug v2rayn
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 502 downloads so far.

How do I install V2rayn?

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

Is V2rayn free?

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

Which platforms does V2rayn support?

V2rayn is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created V2rayn?

It is built and maintained by qiangwang375-wq (@qiangwang375-wq); the current version is v1.0.0.

💬 Comments