环境变量配置法：通过 HTTP_PROXY 让OpenClaw走代理的最佳实践
“YAML配置文件改了好几遍，代理就是不起作用……”
“明明curl能通，OpenClaw偏偏报连接失败……”
“换了好几个版本的配置模板，问题依旧……”
如果你正在经历这些，恭喜你，你不是一个人。这是我在使用OpenClaw+站大爷隧道代理时踩过最深的一个坑。
经过反复折腾和大量测试，我找到了一个100%稳定、绕过所有配置陷阱的方案——环境变量配置法。今天就把这个“最佳实践”完整分享出来，帮你彻底告别代理配置的烦恼。
一、为什么要用环境变量配置代理？
1.1 YAML配置的“坑”有多深？
很多教程会告诉你：在OpenClaw的config.yaml里配置代理就行了：
proxy: http: "http://隧道ID:密码@tps.zdaye.com:8080" https: "http://隧道ID:密码@tps.zdaye.com:8080"看起来没毛病。但实际运行中，你很可能遇到这些问题：
| 问题现象 | 可能原因 |
|---|---|
| 连接被拒绝（ECONNREFUSED） | OpenClaw代理解析逻辑异常 |
| 代理隧道失败 | HTTPS请求走了HTTP代理逻辑 |
| 配置文件不生效 | YAML格式错误或缩进问题 |
| 重启后配置丢失 | 配置文件路径不对 |
这些问题的根本原因是：OpenClaw自己实现的代理逻辑存在兼容性缺陷。
1.2 环境变量方案的三大优势
与YAML配置不同，环境变量方案有以下核心优势：
优势一：底层原生支持
OpenClaw底层依赖Node.js的HTTP/HTTPS模块发送网络请求。HTTP_PROXY和HTTPS_PROXY环境变量是Node.js原生支持的代理机制，由Node.js底层直接处理代理连接，绕过了OpenClaw自己实现的代理逻辑。
优势二：协议兼容性最好
环境变量方案不存在HTTP/HTTPS协议混淆的问题。无论你的请求是HTTP还是HTTPS，环境变量都能正确处理。
优势三：配置简单，一次生效
不需要纠结YAML格式、不需要担心缩进问题、不需要反复重启验证。设置好环境变量，启动OpenClaw，代理立即生效。
二、环境变量配置实战
2.1 准备工作
在开始之前，确保你已经：
✅ 安装了OpenClaw（
npm install -g openclaw@latest）✅ 注册了站大爷账号并获取了隧道代理入口
✅ 知道你的代理地址（格式：
http://隧道ID:密码@域名:端口）
站大爷隧道代理入口格式示例：http://隧道ID:密码@tps.zdaye.com:8080
2.2 Windows系统配置
PowerShell（推荐）：
$env:HTTP_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" $env:HTTPS_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" openclaw gateway startCMD（命令提示符）：
set HTTP_PROXY=http://隧道ID:密码@tps.zdaye.com:8080 set HTTPS_PROXY=http://隧道ID:密码@tps.zdaye.com:8080 openclaw gateway start⚠️注意：PowerShell和CMD设置的环境变量只在当前终端窗口生效，关闭窗口后失效。
永久生效（Windows）：在“系统变量”中新建HTTP_PROXY和HTTPS_PROXY，填入代理地址即可。
2.3 Mac / Linux系统配置
单次生效（当前终端）：
export HTTP_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" export HTTPS_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" openclaw gateway start永久生效（推荐）：
将以下内容添加到你的shell配置文件中（~/.bashrc、~/.bash_profile或~/.zshrc）：
export HTTP_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" export HTTPS_PROXY="http://隧道ID:密码@tps.zdaye.com:8080"然后执行source ~/.zshrc（或对应配置文件）使其生效。
2.4 Docker环境配置
如果你在Docker中运行OpenClaw，必须在docker-compose.yml中显式传递环境变量：
services: openclaw: image: openclaw/openclaw:latest environment: - HTTP_PROXY=http://隧道ID:密码@tps.zdaye.com:8080 - HTTPS_PROXY=http://隧道ID:密码@tps.zdaye.com:8080 - NO_PROXY=localhost,127.0.0.1 ports: - "18789:18789"⚠️关键提醒：不要在容器里手动export环境变量，容器重启就没了。必须在docker run或docker-compose中传递。
2.5 创建启动脚本（一劳永逸）
Mac/Linux（start_openclaw.sh）：
#!/bin/bash export HTTP_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" export HTTPS_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" openclaw gateway startWindows（start_openclaw.bat）：
@echo off set HTTP_PROXY=http://隧道ID:密码@tps.zdaye.com:8080 set HTTPS_PROXY=http://隧道ID:密码@tps.zdaye.com:8080 openclaw gateway start pause2.6 结合PM2守护进程（生产环境）
在Linux服务器上，可以配合PM2实现开机自启与崩溃自动重启：
npm install -g pm2 pm2 start openclaw --name openclaw-gateway -- gateway run pm2 save && pm2 startup三、验证配置是否生效
配置完成后，在OpenClaw对话框中输入：
请访问 https://httpbin.org/ip，告诉我返回的IP地址是什么预期结果：
返回的IP地址不是你的本机IP
等待1分钟后再次查询，IP地址自动变化（说明隧道代理轮换生效）
如果返回的是你的本机IP，说明代理没有生效，请检查：
环境变量是否设置正确（
echo $HTTP_PROXY查看）代理地址格式是否正确
站大爷隧道代理服务是否正常
四、高级技巧：精细控制代理行为
4.1 设置NO_PROXY绕过代理
某些内网地址或本地服务不需要走代理，可以用NO_PROXY指定：
export HTTP_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" export HTTPS_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" export NO_PROXY="localhost,127.0.0.1,*.internal.com,192.168.*"4.2 结合站大爷隧道高级参数
站大爷隧道代理支持精细化控制IP切换周期和地域，可以编码到代理地址的用户名中：
# 每15秒切换一次IP（华东地区） export HTTP_PROXY="http://用户ID-period-15-area-EC:密码@tps.zdaye.com:8080" # 每60秒切换一次IP（浙江省杭州市） export HTTP_PROXY="http://用户ID-period-60-prov-33-city-330100:密码@tps.zdaye.com:8080"4.3 临时关闭代理
# 关闭代理 unset HTTP_PROXY HTTPS_PROXY # 重新开启 export HTTP_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" export HTTPS_PROXY="http://隧道ID:密码@tps.zdaye.com:8080"五、常见问题排查
Q1：设置了环境变量，但OpenClaw还是不走代理
可能原因：Node.js版本问题
解决方案：确认Node.js版本（node --version），建议升级到v18+。旧版本对环境变量支持不完善。
Q2：代理连接超时
可能原因：网络不通或代理地址错误
解决方案：先用curl测试代理是否可用：
curl -x http://隧道ID:密码@tps.zdaye.com:8080 https://httpbin.org/ipQ3：Docker容器内代理不生效
可能原因：环境变量未透传，或YAML配置与容器环境变量冲突
解决方案：在Docker部署中，只用环境变量，注释掉YAML中的proxy配置。不要混用两种方式，否则可能冲突导致两者都不生效。
六、环境变量 vs YAML配置：终极对比
| 对比维度 | 环境变量方案 | YAML配置方案 |
|---|---|---|
| 稳定性 | ⭐⭐⭐⭐⭐ 底层原生支持 | ⭐⭐⭐ 可能遇到兼容问题 |
| 配置难度 | ⭐⭐⭐⭐ 一条命令搞定 | ⭐⭐ 需要理解YAML格式 |
| 协议兼容性 | ⭐⭐⭐⭐⭐ 无混淆问题 | ⭐⭐ HTTP/HTTPS可能混淆 |
| 跨平台支持 | ⭐⭐⭐⭐⭐ Windows/Mac/Linux通用 | ⭐⭐⭐⭐ 配置文件路径不同 |
| 精细控制 | ⭐⭐⭐ 支持NO_PROXY | ⭐⭐⭐⭐ 支持更多OpenClaw特有配置 |
| 推荐场景 | 生产环境、稳定性优先 | 快速测试、需要精细控制 |
结论：如果你追求稳定可靠、不想踩坑，首选环境变量方案。
总结
环境变量配置法的核心优势可以用一句话概括：绕过OpenClaw的代理解析逻辑，直接利用Node.js原生代理机制。
与其在YAML配置上反复试错、踩坑、查文档，不如用环境变量方案一步到位：
Windows：
$env:HTTP_PROXY=...+openclaw gateway startMac/Linux：
export HTTP_PROXY=...+openclaw gateway startDocker：在
docker-compose.yml的environment中配置
站大爷隧道代理本身协议兼容性很好，支持HTTP/HTTPS及SOCKS多协议，配置关键在于让OpenClaw正确地把它用起来。如果代理配好后用curl能通但OpenClaw不通，基本就是协议混淆问题——记住：用环境变量，不纠结YAML。