An Openclaw Skills integration for programmatically controlling Clash Verge and mihomo kernels via a RESTful API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clash-verge-controller
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 clash-verge-controller 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 Clash Verge Controller?
The Clash Verge Controller is a technical skill designed to bridge the gap between AI agents and network proxy management. By leveraging the mihomo (Clash.Meta) kernel integrated within Clash Verge, this Openclaw Skills module provides a comprehensive interface for external control. It allows developers to automate complex networking tasks that would otherwise require manual GUI interaction.
This skill is essential for users who need to programmatically switch nodes, monitor real-time traffic, or modify routing rules on the fly. By exposing the RESTful API capabilities of the underlying kernel, Openclaw Skills can help build self-healing network configurations or context-aware proxy switching scripts.
Clash Verge Controller Use Cases
- Automatically switching to the lowest-latency proxy node based on real-time ping results.
- Monitoring active connections to identify and terminate bandwidth-heavy processes.
- Updating network configuration parameters like mixed-ports or routing modes via scripts.
- Integrating proxy management into custom developer dashboards or CLI automation tools.
- Restarting the mihomo kernel programmatically after configuration changes.
How Clash Verge Controller Works
- The user enables the external-controller setting within the Clash Verge YAML configuration to open the RESTful API port.
- A security secret is defined to ensure all incoming requests to the Openclaw Skills interface are authenticated.
- The skill sends structured HTTP requests (GET, PUT, POST, PATCH, DELETE) to specific endpoints like /proxies or /configs.
- For real-time data, the skill can establish WebSocket connections to stream logs and traffic statistics.
- The kernel processes these requests and returns JSON-formatted data or executes the requested network state change.
Clash Verge Controller Setup
To enable this skill, you must first configure your Clash Verge instance. Add the following block to your configuration file:
# External Control (API) Configuration
external-controller: 127.0.0.1:9090
# API Secret Key
secret: "your-secret-key-here"
# CORS Configuration
external-controller-cors:
allow-origins:
- '*'
allow-private-network: true
Once configured, verify the connection using the following command in your terminal as part of your Openclaw Skills workflow:
curl -H "Authorization: Bearer your-secret-key-here" http://127.0.0.1:9090/proxies
Clash Verge Controller Data Schema & Taxonomy
The skill organizes and interacts with the following data structures provided by the mihomo API:
| Data Category | Endpoint | Format | Description |
|---|---|---|---|
| Proxies | /proxies |
JSON | Contains node names, types, and latency history |
| Connections | /connections |
JSON | Metadata for all active TCP/UDP sessions |
| Configuration | /configs |
JSON | Current global settings and kernel status |
| Traffic | /traffic |
Stream | Real-time throughput data (up/down) |
| Logs | /logs |
Stream | System-level output for debugging and monitoring |
Clash Verge Controller Advanced Features
- Multi-agent support for managing distributed proxy instances through Openclaw Skills.
- Real-time WebSocket streaming for live traffic visualization and log analysis.
- Dynamic DNS query testing to troubleshoot routing and resolution issues.
- Automated GEO database updates to ensure routing rules remain current.
- Bulk connection management to clear all active states during network transitions.
SKILL.md
Loading
Related Openclaw Skills
Paper Searcher
A professional academic literature search assistant that automates multi-source discovery and disciplined Zotero library management.
Deep Research to PPT Pro
A professional-grade automation pipeline that transforms raw topics into verified, 50-80 page research reports and visual presentations with built-in data validation.
Zeelin Writing Assistant
An advanced AI writing assistant that automates a professional 10-step self-media creation workflow from research to automated publishing.
Bechtel Global EPC Insights
An expert analytical skill for decyphering the business models and execution strategies of the world's largest engineering and construction firm.
Web3 B2B Positioning Expert
An expert system for positioning Web3 and blockchain products to traditional enterprise buyers by translating technical features into business value.
Podcast Production Workflow
A comprehensive framework for planning, producing, distributing, and repurposing podcast content into a high-impact marketing machine.
Featured*
