环境变量配置法：通过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:密码@域名:端口）

2.2 Windows系统配置

PowerShell（推荐）：

复制代码

# 设置HTTP和HTTPS代理环境变量
$env:HTTP_PROXY="http://隧道ID:密码@tps.zdaye.com:8080"
$env:HTTPS_PROXY="http://隧道ID:密码@tps.zdaye.com:8080"

# 启动OpenClaw
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）：

按Win + R，输入sysdm.cpl
点击"高级" → "环境变量"
在"系统变量"中点击"新建"
变量名：HTTP_PROXY，变量值：http://隧道ID:密码@tps.zdaye.com:8080
同样添加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配置文件中：

Bash：~/.bashrc 或 ~/.bash_profile
Zsh：~/.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: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"

2.5 创建启动脚本（一劳永逸）

为了避免每次都要手动输入环境变量，建议创建一个启动脚本。

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

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

给脚本添加执行权限：chmod +x start_openclaw.sh

三、验证配置是否生效

配置完成后，用OpenClaw验证一下代理是否生效。

在OpenClaw对话框中输入：

复制代码

请访问 https://httpbin.org/ip，告诉我返回的IP地址是什么

预期结果：

返回的IP地址不是你的本机IP
等待1分钟后再次查询，IP地址自动变化（说明隧道代理轮换生效）

如果返回的是你的本机IP，说明代理没有生效，请检查：

环境变量是否设置正确（echo $HTTP_PROXY 查看）
代理地址格式是否正确
站大爷隧道代理服务是否正常

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

4.1 区分HTTP和HTTPS代理

虽然通常将HTTP_PROXY和HTTPS_PROXY设为同一个值，但在某些场景下你可以区分设置：

复制代码

# HTTP请求走一个代理
export HTTP_PROXY="http://http-proxy.example.com:8080"

# HTTPS请求走另一个代理
export HTTPS_PROXY="http://https-proxy.example.com:8080"

4.2 设置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.3 结合站大爷隧道高级参数

站大爷隧道代理支持精细化控制IP切换周期和地域。你可以将这些参数编码到代理地址的用户名中：

复制代码

# 每15秒切换一次IP（华东地区）
export HTTP_PROXY="http://20250114387972168168-period-15-area-EC:hywh8168@tps.zdaye.com:8080"

# 每60秒切换一次IP（浙江省杭州市）
export HTTP_PROXY="http://20250114387972168168-period-60-prov-33-city-330100:hywh8168@tps.zdaye.com:8080"

4.4 临时关闭代理

如果需要临时不走代理，可以unset环境变量：

复制代码

# 关闭代理
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
某些旧版本Node.js对环境变量支持不完善，建议升级到v18+
或者使用cross-env工具：npx cross-env HTTP_PROXY=... openclaw gateway start

Q2：代理连接超时

可能原因：网络不通或代理地址错误

解决方案：

先用curl测试代理是否可用：

复制代码

curl -x http://隧道ID:密码@tps.zdaye.com:8080 https://httpbin.org/ip

检查防火墙是否放行代理端口
确认站大爷隧道代理服务状态

Q3：环境变量设置后其他程序也走了代理

可能原因：环境变量是全局生效的

解决方案：

使用启动脚本，只在脚本中设置环境变量
或者在终端中临时设置，用完即关闭

六、环境变量 vs YAML配置：终极对比

对比维度	环境变量方案	YAML配置方案
稳定性	⭐⭐⭐⭐⭐ 底层原生支持	⭐⭐⭐ 可能遇到兼容问题
配置难度	⭐⭐⭐⭐ 一条命令搞定	⭐⭐ 需要理解YAML格式
协议兼容性	⭐⭐⭐⭐⭐ 无混淆问题	⭐⭐ HTTP/HTTPS可能混淆
跨平台支持	⭐⭐⭐⭐⭐ Windows/Mac/Linux通用	⭐⭐⭐⭐ 配置文件路径不同
精细控制	⭐⭐⭐ 支持NO_PROXY	⭐⭐⭐⭐ 支持更多OpenClaw特有配置
推荐场景	生产环境、稳定性优先	快速测试、需要精细控制

结论：如果你追求稳定可靠、不想踩坑，首选环境变量方案。它是最底层、最原生的代理配置方式，能绕开OpenClaw代理逻辑中可能存在的各种问题。

七、总结

环境变量配置法的核心优势可以用一句话概括：绕过OpenClaw的代理解析逻辑，直接利用Node.js原生代理机制。

与其在YAML配置上反复试错、踩坑、查文档，不如用环境变量方案一步到位：

Windows ：$env:HTTP_PROXY=... + openclaw gateway start
Mac/Linux ：export HTTP_PROXY=... + openclaw gateway start
永久生效：写入配置文件或创建启动脚本

这就是我经过反复踩坑后总结出的"最佳实践"。如果你正在使用OpenClaw+站大爷隧道代理做采集任务，强烈建议采用环境变量方案。

环境变量配置法：通过HTTP_PROXY让OpenClaw走代理的最佳实践

一、为什么要用环境变量配置代理？

1.1 YAML配置的"坑"有多深？

1.2 环境变量方案的三大优势

二、环境变量配置实战（分步教程）

2.1 准备工作

2.2 Windows系统配置

2.3 Mac / Linux系统配置

在文件末尾添加

2.4 Docker环境配置

2.5 创建启动脚本（一劳永逸）

三、验证配置是否生效

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

4.1 区分HTTP和HTTPS代理

4.2 设置NO_PROXY绕过代理

4.3 结合站大爷隧道高级参数

4.4 临时关闭代理

五、常见问题排查

Q1：设置了环境变量，但OpenClaw还是不走代理

Q2：代理连接超时

Q3：环境变量设置后其他程序也走了代理

六、环境变量 vs YAML配置：终极对比

七、总结