proxy auto config

自动检测和配置系统代理设置，特别为 OpenClaw Gateway 优化。使用场景包括：1) Gateway 启动时自动检测代理，2) 自动配置环境变量，3) 创建代理启动脚本，4) 定时检查代理状态，5) 支持 v2ray、Clash、SS/SSR 等常见代理工具。当系统使用代理网络环境时自动触发。

Security Scan

The skill generally does what it says (detects proxies and configures Gateway) but includes several risky and heavy-handed behaviors (overwriting crontab, creating persistent hooks/systemd timers, and disabling TLS checks) that are disproportionate and require user attention before installing.

Purpose & Capability

Name/description match the code: scripts detect environment proxies, running proxy processes, listening ports, read proxy config files, write proxy config and Gateway updates, and create start hooks. The requested capabilities are coherent with a proxy auto-config skill.

Instruction Scope

The runtime instructions and install script instruct the agent/user to read many user files (~/.bashrc, ~/.zshrc, various app config paths on the user's home), detect processes/ports, and write configuration under ~/.openclaw, ~/.local/bin and ~/.config/systemd/user. These actions are within the stated purpose but are broad in scope: the skill will parse arbitrary user config files (which may contain credentials), and it writes files and hooks that will be executed automatically. Also, scripts set NODE_TLS_REJECT_UNAUTHORIZED=0 and clear REQUESTS_CA_BUNDLE in generated environment — this disables TLS verification for Node (and may affect Python requests behavior), which is a security risk unrelated to simply 'detecting proxies'.

Install Mechanism

No external install spec (instruction-only + included scripts). The bundle includes a venv folder (pyvenv.cfg) which is unusual but not itself executable. Because code is included, installation runs local Python scripts which will write files and run system commands (crontab, systemctl). No remote downloads were observed in the provided files.

Credentials

The skill does not request credentials explicitly, which is appropriate. However it scans many user config paths (shell rc files and app config files) and will persist discovered proxy URLs (which can include credentials) unencrypted under ~/.openclaw/proxy_config and in generated startup scripts. It also sets NODE_TLS_REJECT_UNAUTHORIZED=0 and clears REQUESTS_CA_BUNDLE in generated scripts—these environment changes weaken TLS security system-wide for processes using those env vars.

Persistence & Privilege

The install script creates persistent artifacts: cron jobs (via crontab), a Gateway hook (~/.openclaw/gateway_proxy_hook.sh), a wrapper script in ~/.local/bin, systemd user service/timer files and attempts to enable/start them. Of particular concern: the installer writes a temporary cron file and invokes 'crontab <file>' — this will replace the user's entire crontab rather than append, which can silently remove unrelated scheduled jobs. Creating persistent hooks and timers is consistent with the feature but raises privilege/persistence concerns the user should review.

What to consider before installing

This skill appears to implement proxy detection and Gateway integration as advertised, but you should NOT install it blindly. Before installing: 1) Review the scripts yourself (or run them in a safe VM/container) — they will read shell and app config files and may capture proxy URLs that include credentials. 2) Backup your crontab (crontab -l > cron.bak) because the installer calls 'crontab <file>' which will replace your crontab entries. 3) Note the installer creates systemd user timers and a wrapper script (~/.local/bin/openclaw-proxy) and a Gateway hook; be prepared to remove those if unwanted. 4) The scripts set NODE_TLS_REJECT_UNAUTHORIZED=0 and clear REQUESTS_CA_BUNDLE in generated env scripts — this disables TLS certificate validation for Node (and may weaken Python requests). Remove or change those lines before using if you care about TLS integrity. 5) If you want reduced risk, modify the installer to (a) append to crontab instead of replacing it, (b) avoid automatically enabling systemd timers, and (c) do not globally disable TLS verification. 6) If unsure, test in an isolated account or VM first and inspect any saved proxy configuration files (~/.openclaw/proxy_config/) for embedded credentials.

代理自动配置技能

概述

本技能自动检测系统中的代理配置，并为 OpenClaw Gateway 提供无缝的代理集成。支持自动检测 v2ray、Clash、SS/SSR 等常见代理工具，自动配置环境变量和 Gateway 设置，确保在网络受限环境下 OpenClaw 能正常工作。

