外网智能代理（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 访问，可设置 PROXYHTTPHOST、PROXYSOCKSHOST 为 $(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 导出变量一致）。

NOPROXY 与 CIDR：脚本默认在 noproxy 中带私网 CIDR；个别旧版 Windows 工具对 CIDR 支持不完整。若遇异常，可设 PROXYAUTONOLOCAL=0（Bash）或 $env:PROXYAUTONOLOCAL = 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

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

工作流（Agent 操作指引）

1. 1. 确认用户本机代理已监听（可建议用户执行 curl -sI --connect-timeout 2 http://127.0.0.1:10809 或查看 Clash 端口说明；Windows 可用 curl.exe）。
2. 单次命令优先使用包装器（将 <技能目录> 换为实际路径）。

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

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

PowerShell（Windows）：

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

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

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

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

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

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

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

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

环境变量（可选）

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

变量	含义	默认
PROXYAUTOFORCE	设为 1 时强制为本次命令设置代理	未设置
PROXYHTTPHOST

HTTP 代理 host:port | 127.0.0.1:10809 |
| PROXYSOCKSHOST | SOCKS5 host:port | 127.0.0.1:10808 |
| PROXYAUTONOLOCAL | 设为 0 可不导出 noproxy | 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 写在配置文件里而不在命令行参数中，脚本无法检测，请用 PROXYAUTOFORCE=1。

验证命令

bash

经 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

powershell

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/，请将上文 <技能目录> 替换为实际绝对路径。

##