ClawHub

Clash VPN

Manage Clash VPN proxy service for accessing blocked websites like Google Play. Use when the user needs to (1) setup/configure VPN proxy, (2) update Clash proxy configuration, (3) start/stop VPN service, (4) test proxy connectivity, or (5) access blocked resources through proxy.

Audits

Pass
ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install clash-vpn

Clash VPN 管理

此 Skill 用于管理 Clash VPN 代理服务，实现访问 Google Play 等被屏蔽的网站。

前置条件

  • Clash 已安装: /usr/local/bin/clash
  • 配置文件路径: /root/.config/clash/config.yaml
  • 脚本路径: scripts/clash-vpn.sh

快速开始

1. 更新配置文件

用户提供新的 Clash 配置时:

# 使用脚本更新配置
cat << 'EOF' | scripts/clash-vpn.sh update
port: 7890
socks-port: 7891
# ... 完整配置内容 ...
EOF

或直接写入文件:

cat > /root/.config/clash/config.yaml << 'EOF'
# 配置内容
EOF

2. 启动 VPN

scripts/clash-vpn.sh start

3. 测试连接

scripts/clash-vpn.sh test

4. 查看状态

scripts/clash-vpn.sh status

代理地址

启动后使用以下代理地址:

类型地址
HTTPhttp://127.0.0.1:7890
SOCKS5socks5://127.0.0.1:7891
Mixedhttp://127.0.0.1:7893

使用代理访问网站

# HTTP 代理
curl --proxy http://127.0.0.1:7890 https://play.google.com

# SOCKS5 代理
curl --proxy socks5://127.0.0.1:7891 https://play.google.com

配置管理

配置模板

参考 references/config-guide.md 获取配置模板和字段说明。

配置更新流程

  1. 接收用户的新配置内容
  2. 使用脚本更新配置（自动备份旧配置）
  3. 验证配置格式
  4. 重启服务（如果正在运行）

配置备份

每次更新会自动创建备份:

/root/.config/clash/config.yaml.bak.YYYYMMDDHHMMSS

故障排查

查看日志

tail -f /var/log/clash.log

验证配置

clash -t -f /root/.config/clash/config.yaml

常见问题

  1. DNS 端口被占用: 不影响使用，可忽略
  2. MMDB 下载失败: 禁用 GEOIP 规则或手动下载
  3. 连接失败: 检查节点配置和网络连接

脚本命令参考

scripts/clash-vpn.sh start     # 启动
scripts/clash-vpn.sh stop      # 停止
scripts/clash-vpn.sh restart   # 重启
scripts/clash-vpn.sh status    # 状态
scripts/clash-vpn.sh test      # 测试连接
scripts/clash-vpn.sh update    # 更新配置（从 stdin）
scripts/clash-vpn.sh help      # 帮助