外网智能代理（proxy-cn）
在本机已运行 Clash / V2Ray / 类似客户端（常见本地端口：HTTP 10809、SOCKS5 10808）的前提下，用脚本为单次命令或当前 shell 按需注入代理环境变量，避免全局长开代理带来的内网/公司流量误走代理。
平台支持
| 环境 | 推荐入口 | 说明 |
|---|---|---|
| macOS | bash + proxy.sh / source proxy-env.sh | 与 Linux 相同，需 Bash（系统自带或 Homebrew）。 |
| Linux | bash + proxy.sh / source proxy-env.sh | 需已安装 bash；Alpine 等若只有 sh 请 apk add bash。 |
| Windows（PowerShell） | proxy.ps1 / 点源 proxy-env.ps1 | 原生终端用 PowerShell 5.1+（含 Windows PowerShell 与 PowerShell 7 pwsh）。首次若被策略拦截，可用 pwsh -ExecutionPolicy Bypass -File proxy.ps1 ...。 |
| Windows（Git Bash / MSYS2） | 与 Linux 相同，使用 proxy.sh | 路径用 Unix 风格，如 bash /c/path/to/proxy-cn/proxy.sh curl ...。 |
| WSL | 与 Linux 相同 | 在 WSL 内用 bash 脚本；代理端口指向 WSL 可访问的本机 IP（见下）。 |
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 发给第三方；仍遵守各服务安全策略
文件说明（技能根目录）
| 文件 | 作用 |
|---|---|
proxy.sh | Bash（macOS / Linux / Git Bash / WSL）：对「单条命令」做域名启发式检测，匹配则注入代理并 exec 子进程 |
proxy-env.sh | Bash：source 后在当前 shell 中长期生效（无域名检测） |
proxy.ps1 | Windows PowerShell：与 proxy.sh 等价逻辑 |
proxy-env.ps1 | PowerShell：点源 . .\proxy-env.ps1 后在当前会话生效 |
默认假设本机代理：
- HTTP(S) 代理：
127.0.0.1:10809 - SOCKS5：
127.0.0.1:10808
若用户端口不同，在命令前设置 PROXY_HTTP_HOST、PROXY_SOCKS_HOST（见下）。
工作流（Agent 操作指引）
-
确认用户本机代理已监听（可建议用户执行
curl -sI --connect-timeout 2 http://127.0.0.1:10809或查看 Clash 端口说明；Windows 可用curl.exe）。 -
单次命令优先使用包装器（将
<技能目录>换为实际路径）。Bash（macOS / Linux / Git Bash / WSL）：
bash "<技能目录>/proxy.sh" curl -sI https://api.github.comPowerShell（Windows）：
Set-Location "<技能目录>" .\proxy.ps1 curl.exe -sI https://api.github.com -
若参数里没有明显 URL（例如仅
npm install），启发式可能不会自动开代理，此时使用强制：PROXY_AUTO_FORCE=1 bash "<技能目录>/proxy.sh" npm install$env:PROXY_AUTO_FORCE = "1"; & "<技能目录>\proxy.ps1" npm install -
需要整段会话走代理时：
source "<技能目录>/proxy-env.sh". "<技能目录>\proxy-env.ps1" -
执行完后，新开终端或清除变量：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_AUTO_FORCE | 设为 1 时强制为本次命令设置代理 | 未设置 |
PROXY_HTTP_HOST | HTTP 代理 host:port | 127.0.0.1:10809 |
PROXY_SOCKS_HOST | SOCKS5 host:port | 127.0.0.1:10808 |
PROXY_AUTO_NO_LOCAL | 设为 0 可不导出 no_proxy | 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/，请将上文 <技能目录> 替换为实际绝对路径。
安全与合规
- 代理出口节点与日志策略由用户本地客户端决定，本技能仅设置环境变量。
- 遵守当地法律法规与用户公司网络政策；不得用于绕过明确禁止访问的资源。