← Back to Skills Marketplace
Clash Verge Skill
by
brianping7
· GitHub ↗
· v1.0.0
· MIT-0
153
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install clash-verge-skill
Description
Control Clash Verge Rev via mihomo API. Query proxy status, switch nodes, test delays, manage connections, DNS, and more. Use when user mentions Clash, proxy...
README (SKILL.md)
Clash Verge Skill
Control Clash Verge Rev (mihomo core) via its external controller API.
CLI Tool
python3 {baseDir}/scripts/clash-verge.py
Connection
Prefers Unix socket at /tmp/verge/verge-mihomo.sock (default for Clash Verge Rev on macOS).
Falls back to HTTP API at http://127.0.0.1:9097.
API Token is #OpenClaw
Override via env vars: CLASH_SOCK, CLASH_API, CLASH_SECRET
Or CLI flags: --sock, --api, --secret
Commands
# Overall status
clash-verge.py status
# Proxy mode (rule/global/direct)
clash-verge.py mode # Get current mode
clash-verge.py mode rule # Set mode
# Proxy groups & nodes
clash-verge.py groups # List all proxy groups
clash-verge.py nodes \x3Cgroup> # List nodes in a group
clash-verge.py select \x3Cgroup> \x3Cnode> # Switch node
# Delay testing
clash-verge.py delay \x3Cnode> # Test single node
clash-verge.py delay-group \x3Cgroup> # Test all nodes in group
# Connections
clash-verge.py conns [--limit N] # List active connections
clash-verge.py conns-close [--id ID] # Close one or all connections
# Rules
clash-verge.py rules [--limit N]
# DNS
clash-verge.py dns \x3Cdomain> [--type A|AAAA|CNAME]
clash-verge.py flush-dns
# Maintenance
clash-verge.py restart # Restart mihomo core
clash-verge.py upgrade-geo # Update GeoIP/GeoSite databases
Notes
- No external dependencies (Python stdlib only)
- Unix socket is preferred over HTTP (more reliable, no auth needed)
- Group/node names with special characters (emoji, CJK) are supported
delay-grouptests nodes sequentially — may take a while for large groups
Usage Guidance
This skill appears to be what it says: a local controller client for Clash Verge/mihomo. Before installing, verify you actually run mihomo (and on which socket/port) and confirm the Unix socket path or localhost port in your environment. Do not set CLASH_SECRET to any sensitive shared token unless you trust the local controller; the SKILL.md mentions an API token string (#OpenClaw) but the script does not use that as a default—treat that as a documentation inconsistency. Be aware the script can perform disruptive local actions (switch nodes, close connections, restart the service, update GeoIP/GeoSite), so only give it to agents/users you trust. If you want stronger guarantees, review the included script yourself or run it manually once to confirm behavior before allowing autonomous agent invocation.
Capability Analysis
Type: OpenClaw Skill
Name: clash-verge-skill
Version: 1.0.0
The skill provides a CLI tool to manage Clash Verge Rev via its local API (Unix socket or HTTP). The Python script (clash-verge.py) uses only standard libraries to implement a minimal HTTP-over-Unix-socket client and interacts exclusively with the local mihomo core API for proxy management tasks like switching nodes, testing latency, and monitoring traffic. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
The name/description promise (control Clash Verge/mihomo: query status, switch nodes, test delays, manage connections/DNS, restart/upgrade) aligns with the provided Python CLI which calls the local mihomo controller API via a Unix socket or localhost HTTP. Nothing in the code requests unrelated cloud credentials or unrelated system access. Note: SKILL.md and the script disagree on the default HTTP port (SKILL.md mentions 9097 in one place; the script uses 9090) and the README claims a default API token '#OpenClaw' while the script defaults to an empty secret—these are documentation inconsistencies, not functionality mismatches.
Instruction Scope
SKILL.md instructs invoking the bundled Python script; the script only connects to a local Unix socket or localhost HTTP endpoint and issues API requests defined by mihomo. It does not instruct reading arbitrary user files or exporting data to third-party endpoints. Delay tests are done via the controller (which may itself perform outbound requests), and the CLI can issue operations that alter local networking state (e.g., select node, close connections, restart, upgrade DB), which is expected for this tool.
Install Mechanism
There is no install spec; this is an instruction-only skill with a bundled script. No external downloads or package installs are performed by the skill itself, minimizing install-time risk.
Credentials
The registry metadata lists no required env vars or secrets. The script accepts optional env vars (CLASH_SOCK, CLASH_API, CLASH_SECRET) to override connection parameters—reasonable for a local controller client. However, SKILL.md's documentation references a default API token value ('#OpenClaw') that the script does not actually apply; treat that documented token string as a documentation artifact and not an actual credential requirement.
Persistence & Privilege
The skill does not request persistent/forced inclusion (always:false) and does not modify other skills or system-wide agent settings. It operates only when invoked and interacts with the local mihomo controller API; it does include commands that change local state (restart, close connections), which is expected for this utility.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install clash-verge-skill - After installation, invoke the skill by name or use
/clash-verge-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Clash Verge Skill for controlling Clash Verge Rev (mihomo core) via its external API.
- Includes CLI tool to check status, manage proxy modes, switch nodes, test delays, and handle connections and DNS.
- Supports Unix socket and HTTP API connections with environment variable and CLI flag overrides.
- No external dependencies; fully Python stdlib-based.
- Handles proxy group and node names with special characters.
Metadata
Frequently Asked Questions
What is Clash Verge Skill?
Control Clash Verge Rev via mihomo API. Query proxy status, switch nodes, test delays, manage connections, DNS, and more. Use when user mentions Clash, proxy... It is an AI Agent Skill for Claude Code / OpenClaw, with 153 downloads so far.
How do I install Clash Verge Skill?
Run "/install clash-verge-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Clash Verge Skill free?
Yes, Clash Verge Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Clash Verge Skill support?
Clash Verge Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Clash Verge Skill?
It is built and maintained by brianping7 (@brianping7); the current version is v1.0.0.
More Skills