核心功能

1. 代理自动检测

• 环境变量检测: 自动读取 HTTP_PROXY、HTTPS_PROXY 等环境变量
• 进程检测: 检测正在运行的 v2ray、Clash、SS/SSR 等代理进程
• 端口检测: 扫描常见代理端口（1080-1090, 7890, 10808 等）
• 配置检测: 读取代理工具的配置文件

2. Gateway 集成

• 自动配置: Gateway 启动时自动应用代理设置
• 环境变量: 设置 HTTP_PROXY、HTTPS_PROXY 等环境变量
• 插件配置: 自动更新 Gateway 的 http-proxy 插件配置
• 启动脚本: 创建带代理的 Gateway 启动脚本

3. 自动化管理

• 定时检查: 每小时自动检查代理状态
• 启动钩子: Gateway 启动前自动运行代理配置
• 故障恢复: 代理失效时自动尝试其他配置
• 日志记录: 详细的代理配置和运行日志

4. 多代理支持

• v2ray/v2rayN: 支持本地 SOCKS5 代理（端口 10808）
• Clash: 支持 HTTP/SOCKS 代理（端口 7890）
• SS/SSR: 支持 Shadowsocks 代理
• 系统代理: 支持系统级别的代理设置

快速开始

1. 安装技能

cd ~/.openclaw/workspace/skills/proxy-auto-config
python3 scripts/install_proxy_skill.py

2. 检测代理

python3 scripts/proxy_detector.py --configure

3. 配置 Gateway

python3 scripts/gateway_proxy_setup.py

4. 使用代理启动 Gateway

# 使用包装脚本
openclaw-proxy start

# 或直接设置环境变量
HTTP_PROXY=socks5://127.0.0.1:10808 openclaw gateway start

工作流程

步骤 1: 代理检测

1. 扫描环境变量中的代理设置
2. 检测正在运行的代理进程
3. 检查监听端口的代理服务
4. 读取代理配置文件
5. 选择最佳的代理配置

步骤 2: 环境配置

1. 设置 HTTP_PROXY、HTTPS_PROXY 环境变量
2. 配置 Python requests 库的代理设置
3. 设置 Node.js/npm 的代理配置
4. 更新系统代理设置（如果支持）

步骤 3: Gateway 配置

1. 更新 Gateway 配置文件（gateway.json）
2. 配置 http-proxy 插件
3. 创建启动脚本
4. 设置 systemd 服务（如果可用）

步骤 4: 自动化部署

1. 创建定时检查任务
2. 设置 Gateway 启动钩子
3. 配置日志轮转
4. 启用故障监控

使用示例

⚠️ 注意：

• 代理端口 10808 是示例，请根据你的实际配置修改
• 使用 ~ 代替硬编码的家目录路径
• 所有路径都应该是相对路径或使用环境变量

示例 1: 手动检测和配置

# 检测当前代理
cd ~/.openclaw/workspace/skills/proxy-auto-config
python3 scripts/proxy_detector.py --verbose

# 配置环境
python3 scripts/proxy_detector.py --configure --output ~/.openclaw/proxy_config

# 应用配置
source ~/.openclaw/proxy_config/configure_proxy.sh

示例 2: Gateway 集成

# 配置 Gateway 代理
python3 scripts/gateway_proxy_setup.py --config-dir ~/.openclaw

# 查看 Gateway 配置
cat ~/.openclaw/gateway.json | jq '.plugins["http-proxy"]'

# 使用代理启动 Gateway
openclaw-proxy start

示例 3: 定时检查

# 查看定时任务
crontab -l | grep openclaw

# 查看检查日志
tail -f ~/.openclaw/logs/proxy_check.log

# 手动运行检查
python3 scripts/proxy_detector.py --configure

示例 4: 故障排除

# 测试代理连接
python3 scripts/proxy_detector.py --test --configure

# 查看详细日志
tail -f ~/.openclaw/logs/proxy_setup.log

# 重置配置
rm -rf ~/.openclaw/proxy_config/
python3 scripts/install_proxy_skill.py

脚本文件

scripts/ 目录

包含所有可执行的 Python 脚本：

