CLI proxy 命令

openclaw proxy 用于验证运营商管理的代理路由，或运行本地调试代理并检查捕获的流量。

命令概览

openclaw proxy validate [--json] [--proxy-url <url>] [--allowed-url <url>] [--denied-url <url>]
openclaw proxy start [--host <host>] [--port <port>]
openclaw proxy run [--host <host>] [--port <port>] -- <cmd...>
openclaw proxy sessions [--limit <count>]
openclaw proxy query --preset <name> [--session <id>]
openclaw proxy blob --id <blobId>
openclaw proxy coverage
openclaw proxy purge

validate 命令

部署前预检代理配置，验证公网目标可达且本地回环 canary 不可达：

openclaw proxy validate
openclaw proxy validate --proxy-url http://proxy.example.com:8080
openclaw proxy validate --allowed-url https://api.example.com
openclaw proxy validate --denied-url https://internal.example.com
openclaw proxy validate --apns-reachable   # 验证 APNs HTTP/2 可达性
openclaw proxy validate --json

选项说明：

• --proxy-url：临时指定代理 URL，不修改配置
• --allowed-url：期望能通过代理访问的目标（可重复）
• --denied-url：期望被代理拦截的目标（可重复，fail-closed）
• --apns-reachable：通过代理建立 APNs HTTP/2 CONNECT 隧道，收到 403 InvalidProviderToken 即为成功
• --timeout-ms：每个请求的超时毫秒数

validate 失败时退出码为 1。

调试代理命令

openclaw proxy start              # 启动本地调试代理（默认绑定 127.0.0.1）
openclaw proxy run -- <cmd>       # 启动代理并运行子命令
openclaw proxy sessions           # 列出捕获会话
openclaw proxy query --preset double-sends   # 查询常见流量模式
openclaw proxy purge              # 清除本地捕获数据

query 预设

预设名	用途
double-sends	重复发送检测
retry-storms	重试风暴
cache-busting	缓存破坏
ws-duplicate-frames	WebSocket 重复帧
missing-ack	缺失确认
error-bursts	错误突发

注意事项

• 启用 OpenClaw 托管代理模式时，调试代理的直连转发默认禁用；如需本地诊断，设置 OPENCLAW_DEBUG_PROXY_ALLOW_DIRECT_CONNECT_WITH_MANAGED_PROXY=1
• 捕获数据仅用于本地调试，完成后运行 openclaw proxy purge 清理

相关链接

• cli-security — 安全审计命令
• docs/gateway/configuration — Gateway 网络配置