“YAML 配置改了好几遍，代理就是不起作用……”

“运行 openclaw gateway start 没报错，但所有请求都走直连，完全没走代理……”

“配置看起来没问题，可就是连不上，也不知道哪里错了……”

如果你在用 OpenClaw 配站大爷隧道代理时遇到过这些问题，你不是一个人。

很多代理配置错误，靠“看”是看不出来的——YAML 格式没错、URL 格式没错，但就是跑不通。这时候你需要一个能自动扫描配置、定位问题、甚至帮你修复的工具。

OpenClaw 官方提供了这样一个命令：openclaw doctor。

今天这篇文章，就从 doctor 命令的三种运行模式出发，结合站大爷隧道代理配置中最常见的错误场景，教你用一条命令快速定位代理配置问题。

一、先弄懂：openclaw doctor 是什么？

openclaw doctor 是 OpenClaw 内置的健康检查与配置修复工具。它的核心能力有三项：

运行模式	命令	行为
检查模式	openclaw doctor	面向人的健康检查，输出诊断结果和引导式提示
修复模式	openclaw doctor --fix	自动应用受支持的修复，会提示确认
Lint 模式	openclaw doctor --lint	只读的结构化检查，适合 CI 和自动化脚本

简单说：**不知道哪里错了，跑 doctor；知道错了想自动修，跑 doctor --fix；想在脚本里做预检，跑 doctor --lint**。

当配置中包含已废弃的键时，其他命令会拒绝运行并要求你执行 openclaw doctor。doctor 会检测网关连接状态、通道配置完整性及代理服务可用性，并输出包含错误码与修复建议的标准化报告。

二、代理配置最常见的 4 类错误，doctor 都能查到

错误一：HTTP/HTTPS 协议混淆

这是站大爷隧道代理配置中最常见的坑。你在 config.yaml 里把 proxy.http 和 proxy.https 都配成了 http:// 开头的地址，但 OpenClaw 在处理 HTTPS 请求时走了 HTTP 代理逻辑，导致 CONNECT 请求失败。

doctor 怎么查？

运行 openclaw doctor，它会检查代理 URL 的有效性。如果代理配置有问题，doctor 会报告配置问题。

修复方法：推荐改用环境变量配置法（HTTP_PROXY / HTTPS_PROXY），这是 Node.js 原生支持的代理机制，能彻底绕开协议混淆问题。配置完成后再次运行 openclaw doctor 验证。

错误二：环境变量冲突导致代理“消失”

有用户反馈：在 OpenClaw 的图形界面里配置了代理，但一运行 openclaw doctor，代理配置就“消失”了。这是因为某些渠道验证流程会自动调用 openclaw doctor，而 doctor 的重写逻辑可能覆盖了配置。

doctor 怎么查？

运行 openclaw doctor 或 openclaw doctor --fix，观察输出中是否有代理配置被修改的提示。

修复方法：

1. 检查是否有多个代理配置源（config.yaml 里的 proxy 字段 + 环境变量 HTTP_PROXY）同时存在

2. 二选一，推荐只保留环境变量方案

3. 运行 openclaw doctor 验证配置没有被意外修改

错误三：代理未启用或 URL 无效

如果你在配置文件中写了 proxy.proxyUrl 但没有设置 proxy.enabled: true，代理路由不会生效。或者代理 URL 格式错误（比如漏了 http:// 前缀、认证信息写错），doctor 都能检测到。

doctor 怎么查？

openclaw doctor 会检查代理是否已启用以及代理 URL 是否有效。如果未启用或配置无效，会报告配置问题。

修复方法：

1. 确认 proxy.enabled: true 已设置

2. 确认 proxy.proxyUrl 格式正确：http://用户名:密码@域名:端口

3. 运行 openclaw doctor 验证修复效果

错误四：可信代理认证模式下的误报

如果你配置了 trusted proxy auth 模式，运行 openclaw doctor 时可能会看到“缺少 token”的警告。这是 doctor 在评估网关时的正常行为——可信代理模式下不需要 Gateway Token，但 doctor 的检查逻辑可能仍会报告这个“问题”。

doctor 怎么查？

运行 openclaw doctor，观察输出中是否有“missing token”相关的警告。

修复方法：这是误报，可以忽略。如果不想看到这个警告，可以在 gateway.auth.trustedProxies 中正确配置受信任的代理 IP 列表。

三、实战：用 doctor 三步排查代理配置

第一步：运行基础健康检查

openclaw doctor

这会输出一份面向人的诊断报告，告诉你当前配置中哪些地方有问题。

第二步：如果发现问题，尝试自动修复

openclaw doctor --fix

doctor --fix 会应用受支持的修复，比如：

• 清理过期的 OAuth 认证副本

• 修复损坏的依赖树

• 迁移已废弃的配置项

它会提示确认后再执行修改。

第三步：用 Lint 模式做只读验证（适合 CI/脚本）

openclaw doctor --lint --severity-min error

Lint 模式是只读的，不会修改任何配置。--severity-min error 只输出 error 级别的发现，适合在自动化脚本中做预检。

四、进阶：openclaw proxy validate —— 代理专用预检工具

除了 doctor，OpenClaw 还有一个专门针对代理的验证命令：**openclaw proxy validate**。

它会按顺序检查代理 URL 的来源：

1. --proxy-url 命令行参数

2. 配置文件中的 proxy.proxyUrl

3. 环境变量 OPENCLAW_PROXY_URL

常用命令：

# 验证当前配置的代理
openclaw proxy validate

# 验证指定的代理 URL（不修改配置）
openclaw proxy validate --proxy-url "http://用户:密码@tps.zdaye.com:8080"

# 输出 JSON 格式结果（适合脚本解析）
openclaw proxy validate --json

默认会执行两项检查：

• 允许检查：通过代理访问 https://example.com/ 是否成功

• 拒绝检查：代理是否能正确拒绝回环地址（防止流量被错误转发）

如果代理配置或目标检查失败，命令会以代码 1 退出。

五、站大爷隧道代理 + doctor 的配合建议

站大爷隧道代理配置好后，建议跑一遍完整的诊断流程：

第一步：配置站大爷隧道代理（推荐环境变量法）

export HTTP_PROXY="http://隧道ID:密码@tps.zdaye.com:8080"
export HTTPS_PROXY="http://隧道ID:密码@tps.zdaye.com:8080"

第二步：运行 openclaw doctor 验证配置

openclaw doctor

第三步：如果 doctor 报告代理相关问题，用 openclaw proxy validate 做专项验证

openclaw proxy validate

第四步：验证代理是否真正生效 在 OpenClaw 对话框中输入：

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

如果返回的 IP 不是你的本机 IP，说明代理配置成功了。

总结

代理配置错误是 OpenClaw 使用中最常见的“隐形杀手”——配置看起来没问题，但就是跑不通。

openclaw doctor 就是为了解决这个问题而设计的：

• 不知道哪里错了 → openclaw doctor（健康检查）

• 知道错了想自动修 → openclaw doctor --fix（自动修复）

• 想在 CI/脚本里做预检 → openclaw doctor --lint（只读检查）

• 只想检查代理 → openclaw proxy validate（代理专用验证）

站大爷隧道代理本身协议兼容性很好，配置的关键在于让 OpenClaw 正确地把它用起来。如果配好后跑不通，别盯着 YAML 文件硬看——跑一遍 openclaw doctor，让工具帮你找问题。