1. proxy_detector.py - 核心代理检测脚本

   • 自动检测系统代理配置
   • 支持多种代理工具（v2ray、Clash、SS/SSR）
   • 环境变量和配置文件管理
   • 代理连接测试和验证

2. gateway_proxy_setup.py - Gateway 代理设置脚本

   • 集成 OpenClaw Gateway 代理配置
   • 自动更新 gateway.json 配置文件
   • 创建启动脚本和 systemd 服务
   • 环境变量自动设置

3. install_proxy_skill.py - 安装和配置脚本

   • 检查系统依赖
   • 创建定时任务和启动钩子
   • 配置 systemd 集成
   • 生成使用指南

依赖要求

# 必需依赖
pip install psutil requests

# 可选依赖（用于高级功能）
pip install jq  # JSON 处理

配置文件结构

生成的配置文件

~/.openclaw/
├── gateway.json                    # Gateway 配置文件（自动更新）
├── proxy_config/                   # 代理配置目录
│   ├── proxy_config.json          # 代理检测结果
│   ├── configure_proxy.sh         # 代理配置脚本
│   └── gateway_proxy.json         # Gateway 代理配置
├── logs/                          # 日志目录
│   ├── proxy_setup.log           # 代理设置日志
│   ├── proxy_check.log           # 定时检查日志
│   └── gateway_proxy_setup.log   # Gateway 设置日志
└── gateway_proxy_hook.sh         # Gateway 启动钩子

系统集成文件

~/.local/bin/openclaw-proxy        # Gateway 代理包装脚本
~/.config/systemd/user/           # systemd 用户服务
   ├── openclaw-proxy-check.service
   └── openclaw-proxy-check.timer

在 OpenClaw 中使用

自动触发条件

当以下情况发生时自动触发代理配置：

1. Gateway 启动时 - 自动检测和配置代理
2. 网络环境变化时 - 定时检查代理状态
3. 代理工具启动/停止时 - 自动更新配置
4. 用户手动请求时 - 通过命令触发重新配置

响应示例

## 代理自动配置完成

✅ 检测到 v2rayN 代理
   - 类型: SOCKS5
   - 地址: socks5://127.0.0.1:10808
   - 进程: xray (PID: 3595)

⚙️ 配置已更新:
   - 环境变量: HTTP_PROXY, HTTPS_PROXY
   - Gateway 配置: http-proxy 插件
   - 启动脚本: ~/.local/bin/openclaw-proxy

🚀 使用代理启动 Gateway:
   ```bash
   openclaw-proxy start

📊 状态监控:

• 下次检查: 1小时后
• 日志文件: ~/.openclaw/logs/proxy_check.log

### 故障处理
当代理配置失败时：
1. **尝试备用代理** - 自动尝试其他检测到的代理
2. **回退直连模式** - 如果所有代理都不可用
3. **记录错误信息** - 详细的错误日志
4. **通知用户** - 提供修复建议

## 最佳实践

### 1. 代理工具配置
- 保持代理工具稳定运行
- 使用固定端口（如 10808）
- 启用代理工具的自启动
- 定期更新代理订阅

### 2. 技能维护
- 定期运行代理检测
- 监控代理连接状态
- 更新技能到最新版本
- 备份重要配置文件

### 3. 故障排除
- 检查代理工具是否正常运行
- 验证代理端口是否可访问
- 查看技能日志获取详细信息
- 手动测试代理连接

### 4. 性能优化
- 减少不必要的代理检测
- 缓存有效的代理配置
- 优化定时检查频率
- 使用轻量级检测方法

## 扩展和定制

### 添加新的代理支持
1. 在 `proxy_detector.py` 中添加新的检测逻辑
2. 更新代理端口和进程关键词
3. 添加对应的配置文件解析
4. 测试新的代理类型

### 自定义配置
1. 修改默认的代理端口列表
2. 调整检测优先级
3. 自定义日志格式和位置
4. 修改定时检查频率

### 集成其他工具
1. 添加对其他网络工具的支持
2. 集成到系统网络管理器
3. 添加 GUI 配置界面
4. 支持云代理服务

---

**技能状态**: ✅ 已完成并测试
**最后更新**: 2026-03-29
**适用环境**: Linux 系统，支持 systemd，使用 v2ray/Clash 等代理工具