1. 为什么要在 Windows 上用 Docker 跑 OpenClawOpenClaw 是一个把大模型和自动化执行绑在一起的 AI Agent 框架你可以把它理解成「能自己动手干活的 AI 助手」它既能接 DeepSeek 这类大模型做推理又能通过插件把消息通道接到 QQ、微信上还能在本地执行脚本、读写文件、跑定时任务。对开发者来说它比单纯的聊天窗口多了「执行层」比纯自动化脚本又多了「理解层」。但 OpenClaw 官方主要面向 Linux 环境Windows 直接装 Node 依赖经常遇到编译工具链、路径分隔符、权限模型三座大山。我试过在 Windows 裸机装卡在 node-gyp 编译那一步半小时没动。后来换成 Docker Desktop Ubuntu 容器环境隔离干净删了重建也就一条命令迁移和备份都省心。这篇面向想在 Windows 本地快速搭一个可用 AI 助手的开发者交付一条完整落地路径Docker 部署 OpenClaw、接入 DeepSeek、打通 QQ/微信通道、验证连通性。全程命令可复制配置片段可直接改。如果你只想先跑通模型对话也可以先用 TaoToken 的统一通道把 Key 配好再回来接通道。2. 前置准备TaoToken 统一 Key 与 API 通道OpenClaw 的模型配置里有一个「Custom Provider」入口本质就是填一个 OpenAI 兼容的 Base URL 和 API Key。与其在 DeepSeek、其他模型之间来回换 Key、改配置不如用一个统一通道把 Key 管起来后面换模型只改 Model ID 就行。TaoToken 提供的就是这样一个统一入口一个 Key 走 OpenAI 兼容协议模型对话、编码类模型都能接。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台生成 API Key。具体操作路径打开控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 登录后进入 API Keys 页面新建一个 Key复制保存后面填进 OpenClaw 配置接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 里面有 Base URL 和兼容性说明注意API 地址是 https://taotoken.net/api 配置时不要带 UTM 参数否则部分客户端会把它当成路径的一部分导致 404。如果你后面要长期跑编码类 Agent 任务可以了解下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 按用量规划比单次调用更划算。想先验证模型通不通直接用模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 发一条消息即可。3. 可复制配置docker-compose 骨架与 OpenClaw 安装3.1 环境确认Windows 10/11 专业版或家庭版均可装好 Docker Desktop 并切换到 Linux 容器模式。在 PowerShell 里确认docker version docker compose version两条都能输出版本号即可。如果docker compose报错说明 Docker Desktop 版本偏旧升级一下。3.2 docker-compose.yml 骨架在C:\openclaw\下新建docker-compose.yml内容如下。这里用 Ubuntu 22.04 作为基础镜像挂载数据目录实现持久化端口只绑本机回环避免暴露到局域网。services: openclaw: image: ubuntu:22.04 container_name: openclaw init: true restart: unless-stopped ports: - 127.0.0.1:18789:18789 volumes: - C:\openclaw\data:/root/.openclaw command: sleep infinity启动容器cd C:\openclaw docker compose up -d docker exec -it openclaw /bin/bash3.3 容器内装基础环境进入容器后先换国内源加速再装依赖。ffmpeg 是部分插件的硬依赖不装后面接通道可能报错。sed -i s/archive.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list apt update apt install -y curl git ffmpeg curl -fsSL https://deb.nodesource.com/setup_24.x | bash - apt install -y nodejs node -vnode -v输出 v24.x 即成功。3.4 安装 OpenClawnpm install -g openclawlatest openclaw --version3.5 配置模型通道运行引导openclaw onboard关键选项按下面填其余回车默认配置项填写值Setup modeManualModel/auth providerCustom ProviderProvider API Base URLhttps://taotoken.net/apiAPI Key你在 TaoToken 控制台生成的 KeyEndpoint compatibilityOpenAI-compatibleModel ID按接入文档填对应模型名Gateway port18789Gateway bindLAN (0.0.0.0)Gateway authToken引导结束会提示 Verification successful说明模型通道已通。如果这一步失败先回到第 5 节排查。4. 验证请求WebUI 配对与 QQ/微信连通性4.1 启动网关并拿到登录链接openclaw gateway另开一个 PowerShell 窗口进容器docker exec -it openclaw /bin/bash openclaw dashboard会输出形如http://localhost:18789/#tokenxxxx的链接复制到宿主机浏览器打开。4.2 设备配对首次打开会显示 pairing required。在容器里查看待批准请求openclaw devices list拿到 Request ID 后批准openclaw devices approve 你的RequestID刷新浏览器即可进入 WebUI。4.3 接入 QQ 通道在 QQBot 官网申请机器人拿到 Token然后在容器内执行openclaw plugins install tencent-connect/openclaw-qqbotlatest openclaw channels add --channel qqbot --token 你的token4.4 接入微信通道npx -y tencent-weixin/openclaw-weixin-clilatest install执行后会弹出二维码用微信扫码登录。实测当前版本私聊正常群聊暂不支持。4.5 重启并验证pkill openclaw pkill openclaw-gateway openclaw gateway在 QQ 或微信里给机器人发一条「你好」能收到模型回复即打通。WebUI 里也能看到对应会话记录。5. 本篇常见错排查报错一openclaw: command not found容器重建后全局包丢失。因为 npm 全局目录在容器层不在挂载卷里。解决把安装命令写进 Dockerfile 或启动脚本重建后自动执行。报错二模型验证失败返回 401Key 填错或 Base URL 带了多余路径。确认 Base URL 是https://taotoken.net/api不要带 UTM 参数Key 前后不要有空格。报错三WebUI 打开一直 pairing requiredopenclaw devices approve用的 Request ID 过期了。重新openclaw devices list拿最新 ID 再批准。报错四QQ 通道装完不回复插件装完必须重启 gatewaypkill后确认进程真的退出再启动。另外检查 Token 是否复制完整。报错五微信扫码后无响应npx拉取的 CLI 版本和 OpenClaw 主版本不匹配。先openclaw --version记下版本再按官方插件页选对应 CLI 版本。报错六容器重启后配置全丢挂载路径写错。确认docker-compose.yml里C:\openclaw\data映射到/root/.openclaw且宿主机目录存在。6. 后续怎么用从跑通到长期可用跑通只是起点。接下来你可以在 WebUI 里给 Agent 写自定义指令让它按「先提方案、等确认、再执行」的流程干活避免它自作主张。模型侧如果要从 DeepSeek 换成别的只改 Model ID 即可Base URL 和 Key 不用动这就是统一通道省事的地方。长期跑编码类或自动化任务的话建议把 Coding Plan 用起来按用量规划比零散调用更可控。接入过程中遇到通道配置问题优先翻接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 大部分报错在里面有对应说明。Key 管理统一在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 操作换 Key 不用改容器配置改完重启 gateway 就生效。
Windows 下用 Docker 部署 OpenClaw：接入 DeepSeek + QQ/微信，全流程实战
1. 为什么要在 Windows 上用 Docker 跑 OpenClawOpenClaw 是一个把大模型和自动化执行绑在一起的 AI Agent 框架你可以把它理解成「能自己动手干活的 AI 助手」它既能接 DeepSeek 这类大模型做推理又能通过插件把消息通道接到 QQ、微信上还能在本地执行脚本、读写文件、跑定时任务。对开发者来说它比单纯的聊天窗口多了「执行层」比纯自动化脚本又多了「理解层」。但 OpenClaw 官方主要面向 Linux 环境Windows 直接装 Node 依赖经常遇到编译工具链、路径分隔符、权限模型三座大山。我试过在 Windows 裸机装卡在 node-gyp 编译那一步半小时没动。后来换成 Docker Desktop Ubuntu 容器环境隔离干净删了重建也就一条命令迁移和备份都省心。这篇面向想在 Windows 本地快速搭一个可用 AI 助手的开发者交付一条完整落地路径Docker 部署 OpenClaw、接入 DeepSeek、打通 QQ/微信通道、验证连通性。全程命令可复制配置片段可直接改。如果你只想先跑通模型对话也可以先用 TaoToken 的统一通道把 Key 配好再回来接通道。2. 前置准备TaoToken 统一 Key 与 API 通道OpenClaw 的模型配置里有一个「Custom Provider」入口本质就是填一个 OpenAI 兼容的 Base URL 和 API Key。与其在 DeepSeek、其他模型之间来回换 Key、改配置不如用一个统一通道把 Key 管起来后面换模型只改 Model ID 就行。TaoToken 提供的就是这样一个统一入口一个 Key 走 OpenAI 兼容协议模型对话、编码类模型都能接。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台生成 API Key。具体操作路径打开控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 登录后进入 API Keys 页面新建一个 Key复制保存后面填进 OpenClaw 配置接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 里面有 Base URL 和兼容性说明注意API 地址是 https://taotoken.net/api 配置时不要带 UTM 参数否则部分客户端会把它当成路径的一部分导致 404。如果你后面要长期跑编码类 Agent 任务可以了解下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 按用量规划比单次调用更划算。想先验证模型通不通直接用模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 发一条消息即可。3. 可复制配置docker-compose 骨架与 OpenClaw 安装3.1 环境确认Windows 10/11 专业版或家庭版均可装好 Docker Desktop 并切换到 Linux 容器模式。在 PowerShell 里确认docker version docker compose version两条都能输出版本号即可。如果docker compose报错说明 Docker Desktop 版本偏旧升级一下。3.2 docker-compose.yml 骨架在C:\openclaw\下新建docker-compose.yml内容如下。这里用 Ubuntu 22.04 作为基础镜像挂载数据目录实现持久化端口只绑本机回环避免暴露到局域网。services: openclaw: image: ubuntu:22.04 container_name: openclaw init: true restart: unless-stopped ports: - 127.0.0.1:18789:18789 volumes: - C:\openclaw\data:/root/.openclaw command: sleep infinity启动容器cd C:\openclaw docker compose up -d docker exec -it openclaw /bin/bash3.3 容器内装基础环境进入容器后先换国内源加速再装依赖。ffmpeg 是部分插件的硬依赖不装后面接通道可能报错。sed -i s/archive.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list apt update apt install -y curl git ffmpeg curl -fsSL https://deb.nodesource.com/setup_24.x | bash - apt install -y nodejs node -vnode -v输出 v24.x 即成功。3.4 安装 OpenClawnpm install -g openclawlatest openclaw --version3.5 配置模型通道运行引导openclaw onboard关键选项按下面填其余回车默认配置项填写值Setup modeManualModel/auth providerCustom ProviderProvider API Base URLhttps://taotoken.net/apiAPI Key你在 TaoToken 控制台生成的 KeyEndpoint compatibilityOpenAI-compatibleModel ID按接入文档填对应模型名Gateway port18789Gateway bindLAN (0.0.0.0)Gateway authToken引导结束会提示 Verification successful说明模型通道已通。如果这一步失败先回到第 5 节排查。4. 验证请求WebUI 配对与 QQ/微信连通性4.1 启动网关并拿到登录链接openclaw gateway另开一个 PowerShell 窗口进容器docker exec -it openclaw /bin/bash openclaw dashboard会输出形如http://localhost:18789/#tokenxxxx的链接复制到宿主机浏览器打开。4.2 设备配对首次打开会显示 pairing required。在容器里查看待批准请求openclaw devices list拿到 Request ID 后批准openclaw devices approve 你的RequestID刷新浏览器即可进入 WebUI。4.3 接入 QQ 通道在 QQBot 官网申请机器人拿到 Token然后在容器内执行openclaw plugins install tencent-connect/openclaw-qqbotlatest openclaw channels add --channel qqbot --token 你的token4.4 接入微信通道npx -y tencent-weixin/openclaw-weixin-clilatest install执行后会弹出二维码用微信扫码登录。实测当前版本私聊正常群聊暂不支持。4.5 重启并验证pkill openclaw pkill openclaw-gateway openclaw gateway在 QQ 或微信里给机器人发一条「你好」能收到模型回复即打通。WebUI 里也能看到对应会话记录。5. 本篇常见错排查报错一openclaw: command not found容器重建后全局包丢失。因为 npm 全局目录在容器层不在挂载卷里。解决把安装命令写进 Dockerfile 或启动脚本重建后自动执行。报错二模型验证失败返回 401Key 填错或 Base URL 带了多余路径。确认 Base URL 是https://taotoken.net/api不要带 UTM 参数Key 前后不要有空格。报错三WebUI 打开一直 pairing requiredopenclaw devices approve用的 Request ID 过期了。重新openclaw devices list拿最新 ID 再批准。报错四QQ 通道装完不回复插件装完必须重启 gatewaypkill后确认进程真的退出再启动。另外检查 Token 是否复制完整。报错五微信扫码后无响应npx拉取的 CLI 版本和 OpenClaw 主版本不匹配。先openclaw --version记下版本再按官方插件页选对应 CLI 版本。报错六容器重启后配置全丢挂载路径写错。确认docker-compose.yml里C:\openclaw\data映射到/root/.openclaw且宿主机目录存在。6. 后续怎么用从跑通到长期可用跑通只是起点。接下来你可以在 WebUI 里给 Agent 写自定义指令让它按「先提方案、等确认、再执行」的流程干活避免它自作主张。模型侧如果要从 DeepSeek 换成别的只改 Model ID 即可Base URL 和 Key 不用动这就是统一通道省事的地方。长期跑编码类或自动化任务的话建议把 Coding Plan 用起来按用量规划比零散调用更可控。接入过程中遇到通道配置问题优先翻接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 大部分报错在里面有对应说明。Key 管理统一在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 操作换 Key 不用改容器配置改完重启 gateway 就生效。
