外网智能代理（proxy-cn）

在本机已运行 Clash / V2Ray / 类似客户端（常见本地端口：HTTP 10809、SOCKS5 10808）的前提下，用脚本为单次命令或当前 shell 按需注入代理环境变量，避免全局长开代理带来的内网/公司流量误走代理。

平台支持

WSL2：Windows 主机上的 127.0.0.1:10809 在部分发行版中需通过 Windows 主机 IP 访问，可设置 PROXY_HTTP_HOST、PROXY_SOCKS_HOST 为 $(grep nameserver /etc/resolv.conf | awk '{print $2}'):端口 或用户文档中的 WSL 代理转发地址。

经典 CMD.exe：不支持直接运行 .ps1；可在 CMD 中执行 powershell -NoProfile -File "<技能目录>\proxy.ps1" ...，或手动 set HTTP_PROXY=http://127.0.0.1:10809 等（与 proxy-env.ps1 导出变量一致）。

NO_PROXY 与 CIDR：脚本默认在 no_proxy 中带私网 CIDR；个别旧版 Windows 工具对 CIDR 支持不完整。若遇异常，可设 PROXY_AUTO_NO_LOCAL=0（Bash）或 $env:PROXY_AUTO_NO_LOCAL = "0"（PowerShell）再运行，或自行精简 no_proxy 列表。

何时使用本技能

• 用户提到：访问 GitHub / OpenAI / HuggingFace / npm / PyPI / Docker Hub 超时、TLS 失败、Connection reset
• 用户要求：临时走代理完成 curl、git clone、npm install、pip install、docker pull
• 用户环境：中国大陆或企业网络对外网有限制

何时不要使用

• 访问纯内网、公司 VPN 内资源：不要设置代理，或确保 no_proxy 已包含内网段（脚本已默认写入常见私网 CIDR）
• 用户未安装本地代理客户端：应先引导用户启动 Clash 等，再使用本技能
• 敏感凭据：代理仅走本机环回地址，勿把 token 发给第三方；仍遵守各服务安全策略

文件说明（技能根目录）

默认假设本机代理：

• HTTP(S) 代理：127.0.0.1:10809
• SOCKS5：127.0.0.1:10808

若用户端口不同，在命令前设置 PROXY_HTTP_HOST、PROXY_SOCKS_HOST（见下）。

工作流（Agent 操作指引）

1. 确认用户本机代理已监听（可建议用户执行 curl -sI --connect-timeout 2 http://127.0.0.1:10809 或查看 Clash 端口说明；Windows 可用 curl.exe）。

2. 单次命令优先使用包装器（将 <技能目录> 换为实际路径）。

   Bash（macOS / Linux / Git Bash / WSL）：

   bash "<技能目录>/proxy.sh" curl -sI https://api.github.com

   PowerShell（Windows）：

   Set-Location "<技能目录>"
   .\proxy.ps1 curl.exe -sI https://api.github.com

3. 若参数里没有明显 URL（例如仅 npm install），启发式可能不会自动开代理，此时使用强制：

   PROXY_AUTO_FORCE=1 bash "<技能目录>/proxy.sh" npm install

   $env:PROXY_AUTO_FORCE = "1"; & "<技能目录>\proxy.ps1" npm install

4. 需要整段会话走代理时：

   source "<技能目录>/proxy-env.sh"

   . "<技能目录>\proxy-env.ps1"

5. 执行完后，新开终端或清除变量：Bash 用 unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY ALL_PROXY all_proxy；PowerShell 用 Remove-Item Env:\HTTP_PROXY,Env:\HTTPS_PROXY,... 或对上述变量逐个 $env:HTTP_PROXY = $null（proxy-env 脚本未自动清除）。

环境变量（可选）

Bash 与 PowerShell 使用同名环境变量（PowerShell 中通过 $env:PROXY_AUTO_FORCE = "1" 设置）。

启发式匹配说明（proxy.sh / proxy.ps1）

对所有参数做子串匹配（不区分大小写），命中下列模式之一则自动开代理（节选）：github.com、googleapis.com、openai.com、anthropic.com、npmjs.org、pypi.org、docker.io、ghcr.io、huggingface.co、crates.io 等。

限制：若 URL 写在配置文件里而不在命令行参数中，脚本无法检测，请用 PROXY_AUTO_FORCE=1。

验证命令

# 经 SOCKS 直连探测（不依赖包装脚本；Linux / macOS / Git Bash）
curl -sI --connect-timeout 5 --socks5 127.0.0.1:10808 https://www.google.com

# 经包装器（会设环境变量后执行 curl）
bash proxy.sh curl -sI https://api.github.com

# Windows：建议显式使用 curl.exe，避免与 Invoke-WebRequest 别名冲突
curl.exe -sI --connect-timeout 5 --socks5 127.0.0.1:10808 https://www.google.com
.\proxy.ps1 curl.exe -sI https://api.github.com

与 OpenClaw / 容器路径

若部署在容器中，技能路径可能是 /root/.openclaw/skills/proxy-cn/，请将上文 <技能目录> 替换为实际绝对路径。

安全与合规

• 代理出口节点与日志策略由用户本地客户端决定，本技能仅设置环境变量。
• 遵守当地法律法规与用户公司网络政策；不得用于绕过明确禁止访问的资源。