← 返回 Skills 市场
cwyhkyochen-a11y

Sparkle VPN

作者 cwyhkyochen-a11y · GitHub ↗ · v1.1.0
cross-platform ⚠ suspicious
761
总下载
0
收藏
1
当前安装
2
版本数
在 OpenClaw 中安装
/install sparkle-vpn
功能描述
Control Sparkle VPN - start, stop, manage system proxy, query status and switch nodes using Mihomo core directly.
安全使用建议
This skill appears to do exactly what it says: control a local Sparkle/Mihomo VPN. Before installing, verify: 1) you have the Mihomo/Sparkle binaries and the referenced profile (~/.config/sparkle/profiles/19c48c94cbb.yaml) or adjust scripts accordingly; 2) you are comfortable with scripts that start/kill processes and change GNOME proxy settings and write ~/.config/sparkle/proxy.env; 3) required tools (curl, python3, gsettings, pgrep/pkill) are present — the skill does not declare these dependencies; 4) the diagnostic call to https://ipinfo.io/ip will reveal your public IP to that service (harmless for most users, but note if you want no external calls). If unsure, inspect/modify the scripts (they are plain shell) or run them in an isolated/test environment first.
功能分析
Type: OpenClaw Skill Name: sparkle-vpn Version: 1.1.0 The skill is classified as suspicious due to multiple critical shell injection vulnerabilities. The `sparkle_vpn_switch` tool in `index.ts` and `tools.yaml` directly interpolates the `node` parameter into a shell command without proper escaping, allowing for arbitrary command execution (RCE) if an attacker can control the `node` input (e.g., via prompt injection to the agent). Furthermore, the `scripts/switch-node.sh` script, which receives this parameter, attempts to URL-encode it using `python3 -c "..."`, but this `python3 -c` command itself is vulnerable to shell injection if the `NODE_NAME` contains unescaped single quotes. Additionally, `switch-node.sh` inserts the `NODE_NAME` into a JSON payload for `curl -d` without JSON escaping, posing a JSON injection risk. While there's no clear evidence of intentional malicious behavior like data exfiltration to external servers, these vulnerabilities represent significant security flaws that could be exploited.
能力评估
Purpose & Capability
The name/description (control Sparkle VPN via Mihomo core) align with the included scripts and index.ts handlers. Scripts operate on ~/.config/sparkle, call the local Mihomo binary (/opt/sparkle/resources/sidecar/mihomo) and the local API at 127.0.0.1:9090 — all consistent with the declared purpose.
Instruction Scope
Runtime instructions and scripts stay within the VPN management domain: starting/stopping mihomo, switching nodes via the local API, and enabling/disabling system proxy via gsettings and a proxy.env file. The scripts also call ipinfo.io to display public IP (an external endpoint used only for diagnostics). They do not read or transmit unrelated files or secrets.
Install Mechanism
There is no external installer or remote download; files are included in the skill bundle and index.ts runs local shell scripts. No URLs or archive extraction are used, lowering install risk.
Credentials
The skill declares no required env vars or credentials (appropriate). However scripts assume availability of tools (curl, python3, gsettings, pgrep/pkill) and a local Mihomo binary at /opt/sparkle/... and a profile at ~/.config/sparkle/profiles/19c48c94cbb.yaml; these are reasonable for the task but are not declared. The only external network call is to ipinfo.io for IP checks (diagnostic only).
Persistence & Privilege
always:false (normal). The skill can start/stop processes and change system proxy settings (gsettings and writing ~/.config/sparkle/proxy.env) and will therefore affect system state and network behavior — this is expected for a VPN control tool but is a privileged action the user should consent to.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install sparkle-vpn
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /sparkle-vpn 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.1.0
Add system proxy management (enable/disable), query status, switch node
v1.0.0
Initial release - Control Sparkle VPN using Mihomo core
元数据
Slug sparkle-vpn
版本 1.1.0
许可证
累计安装 1
当前安装数 1
历史版本数 2
常见问题

Sparkle VPN 是什么?

Control Sparkle VPN - start, stop, manage system proxy, query status and switch nodes using Mihomo core directly. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 761 次。

如何安装 Sparkle VPN?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install sparkle-vpn」即可一键安装,无需额外配置。

Sparkle VPN 是免费的吗?

是的,Sparkle VPN 完全免费(开源免费),可自由下载、安装和使用。

Sparkle VPN 支持哪些平台?

Sparkle VPN 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Sparkle VPN?

由 cwyhkyochen-a11y(@cwyhkyochen-a11y)开发并维护,当前版本 v1.1.0。

💬 留言讨论