OpenClaw（龙虾）在Docker Compose怎么设置代理图文教程

2026-03-19 2

详情

报告

跨境服务

文章

引言

OpenClaw（龙虾） 是一款面向开发者与运维人员的开源网络调试与代理分析工具，常用于模拟请求链路、抓包、重放及中间件调试。它本身不是跨境电商SaaS或平台服务，而是一个本地运行的CLI+Web工具；Docker Compose 是用于定义和运行多容器Docker应用的编排工具。‘设置代理’指将OpenClaw配置为HTTP/HTTPS代理服务器，供本地开发环境或测试流量经其转发并可视化。

要点速读（TL;DR）

OpenClaw（龙虾）需通过 docker-compose.yml 暴露代理端口（默认8080），并配置环境变量启用代理模式；
关键步骤：拉取镜像 → 编写含proxy配置的docker-compose.yml → 启动 → 在浏览器或系统中手动设置HTTP代理；
不涉及跨境平台对接、支付、物流等业务逻辑，纯属本地开发调试场景，无资质/合规/费用问题。

它能解决哪些问题

场景痛点：调试跨境API（如Shopify Admin API、Amazon SP-API）时无法查看明文请求/响应；对应价值：OpenClaw可拦截并解密HTTPS流量（需安装根证书），还原真实请求头、Body与状态码；
场景痛点：多环境（本地/测试/预发）共用一套Mock规则难统一；对应价值：通过OpenClaw的Rules功能动态重写请求路径或Header，实现类目/店铺ID等参数的快速切换；
场景痛点：ERP或选品工具调用第三方接口失败但日志不全；对应价值：将工具流量导向OpenClaw代理，实时捕获完整交互链路，定位超时、重定向或认证失败根因。

怎么用：在Docker Compose中设置OpenClaw代理（实操步骤）

以下基于官方GitHub仓库 openclaw/openclaw v0.12.0+ 版本验证，适用于Mac/Linux/Windows WSL环境：

确认前提：已安装Docker Engine（≥24.0）与Docker Compose（v2.20+）；
创建项目目录：新建文件夹如 ~/openclaw-proxy，进入该目录；

编写 docker-compose.yml（关键字段已加注释）：

version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw:latest
    ports:
      - "8080:8080"          # 必须暴露代理端口
      - "8081:8081"          # Web UI端口（可选）
    environment:
      - OPENCLAW_PROXY_ENABLED=true     # 启用代理模式（必需）
      - OPENCLAW_PROXY_PORT=8080      # 代理监听端口（与ports一致）
      - OPENCLAW_WEB_PORT=8081        # Web界面端口
    volumes:
      - ./certs:/app/certs             # 挂载证书目录（首次启动自动生成）
    restart: unless-stopped

启动服务：终端执行 docker compose up -d；等待约10秒，访问 http://localhost:8081 确认UI正常加载；
安装根证书：点击UI右上角「Settings」→「Install Certificate」→ 下载 openclaw-ca.crt → 双击安装至系统钥匙串（macOS）或受信任根证书颁发机构（Windows）；
配置客户端代理：在系统网络设置或浏览器扩展中，将HTTP/HTTPS代理设为 127.0.0.1:8080；若调试Node.js脚本，可设置环境变量：export HTTP_PROXY=http://127.0.0.1:8080。

常见坑与避坑清单

证书未信任导致HTTPS流量空白：必须手动安装并标记为「始终信任」（macOS需在钥匙串中双击证书→展开「信任」→选择「始终信任」）；
代理端口被占用或未暴露：检查 docker-compose.yml 中 ports 是否包含 8080:8080，且宿主机无其他进程占用8080；
无法捕获Chrome/Firefox HTTPS请求：浏览器需关闭「使用系统代理设置」，改用插件（如SwitchyOmega）或命令行启动（chrome --proxy-server="127.0.0.1:8080"）；
容器内时间不同步致证书失效：在 docker-compose.yml 的service下添加 environment: - TZ=Asia/Shanghai 并挂载主机时间：volumes: - /etc/localtime:/etc/localtime:ro。