1. 为什么要在 Windows 上折腾 OpenClaw 本地部署OpenClaw 这个被社区叫成「小龙虾 AI」的开源项目本质是一个可自托管的 AI 网关与技能编排服务它把模型调用、技能插件、会话管理、Web 面板打包成一个本地服务默认监听 18789 端口你可以在浏览器里像用聊天工具一样跟它对话也能让它调用本地脚本、读写文件、跑定时任务。适合谁适合想把 AI 能力留在自己机器上、又不想被某个云端账号绑死的人比如做自动化脚本的开发者、想给团队搭内部助手的运维、以及单纯想研究 Agent 编排的学生。但 Windows 用户第一次上手几乎都会卡在同一处OpenClaw 的官方运行路径是 Linux 语义原生 CMD 和 PowerShell 跑不起来必须走 WSL2。我见过太多人直接在 PowerShell 里npm install -g openclaw装完openclaw doctor报一堆路径和权限错误然后以为项目坏了。其实不是项目的问题是运行环境选错了。这篇就聚焦一条完整链路Windows 下用 WSL2 装 Ubuntu在里面准备 Docker 与 Node.js 22用 Docker Compose 或 npm 两种方式把 OpenClaw 跑起来最后通过 TaoToken 的统一 Key 与 API 通道接入模型服务并用一次真实请求验证服务确实可用。全程给可复制的配置片段和逐步验证动作你照着敲就能跑通。2. 前置准备WSL2、Docker 与 Node.js 22 环境2.1 开启 WSL2 并安装 Ubuntu以管理员身份打开 PowerShell执行wsl --install这条命令会开启虚拟机平台、安装 WSL2 内核并默认拉取 Ubuntu。执行完重启电脑首次进入 Ubuntu 会让你设置用户名和密码。装完确认版本wsl --list --verbose输出里VERSION列必须是2。如果是1用wsl --set-version Ubuntu 2升级。这一步别跳过WSL1 的网络栈和 Docker 兼容性都不行。2.2 在 Ubuntu 里装基础依赖进入 Ubuntu 终端先更新源并装 Git 与 curlsudo apt update sudo apt install -y git curl2.3 用 nvm 固定 Node.js 22 LTSOpenClaw 对 Node 版本敏感官方要求 22.x LTS。用 nvm 管理最省心curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 nvm alias default 22 node -vnode -v输出v22.x.x才算成功。顺手把 npm 镜像换成国内源后面装依赖会快很多npm config set registry https://registry.npmmirror.com2.4 Docker 的两种选择如果你打算用 Docker 方式部署在 WSL2 里装 Docker Engine 即可不必装 Docker Desktopcurl -fsSL https://get.docker.com | sudo sh sudo usermod -aG docker $USER执行完退出终端重新进入让用户组生效然后docker ps不报权限错误就对了。Docker Desktop 也能用但会多一层 Windows 侧的转发排查网络问题时变量更多我倾向直接在 WSL2 里装 Engine。3. TaoToken 前置拿到统一 Key 与 API 通道OpenClaw 初始化时会让你填模型厂商和 API Key。如果你同时想用多个模型逐个厂商申请 Key、逐个填配置会很乱。TaoToken 在这里的作用是提供一个统一的 API 通道你只拿一个 Key把请求指向同一个 Base URL后面换模型只改模型名不用动鉴权配置。具体操作打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。创建后立刻复制保存页面刷新后不再完整显示。接入时你会用到两个值配置项值Base URLhttps://taotoken.net/apiAPI Key控制台创建的sk-开头字符串模型名按需填如gpt-4o-mini、claude-3-5-sonnet等注意Base URL 填https://taotoken.net/api不要在后面手动加/v1OpenClaw 的 OpenAI 兼容层会自己拼接路径多写一段会 404。想先确认 Key 能用可以在浏览器打开模型对话页 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一条消息能正常回复说明 Key 和通道都没问题再去配 OpenClaw 就少一个排查变量。4. 可复制配置Docker Compose 与 settings.json 骨架4.1 Docker Compose 方式在 WSL2 的家目录建一个工作目录mkdir -p ~/openclaw cd ~/openclaw新建docker-compose.ymlversion: 3 services: openclaw: image: ghcr.io/openclaw/openclaw:latest container_name: openclaw ports: - 18789:18789 volumes: - ./.openclaw:/root/.openclaw environment: - OPENCLAW_API_BASEhttps://taotoken.net/api - OPENCLAW_API_KEYsk-你的Key extra_hosts: - host.docker.internal:host-gateway restart: always启动docker compose up -d docker logs -f openclaw日志里出现gateway listening on 18789就说明服务起来了。extra_hosts那行是为了让容器内能通过host.docker.internal访问宿主机上的 Ollama如果你只用云端模型可以留着不影响。4.2 settings.json 骨架OpenClaw 的主配置在~/.openclaw/settings.json。Docker 方式下它映射到宿主机的./.openclaw/settings.json。一个最小可用骨架{ gateway: { host: 0.0.0.0, port: 18789, token: 自动生成的管理员Token }, model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, model: gpt-4o-mini, temperature: 0.7, maxTokens: 2048 }, skills: { enabled: [koluhab] } }provider填openai-compatible是关键TaoToken 的通道兼容 OpenAI 协议这样 OpenClaw 会用标准/chat/completions路径发请求。token字段首次openclaw onboard会自动生成别手动乱填否则网页登录会失败。4.3 config.toml 骨架可选部分版本支持 TOML 配置等价写法[gateway] host 0.0.0.0 port 18789 [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的Key model gpt-4o-mini temperature 0.7两种格式二选一同时存在时以settings.json为准别两个都改容易自己绕晕。5. 验证请求确认服务真的通了5.1 容器内初始化如果还没生成 Token进容器跑一次向导docker exec -it openclaw bash openclaw onboard向导里网关选 Local Gateway端口默认 18789模型选 OpenAI CompatibleBase URL 填https://taotoken.net/api粘贴 Key模型名填gpt-4o-mini。走完会打印管理员 Token复制下来。5.2 用 curl 直接打一次模型接口在 WSL2 终端里执行验证 TaoToken 通道本身可用curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: 只回复两个字通了}] }返回 JSON 里choices[0].message.content是「通了」说明 Key、Base URL、模型名三者都对。5.3 验证 OpenClaw 网关curl http://localhost:18789/health返回{status:ok}表示网关活着。再打开浏览器访问http://localhost:18789粘贴管理员 Token 登录在对话框里发一条消息。如果回复正常整条链路——WSL2 → Docker → OpenClaw → TaoToken → 模型——就全部打通了。5.4 npm 方式的验证差异如果你走的是 npm 全局安装而非 Dockernpm install -g openclawlatest openclaw --version openclaw doctor openclaw gateway start -d openclaw gateway statusopenclaw doctor会自检 Node 版本、配置文件和端口占用报错信息比 Docker 日志更直白适合第一次排查。启动后用同样的curl http://localhost:18789/health验证。6. 本篇常见错排查Node 版本不对openclaw doctor报unsupported node version用nvm use 22切过去别用系统自带的 Node 18。18789 端口被占docker compose up报port is already allocated改 compose 里的映射为18790:18789同时把settings.json的gateway.port改成 18790两处必须一致。容器内连不上 Ollama报connection refused检查 compose 里有没有extra_hosts并把 Ollama 地址写成http://host.docker.internal:11434不要写127.0.0.1容器里的 127.0.0.1 是容器自己。TaoToken 请求 401Key 复制时带了空格或者用了已删除的 Key。去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 重新生成一个。请求 404Base URL 写成了https://taotoken.net/api/v1去掉/v1。网页打不开确认是在 WSL2 Ubuntu 里跑的服务不是 PowerShell。Windows 侧访问localhost:18789通常能通因为 WSL2 有端口转发如果不行用wsl hostname -I拿到 WSL2 的 IP用那个 IP 访问。依赖下载超时npm 换镜像npm config set registry https://registry.npmmirror.comDocker 拉镜像慢可以配镜像加速器。权限不足Ubuntu 里命令前加sudoDocker 相关确认已加入 docker 组并重新登录终端。7. 后续接入与长期使用建议跑通之后如果你只是偶尔对话验证模型直接用模型对话页最省事https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你打算把 OpenClaw 当长期编码助手或 Agent 底座频繁调用、需要稳定配额和更低单价建议看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节和参数说明在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你用 Claude Code 这类工具Anthropic 兼容通道的配置也在同一份文档里。最后给一个我踩过的坑settings.json改完一定要docker compose restart openclawOpenClaw 不会热加载模型配置改完不重启你会以为 Key 填错了其实是旧配置还在内存里。
1. 为什么要在 Windows 上折腾 OpenClaw 本地部署OpenClaw 这个被社区叫成「小龙虾 AI」的开源项目本质是一个可自托管的 AI 网关与技能编排服务它把模型调用、技能插件、会话管理、Web 面板打包成一个本地服务默认监听 18789 端口你可以在浏览器里像用聊天工具一样跟它对话也能让它调用本地脚本、读写文件、跑定时任务。适合谁适合想把 AI 能力留在自己机器上、又不想被某个云端账号绑死的人比如做自动化脚本的开发者、想给团队搭内部助手的运维、以及单纯想研究 Agent 编排的学生。但 Windows 用户第一次上手几乎都会卡在同一处OpenClaw 的官方运行路径是 Linux 语义原生 CMD 和 PowerShell 跑不起来必须走 WSL2。我见过太多人直接在 PowerShell 里npm install -g openclaw装完openclaw doctor报一堆路径和权限错误然后以为项目坏了。其实不是项目的问题是运行环境选错了。这篇就聚焦一条完整链路Windows 下用 WSL2 装 Ubuntu在里面准备 Docker 与 Node.js 22用 Docker Compose 或 npm 两种方式把 OpenClaw 跑起来最后通过 TaoToken 的统一 Key 与 API 通道接入模型服务并用一次真实请求验证服务确实可用。全程给可复制的配置片段和逐步验证动作你照着敲就能跑通。2. 前置准备WSL2、Docker 与 Node.js 22 环境2.1 开启 WSL2 并安装 Ubuntu以管理员身份打开 PowerShell执行wsl --install这条命令会开启虚拟机平台、安装 WSL2 内核并默认拉取 Ubuntu。执行完重启电脑首次进入 Ubuntu 会让你设置用户名和密码。装完确认版本wsl --list --verbose输出里VERSION列必须是2。如果是1用wsl --set-version Ubuntu 2升级。这一步别跳过WSL1 的网络栈和 Docker 兼容性都不行。2.2 在 Ubuntu 里装基础依赖进入 Ubuntu 终端先更新源并装 Git 与 curlsudo apt update sudo apt install -y git curl2.3 用 nvm 固定 Node.js 22 LTSOpenClaw 对 Node 版本敏感官方要求 22.x LTS。用 nvm 管理最省心curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 nvm alias default 22 node -vnode -v输出v22.x.x才算成功。顺手把 npm 镜像换成国内源后面装依赖会快很多npm config set registry https://registry.npmmirror.com2.4 Docker 的两种选择如果你打算用 Docker 方式部署在 WSL2 里装 Docker Engine 即可不必装 Docker Desktopcurl -fsSL https://get.docker.com | sudo sh sudo usermod -aG docker $USER执行完退出终端重新进入让用户组生效然后docker ps不报权限错误就对了。Docker Desktop 也能用但会多一层 Windows 侧的转发排查网络问题时变量更多我倾向直接在 WSL2 里装 Engine。3. TaoToken 前置拿到统一 Key 与 API 通道OpenClaw 初始化时会让你填模型厂商和 API Key。如果你同时想用多个模型逐个厂商申请 Key、逐个填配置会很乱。TaoToken 在这里的作用是提供一个统一的 API 通道你只拿一个 Key把请求指向同一个 Base URL后面换模型只改模型名不用动鉴权配置。具体操作打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。创建后立刻复制保存页面刷新后不再完整显示。接入时你会用到两个值配置项值Base URLhttps://taotoken.net/apiAPI Key控制台创建的sk-开头字符串模型名按需填如gpt-4o-mini、claude-3-5-sonnet等注意Base URL 填https://taotoken.net/api不要在后面手动加/v1OpenClaw 的 OpenAI 兼容层会自己拼接路径多写一段会 404。想先确认 Key 能用可以在浏览器打开模型对话页 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一条消息能正常回复说明 Key 和通道都没问题再去配 OpenClaw 就少一个排查变量。4. 可复制配置Docker Compose 与 settings.json 骨架4.1 Docker Compose 方式在 WSL2 的家目录建一个工作目录mkdir -p ~/openclaw cd ~/openclaw新建docker-compose.ymlversion: 3 services: openclaw: image: ghcr.io/openclaw/openclaw:latest container_name: openclaw ports: - 18789:18789 volumes: - ./.openclaw:/root/.openclaw environment: - OPENCLAW_API_BASEhttps://taotoken.net/api - OPENCLAW_API_KEYsk-你的Key extra_hosts: - host.docker.internal:host-gateway restart: always启动docker compose up -d docker logs -f openclaw日志里出现gateway listening on 18789就说明服务起来了。extra_hosts那行是为了让容器内能通过host.docker.internal访问宿主机上的 Ollama如果你只用云端模型可以留着不影响。4.2 settings.json 骨架OpenClaw 的主配置在~/.openclaw/settings.json。Docker 方式下它映射到宿主机的./.openclaw/settings.json。一个最小可用骨架{ gateway: { host: 0.0.0.0, port: 18789, token: 自动生成的管理员Token }, model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, model: gpt-4o-mini, temperature: 0.7, maxTokens: 2048 }, skills: { enabled: [koluhab] } }provider填openai-compatible是关键TaoToken 的通道兼容 OpenAI 协议这样 OpenClaw 会用标准/chat/completions路径发请求。token字段首次openclaw onboard会自动生成别手动乱填否则网页登录会失败。4.3 config.toml 骨架可选部分版本支持 TOML 配置等价写法[gateway] host 0.0.0.0 port 18789 [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的Key model gpt-4o-mini temperature 0.7两种格式二选一同时存在时以settings.json为准别两个都改容易自己绕晕。5. 验证请求确认服务真的通了5.1 容器内初始化如果还没生成 Token进容器跑一次向导docker exec -it openclaw bash openclaw onboard向导里网关选 Local Gateway端口默认 18789模型选 OpenAI CompatibleBase URL 填https://taotoken.net/api粘贴 Key模型名填gpt-4o-mini。走完会打印管理员 Token复制下来。5.2 用 curl 直接打一次模型接口在 WSL2 终端里执行验证 TaoToken 通道本身可用curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: 只回复两个字通了}] }返回 JSON 里choices[0].message.content是「通了」说明 Key、Base URL、模型名三者都对。5.3 验证 OpenClaw 网关curl http://localhost:18789/health返回{status:ok}表示网关活着。再打开浏览器访问http://localhost:18789粘贴管理员 Token 登录在对话框里发一条消息。如果回复正常整条链路——WSL2 → Docker → OpenClaw → TaoToken → 模型——就全部打通了。5.4 npm 方式的验证差异如果你走的是 npm 全局安装而非 Dockernpm install -g openclawlatest openclaw --version openclaw doctor openclaw gateway start -d openclaw gateway statusopenclaw doctor会自检 Node 版本、配置文件和端口占用报错信息比 Docker 日志更直白适合第一次排查。启动后用同样的curl http://localhost:18789/health验证。6. 本篇常见错排查Node 版本不对openclaw doctor报unsupported node version用nvm use 22切过去别用系统自带的 Node 18。18789 端口被占docker compose up报port is already allocated改 compose 里的映射为18790:18789同时把settings.json的gateway.port改成 18790两处必须一致。容器内连不上 Ollama报connection refused检查 compose 里有没有extra_hosts并把 Ollama 地址写成http://host.docker.internal:11434不要写127.0.0.1容器里的 127.0.0.1 是容器自己。TaoToken 请求 401Key 复制时带了空格或者用了已删除的 Key。去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 重新生成一个。请求 404Base URL 写成了https://taotoken.net/api/v1去掉/v1。网页打不开确认是在 WSL2 Ubuntu 里跑的服务不是 PowerShell。Windows 侧访问localhost:18789通常能通因为 WSL2 有端口转发如果不行用wsl hostname -I拿到 WSL2 的 IP用那个 IP 访问。依赖下载超时npm 换镜像npm config set registry https://registry.npmmirror.comDocker 拉镜像慢可以配镜像加速器。权限不足Ubuntu 里命令前加sudoDocker 相关确认已加入 docker 组并重新登录终端。7. 后续接入与长期使用建议跑通之后如果你只是偶尔对话验证模型直接用模型对话页最省事https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你打算把 OpenClaw 当长期编码助手或 Agent 底座频繁调用、需要稳定配额和更低单价建议看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节和参数说明在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你用 Claude Code 这类工具Anthropic 兼容通道的配置也在同一份文档里。最后给一个我踩过的坑settings.json改完一定要docker compose restart openclawOpenClaw 不会热加载模型配置改完不重启你会以为 Key 填错了其实是旧配置还在内存里。
