1. Windows 本机 Docker 跑 OpenClaw 到底卡在哪OpenClaw 是一个可以本地自托管的 AI Agent 网关它能把你常用的模型服务统一收口到一个入口再通过控制台、命令行或 API 对外提供对话与工具调用能力。适合谁适合那些不想把对话记录和密钥散落在各种客户端里、希望在自己 Windows 机器上用 Docker 跑一套可控环境的开发者。核心检索词就是 OpenClaw Windows Docker 部署这篇就围绕这条路径把每一步写实。很多人第一次在 Windows 上折腾 OpenClaw卡点往往不在 OpenClaw 本身而在三件事Docker Desktop 的 WSL2 后端没就绪、容器里外路径映射写错、以及模型接入的 Base URL 和 Key 填错位置。前两个是环境问题第三个是配置问题。环境问题报错很直白配置问题则经常表现为容器起来了、端口也监听了但一发请求就 401 或者 reading choices 报错。我试过在一台 Win10 22H2 的机器上从零走一遍最大的感受是只要把 docker-compose 和 .env 两个文件写对后面基本就是复制粘贴。真正容易翻车的是把 API Key 直接写进 compose 的 environment 里改一次要重建容器很烦。更稳的做法是统一放到 .envcompose 只做引用。这篇的路线是先确认 Docker Desktop 可用再准备目录和配置文件然后用 docker-compose 起容器接着把 TaoToken 的统一 Key 和 API 通道填进 OpenClaw 的 provider 配置最后做一次健康检查和一次真实对话请求验证。全程命令都可以直接复制路径按 Windows 的习惯写。需要提前说明一点下面所有涉及模型接入的地方Base URL 都指向 TaoToken 的 API 通道https://taotoken.net/apiKey 用你在控制台生成的统一 Key。这样你换模型时不用改一堆客户端只改 OpenClaw 里的 model 字段就行。官网入口放在这里方便你对照https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。2. 前置准备Docker Desktop 与 TaoToken 统一 Key2.1 确认 Docker Desktop 后端就绪Windows 上跑 Linux 容器Docker Desktop 默认走 WSL2 后端。装完之后先在 PowerShell 里确认两件事Docker 引擎在跑以及 WSL2 版本正常。docker version wsl --statusdocker version能同时打印 Client 和 Server 两段信息说明引擎已经起来了。如果只有 Client 没有 Server多半是 Docker Desktop 没启动或者 WSL2 集成没开。wsl --status会显示默认发行版和内核版本内核版本过低时 Docker Desktop 会提示更新。接着确认 compose 插件可用。新版 Docker Desktop 自带docker compose注意是空格不是连字符的老版docker-compose。docker compose version输出类似Docker Compose version v2.x.x就没问题。如果提示找不到命令去 Docker Desktop 设置里确认 Compose 组件已启用。2.2 准备目录结构OpenClaw 容器内的工作目录是/home/node/.openclaw我们要把它映射到 Windows 用户目录下方便直接改配置文件。在 PowerShell 里建目录mkdir -Force $env:USERPROFILE\.openclaw mkdir -Force $env:USERPROFILE\.openclaw\data第一条建配置根目录第二条建一个数据子目录备用。映射之后容器里写的配置会落到C:\Users\你的用户名\.openclaw你用记事本或 VS Code 就能直接编辑不用进容器。2.3 拿 TaoToken 统一 Key打开控制台生成一个 API Key这个 Key 就是后面 .env 里的值。生成入口在 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。生成后先复制到记事本页面刷新后通常不再完整显示。这里要强调一个概念TaoToken 提供的是统一的 API 通道Base URL 固定为https://taotoken.net/api你拿到的 Key 可以调用通道里支持的多个模型。所以 OpenClaw 里只需要配一个 provider模型名按需切换不用为每个模型单独配一套 Key。想先看看通道里有哪些模型可选可以去模型对话页面点几下https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。如果你后面打算长期跑编码类 Agent 任务可以顺带了解 Coding Plan它更适合高频调用场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。接入细节和字段说明统一看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。3. 可复制配置docker-compose.yml 与 .env3.1 写 .env 文件在$env:USERPROFILE\.openclaw目录下新建.env文件内容如下。注意 Key 不要加引号等号两边不要有空格。# TaoToken 统一 Key TAOTOKEN_API_KEYsk-你的TaoToken密钥 # TaoToken API 通道地址 TAOTOKEN_BASE_URLhttps://taotoken.net/api # OpenClaw 默认模型按通道支持的模型名填写 OPENCLAW_DEFAULT_MODELgpt-4o-mini # 控制台访问端口 OPENCLAW_PORT18789这里TAOTOKEN_BASE_URL就是统一 API 通道地址后面会通过 compose 的 environment 传进容器再由 OpenClaw 的 provider 配置读取。模型名先填一个通道里确定支持的验证通了再换。3.2 写 docker-compose.yml在同一个目录下新建docker-compose.yml。这份配置做了四件事映射两个端口、挂载配置目录、注入环境变量、设置自动重启。services: openclaw: image: ghcr.io/openclaw/openclaw:latest container_name: openclaw restart: unless-stopped ports: - 18789:18789 - 1878:1878 volumes: - ${USERPROFILE}/.openclaw:/home/node/.openclaw environment: - OPENAI_API_KEY${TAOTOKEN_API_KEY} - OPENAI_BASE_URL${TAOTOKEN_BASE_URL} - OPENCLAW_DEFAULT_MODEL${OPENCLAW_DEFAULT_MODEL} healthcheck: test: [CMD, curl, -f, http://127.0.0.1:18789/] interval: 30s timeout: 5s retries: 3 start_period: 20s几个关键点解释一下。OPENAI_API_KEY和OPENAI_BASE_URL这两个环境变量名是 OpenClaw 兼容 OpenAI 协议时读取的我们把 TaoToken 的 Key 和通道地址喂进去容器启动后 OpenClaw 就能用这套凭据访问统一通道。volumes那行用了${USERPROFILE}在 Windows 的 Docker Desktop 里能正确展开成用户目录。注意如果你在 PowerShell 里直接跑docker compose${USERPROFILE}由 compose 解析如果你用的是 Git Bash环境变量名可能不同建议统一在 PowerShell 里操作。3.3 关于 provider 配置文件的写法OpenClaw 也支持在openclaw.json里显式声明 provider。如果你不想用环境变量可以在$env:USERPROFILE\.openclaw\openclaw.json里写{ providers: { taotoken: { apiKey: sk-你的TaoToken密钥, baseUrl: https://taotoken.net/api } }, agents: { defaults: { model: { primary: taotoken/gpt-4o-mini } } } }两种方式选一种即可不要同时配否则容易出现优先级混乱。用环境变量的好处是 Key 不进配置文件改 Key 只改 .env。用 JSON 的好处是模型和 provider 关系一目了然。我个人倾向环境变量管凭据、JSON 管模型路由分工清楚。4. 启动容器与验证一次真实对话4.1 启动并观察日志在docker-compose.yml所在目录打开 PowerShell执行docker compose up -d docker compose logs -f openclawup -d后台启动logs -f跟日志。第一次会拉镜像耐心等。看到类似gateway listening on 0.0.0.0:18789的输出说明服务起来了。按 CtrlC 退出日志跟踪容器不受影响。确认容器状态和端口监听docker compose ps netstat -an | findstr 18789docker compose ps的 STATUS 列显示Up ... (healthy)就说明健康检查也过了。netstat能看到 18789 处于 LISTENING。4.2 健康检查请求先做一次最基础的 HTTP 探测确认网关响应curl.exe -v http://127.0.0.1:18789/注意在 PowerShell 里curl是Invoke-WebRequest的别名参数不兼容所以显式写curl.exe。返回 200 或带 JSON 的响应体都算正常。如果连接被拒绝回到上一步看容器是否真的在跑。4.3 发一次对话请求验证模型通道这一步是重点验证 TaoToken 统一 Key 是否真的通了。OpenClaw 暴露了兼容 OpenAI 的接口我们直接打curl.exe -X POST http://127.0.0.1:18789/v1/chat/completions -H Content-Type: application/json -H Authorization: Bearer sk-你的TaoToken密钥 -d {\model\:\gpt-4o-mini\,\messages\:[{\role\:\user\,\content\:\用一句话说明你是什么\}]}如果返回里带choices数组和一段正常文本说明整条链路通了请求进 OpenClawOpenClaw 用配置的 Base URL 转发到 TaoToken 通道通道返回模型结果。这一步成功你的本地自托管环境就算落地了。想更直观地看对话效果也可以打开控制台页面http://127.0.0.1:18789/ 。控制台地址带 Token 时可以用命令获取docker exec openclaw openclaw dashboard --no-open它会打印一个带 Token 的完整 URL复制到浏览器即可。5. 常见报错排查401、local proxy failed 与 reading choices5.1 401 Unauthorized最常见。表现是请求返回{error:{message:...401...}}。原因通常是三类Key 复制时带了空格或换行、.env 里 Key 被引号包住导致值不对、或者容器没重新加载 .env。排查顺序先docker compose config看 compose 解析后的 environment 里 Key 长什么样确认没有多余字符。然后docker exec openclaw env | findstr OPENAI看容器内实际拿到的值。改完 .env 后必须docker compose up -d重建容器光 restart 不会重新读 .env。5.2 local proxy failed这个报错一般出现在容器内访问外部地址失败时。OpenClaw 容器要访问https://taotoken.net/api如果容器网络出不去就会报 local proxy failed 或连接超时。先在容器内测连通性docker exec -it openclaw sh -c curl -v https://taotoken.net/api如果这里就失败说明是容器网络问题检查 Docker Desktop 的网络设置确认没有把容器网络限制死。如果容器内能通、但 OpenClaw 转发失败那多半是 Base URL 写错了比如漏了/api或者多了斜杠。Base URL 必须是https://taotoken.net/api不要写成https://taotoken.net/api/v1路径拼接由 OpenClaw 处理。5.3 reading choices 报错reading choices这类报错本质是 OpenClaw 期望拿到 OpenAI 格式的响应但实际拿到的不是。常见原因是模型名填错通道返回了一个错误对象而不是正常的 completions 结构。排查先用 curl 直接打通道确认模型名有效再对照 OpenClaw 里配的 model 字段。如果你在 openclaw.json 里用了taotoken/模型名这种带前缀的写法确认前缀和 provider 名一致。另外注意 JSON 里不要写注释标准 JSON 不支持//带注释会导致解析失败进而 provider 没加载请求走到默认逻辑上就报 reading choices。5.4 端口占用与容器名冲突如果docker compose up -d报端口被占用先查是谁占了netstat -ano | findstr 18789拿到 PID 后用任务管理器结束或者改 .env 里的OPENCLAW_PORT换一个端口同时改 compose 的 ports 映射。容器名冲突则先docker rm -f openclaw再起。5.5 配置改了不生效OpenClaw 读的是/home/node/.openclaw/openclaw.json。你在 Windows 侧改的是映射目录里的文件改完要确认容器能看到docker exec -it openclaw cat /home/node/.openclaw/openclaw.json如果内容还是旧的检查映射路径是否写对。Windows 路径映射到 Linux 容器时注意盘符和大小写。用${USERPROFILE}展开通常没问题但如果你手动写了C:\Users\...在 compose 里要写成/c/Users/...或C:/Users/...这种形式。6. 把统一 Key 用顺后续接入与文档入口环境跑通之后日常使用其实就三件事改模型、看日志、按需重启。改模型只动 .env 里的OPENCLAW_DEFAULT_MODEL或 openclaw.json 里的 model 字段然后docker compose up -d。看日志用docker compose logs -f openclaw。重启用docker compose restart openclaw但记住改 .env 要 up 不要 restart。如果你后面要在别的客户端里也复用这套统一 Key比如命令行工具或编辑器插件Base URL 依然是https://taotoken.net/apiKey 还是同一个。这样你所有工具的模型接入都收口到一处换模型、查用量、管额度都方便。API Keys 管理入口https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。接入过程中遇到字段含义不清楚的直接翻文档最省事https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。文档里对 Base URL、鉴权头、模型名的写法都有说明比在报错里猜要快得多。最后留一个实用习惯把 .env 和 docker-compose.yml 一起放进一个 git 仓库管理但 .env 加进 .gitignore只提交一份 .env.example。这样换机器时 clone 下来改个 Key 就能跑也不会把密钥推到远端。容器重建、镜像升级这些操作配合docker compose pull docker compose up -d两条命令就能完成升级前先备份一下$env:USERPROFILE\.openclaw目录出问题能快速回滚。