ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

sparkle-vpn

Control Sparkle VPN - start, stop, manage system proxy, query status and switch nodes using Mihomo core directly.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/cwyhkyochen-a11y/sparkle-vpn
Or

Sparkle VPN Control

This skill provides tools to control the Sparkle VPN using Mihomo core directly (no GUI interaction needed).

Tools

VPN Control

  • sparkle_vpn_start - Start VPN core only (port 7890 available, no system proxy)
  • sparkle_vpn_start_with_proxy - Start VPN and enable system-wide proxy
  • sparkle_vpn_stop - Stop VPN and disable system proxy

System Proxy Management

  • sparkle_vpn_enable_proxy - Enable system-wide proxy settings (VPN must be running)
  • sparkle_vpn_disable_proxy - Disable system-wide proxy settings

Node Management

  • sparkle_vpn_status - Query current VPN status, active node and available nodes list
  • sparkle_vpn_switch - Switch to a different VPN node

Implementation

Uses Mihomo core directly:

  • Profile: ~/.config/sparkle/profiles/19c48c94cbb.yaml
  • Proxy port: 7890 (HTTP/HTTPS)
  • Config dir: ~/.config/sparkle/
  • API port: 9090

Usage Examples

Start VPN with system proxy:

sparkle_vpn_start_with_proxy

Start VPN without system proxy (manual mode):

sparkle_vpn_start

Enable system proxy (after VPN is running):

sparkle_vpn_enable_proxy

Stop VPN:

sparkle_vpn_stop

Query status:

sparkle_vpn_status

Switch node:

sparkle_vpn_switch "香港-HKG-01-VL"

Common Nodes

  • 自动选择 - Auto select best node
  • 故障转移 - Fallback mode
  • 香港-HKG-01-VL - Hong Kong node
  • 香港-HKG-02-VL - Hong Kong node 2
  • 香港-HKT-01-VL - Hong Kong HKT
  • 新加坡-SIN-01-VL - Singapore node
  • 日本-TYO-01-VL - Japan Tokyo node
  • 美国-SJC-01-VL - US San Jose node

System Proxy Support

System proxy settings are applied via:

  • GNOME gsettings (for GNOME/GTK desktops)
  • Environment variables saved to ~/.config/sparkle/proxy.env

To use proxy in current terminal session:

source ~/.config/sparkle/proxy.env
Read Full Documentation on GitHub

Metadata

Author@cwyhkyochen-a11y
Stars3409
Views0
Updated2026-03-25
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-cwyhkyochen-a11y-sparkle-vpn": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

content-ops

Social media content operations automation system with SQLite database. Manage content crawling, curation, publishing, and analytics across platforms (Xiaohongshu, Reddit, Pinterest, Discord).

cwyhkyochen-a11y 3409

dev-workflow

完整开发工作流 - 一键执行从检查到封版的全流程

cwyhkyochen-a11y 3409

dev-task

开发项目任务管理，支持版本化开发流程。当用户需要启动开发任务、创建新版本、管理项目版本文档时使用。每次启动开发任务必须向用户确认版本编号，按版本号管理代码、开发文档、需求文档、发布配置。严格执行版本归档纪律，封版必须立即归档完整代码和文档。

cwyhkyochen-a11y 3409

DevTaskFlow

用自然语言发起开发任务，AI 驱动的开发流水线。Describe your idea, get working software. 适合产品、运营、业务人员从 0 搭建项目。

cwyhkyochen-a11y 3409

dev-pipeline

版本化开发流水线 —— 与 version-manager 和 project-manager 集成的完整开发流程

cwyhkyochen-a11y 3409