clash-verge

What This Skill Does

The Clash Verge skill provides a powerful interface for interacting with the Clash Verge Rev application and the underlying mihomo core. Acting as a bridge between the OpenClaw agent and the network proxy stack, this skill enables programmatic control over traffic routing, node selection, and diagnostic troubleshooting. It allows users to manage their network proxy environment without opening the desktop GUI, making it perfect for rapid environment switching and troubleshooting connectivity issues. It supports advanced features such as individual node latency testing, group management, connection monitoring, and manual DNS flushing.

Installation

To integrate this skill into your environment, run the following command within your terminal: clawhub install openclaw/skills/skills/brianping7/clash-verge-skill Ensure that Clash Verge Rev is installed and active on your system. The skill attempts to locate the Unix socket at /tmp/verge/verge-mihomo.sock by default. If your configuration differs, you can override these parameters using the CLASH_SOCK, CLASH_API, or CLASH_SECRET environment variables.

Use Cases

• Developer Workflow Automation: Automatically switch to a low-latency proxy node or a specific region when testing cross-border web services.
• Network Troubleshooting: Quickly check if an application's failed request is due to a DNS issue or a specific proxy node's downtime by using the delay test and DNS lookup commands.
• Security and Compliance: Switch your proxy mode from 'Rule' to 'Global' or 'Direct' on the fly during security auditing or testing.
• Connection Management: Identify and terminate stalled or malicious active connections to clear bandwidth bottlenecks.

Example Prompts

1. "Check the current proxy status and tell me which node in the 'US-Servers' group has the lowest latency."
2. "My internet seems slow, please list the top 10 active connections and flush the local DNS cache."
3. "Switch my Clash Verge mode to 'Rule' and then restart the mihomo core to apply changes."

Tips & Limitations

• Reliability: The skill defaults to the Unix socket for communication. This is significantly more reliable and efficient than the HTTP API and bypasses the need for manual authentication token management.
• Latency Testing: Be aware that running delay-group performs sequential tests across all nodes. If a group contains dozens of nodes, the process will take several seconds to complete; keep this in mind when chaining commands.
• Character Support: The skill is robust and handles CJK characters and emojis in group or node names, ensuring parity with your existing GUI configuration.