← Back to Skills Marketplace
tankeito

clash-verge-auto-switch

by tankeito · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
98
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install clash-verge-auto-switch
Description
Use when the user wants Codex to speed test Clash Verge Rev or Mihomo proxies, auto-detect currently used Clash groups from the live controller, switch a sel...
README (SKILL.md)

Clash Verge Auto Switch

This skill gives Codex a reliable workflow for Clash Verge Rev and Mihomo proxy switching on macOS. It is meant for users who want a concrete node selected from a selector group, not just a passive health check.

When To Use It

Use this skill when the user asks to:

  • speed test Clash Verge or Mihomo nodes
  • switch the currently used Clash selector groups to the fastest node
  • diagnose why the Clash controller cannot be reached
  • install or remove a timed automatic switch job on macOS

Quick Start

Run the main script:

/usr/bin/python3 ~/.codex/skills/clash-verge-auto-switch/scripts/switch_fastest.py

By default it auto-discovers the current active selector chain from the live Clash controller. To inspect what it found:

/usr/bin/python3 ~/.codex/skills/clash-verge-auto-switch/scripts/switch_fastest.py --list-groups

Target explicit groups:

/usr/bin/python3 ~/.codex/skills/clash-verge-auto-switch/scripts/switch_fastest.py \
  --group 'Proxy' \
  --group 'ChatGPT'

Dry-run without changing selections:

/usr/bin/python3 ~/.codex/skills/clash-verge-auto-switch/scripts/switch_fastest.py --dry-run

Workflow

  1. Check whether the Mihomo controller is reachable.
  2. If the user did not name target groups, inspect the live /proxies tree and auto-discover groups from the current active selection chain.
  3. Expand url-test, fallback, and load-balance groups into leaf proxies, but do not rewrite nested selector groups unless the user explicitly targets them.
  4. Test candidate proxies with the controller delay API and switch the selector group to the lowest-latency healthy node.
  5. Report the winning node, measured latency, and whether a switch happened.

Group Discovery

  • Default mode is --group-scope current, which follows the currently selected chain from the live Clash proxy tree.
  • Use --group-scope top-level when you want all top-level selector groups discovered from the current controller session.
  • Use --group-scope all when you want every selector group in the current Clash instance.
  • Use explicit --group flags when the user wants exact control.

Scheduling

For a true custom-minute schedule on macOS, use the bundled launchd installer instead of Codex automations because Codex recurring schedules only support hourly intervals.

Install:

~/.codex/skills/clash-verge-auto-switch/scripts/install_launch_agent.sh \
  --interval-minutes 30 \
  --group-scope current

Remove:

~/.codex/skills/clash-verge-auto-switch/scripts/uninstall_launch_agent.sh

Notes

  • Read runtime-notes.md when you need the generic controller discovery and group-detection rules.
  • If the controller is offline, ask the user whether Clash Verge should be opened first or run the script with --launch-if-needed.
Usage Guidance
This skill appears to do what it says: discover a local Clash controller, test proxies, switch selector groups, and optionally install a macOS LaunchAgent to run periodically. Before installing, review the included scripts (switch_fastest.py and install_launch_agent.sh). Key points to consider: - The script will read local Clash config files (~/.config/clash/config.yaml and Clash Verge's config path) and will read CLASH_API_UNIX_SOCKET, CLASH_API_URL, and CLASH_API_SECRET environment variables if present. If a controller secret exists it will be used in an Authorization header to the controller API. - The script uses curl to communicate with the controller and may change selector state (it performs switches). Use --dry-run first to verify behavior. - The install script writes a LaunchAgent plist to ~/Library/LaunchAgents and runs the script at the chosen interval; inspect the generated plist and logs before enabling. Installation requires explicit user action; do not run the installer unless you trust the code and understand the schedule. - If you are unsure, run the Python script manually with --list-groups and --dry-run, and verify it only talks to your intended controller. If you rely on a secret, rotate it if you suspect exposure. If you want to be extra cautious, run the code in a controlled account or inspect it line-by-line before permitting installation.
Capability Analysis
Type: OpenClaw Skill Name: clash-verge-auto-switch Version: 1.0.0 The skill provides automated proxy switching for Clash Verge/Mihomo on macOS, utilizing risky capabilities such as local configuration/secret retrieval and system persistence. Specifically, 'switch_fastest.py' reads application config files to extract API secrets, and 'install_launch_agent.sh' installs a macOS launchd agent to ensure the script runs on a schedule. While these actions are documented and align with the stated purpose of maintaining a high-speed proxy connection, the combination of persistence and credential access warrants a suspicious classification under the provided criteria for high-risk behaviors.
Capability Assessment
✓ Purpose & Capability
Name/description match the implementation: the scripts discover a local Mihomo/Clash controller (via explicit args, CLASH_API_* env vars, or local config files), call the controller API, run latency tests, and switch selector groups. No unrelated cloud credentials or unrelated binaries are requested.
ℹ Instruction Scope
SKILL.md and the scripts instruct the agent to read local Clash config files (~/.config/clash/config.yaml and ~/Library/Application Support/...), consult environment variables (CLASH_API_UNIX_SOCKET, CLASH_API_URL, CLASH_API_SECRET), call the controller via curl (HTTP or unix socket), and optionally launch the Clash app. These actions are within the stated purpose but are broad (they examine local config and may modify controller state by switching selectors).
✓ Install Mechanism
There is no external download; install is a local zsh script that writes a user LaunchAgent plist under ~/Library/LaunchAgents and uses launchctl. This is a standard macOS user-level installation method and the script does not pull code from remote URLs.
⚠ Credentials
The skill does not declare required env vars but will read CLASH_API_UNIX_SOCKET, CLASH_API_URL, and CLASH_API_SECRET if present and will use any 'secret' from local configs as an Authorization header to the controller. While these env/config accesses are necessary for discovering and authenticating to a Clash controller, users should be aware the script will read local config files and environment variables and may send the secret value to the controller API.
ℹ Persistence & Privilege
The provided installer creates a user LaunchAgent that will run the bundled Python script at the chosen interval and write logs to ~/Library/Logs. The skill does not set always:true; installation is explicit via the install script, but installing grants the script periodic execution under the user account.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install clash-verge-auto-switch
  3. After installation, invoke the skill by name or use /clash-verge-auto-switch
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of clash-verge-auto-switch. - Enables speed testing of Clash Verge Rev and Mihomo proxy nodes. - Automatically discovers and switches selector groups to the fastest working proxy on macOS. - Diagnoses controller connectivity issues and offers troubleshooting. - Adds install/uninstall scripts for setting up an automatic switch job using macOS launchd with user-defined intervals.
Metadata
Slug clash-verge-auto-switch
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is clash-verge-auto-switch?

Use when the user wants Codex to speed test Clash Verge Rev or Mihomo proxies, auto-detect currently used Clash groups from the live controller, switch a sel... It is an AI Agent Skill for Claude Code / OpenClaw, with 98 downloads so far.

How do I install clash-verge-auto-switch?

Run "/install clash-verge-auto-switch" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is clash-verge-auto-switch free?

Yes, clash-verge-auto-switch is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does clash-verge-auto-switch support?

clash-verge-auto-switch is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created clash-verge-auto-switch?

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

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments