“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 start

CMD（命令提示符）：

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 start

Windows（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
pause

2.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，说明代理没有生效，请检查：

1. 环境变量是否设置正确（echo $HTTP_PROXY 查看）

2. 代理地址格式是否正确

3. 站大爷隧道代理服务是否正常

四、高级技巧：精细控制代理行为

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/ip

Q3：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 start

• Mac/Linux：export HTTP_PROXY=... + openclaw gateway start

• Docker：在docker-compose.yml的environment中配置

站大爷隧道代理本身协议兼容性很好，支持HTTP/HTTPS及SOCKS多协议，配置关键在于让OpenClaw正确地把它用起来。如果代理配好后用curl能通但OpenClaw不通，基本就是协议混淆问题——记住：用环境变量，不纠结YAML。