← 返回 Skills 市场

Clash Verge Skill

Name: Clash Verge Skill
Author: brianping7

作者 brianping7 · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

153

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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...

使用说明 (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-group tests nodes sequentially — may take a while for large groups

安全使用建议

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.

功能分析

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.

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install clash-verge-skill
安装完成后，直接呼叫该 Skill 的名称或使用 /clash-verge-skill 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug clash-verge-skill

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题