1. Windows 上跑 OpenClaw 到底卡在哪：WSL2 与 PowerShell 的部署场景拆解
OpenClaw 是一个可以在本地运行的 AI 助手框架，它能读取你电脑上的文件、执行命令、调用大模型完成自动化任务，适合想把 AI 接入日常工作流的开发者。但它的原生运行环境是 Linux，Windows 用户直接跑会遇到一堆路径、权限、依赖问题。这篇教程聚焦 Windows 环境下用 WSL2 与 PowerShell 从零部署 OpenClaw 的完整路径，覆盖环境准备、依赖安装、配置校验与常见报错排查。
我自己在 Windows 11 上折腾了两轮才跑通，第一轮卡在 WSL2 没装好导致安装脚本报错，第二轮卡在模型接入的 Base URL 配置上。所以这篇会把这两个坑都讲清楚。
先说清楚整体思路。Windows 部署 OpenClaw 有两条路：一条是纯 PowerShell 原生安装，官方提供了一键脚本；另一条是先装 WSL2，在 Linux 子系统里跑。两条路都能走通，但 WSL2 的兼容性更好，尤其是涉及文件监听、进程守护、端口转发这些环节。我的建议是：即使你用 PowerShell 一键脚本，也先把 WSL2 启用，因为 OpenClaw 的 Gateway 守护进程在 WSL2 下更稳定。
适合谁看这篇：手上有 Windows 10/11 机器、想本地跑一个能读写文件、能调模型的 AI 助手、对命令行不排斥但不想被环境问题卡住的开发者。如果你只是想体验一下对话功能，其实用网页版就够了；但如果你想让 AI 真正操作你的本地文件、跑脚本、做自动化，那本地部署是绕不开的。
部署完成后你会得到什么：一个在localhost:18789上运行的网页面板，可以在里面和 OpenClaw 对话；一个 Gateway 守护进程在后台跑着；以及一套可以通过 TaoToken 统一 Key 接入多家模型的配置。下面从环境准备开始，一步步来。
2. TaoToken 统一 Key 接入 OpenClaw 的前置准备
在开始装 OpenClaw 之前，先把模型接入这块理清楚，因为配置向导走到一半卡在 API Key 上是最常见的翻车点。OpenClaw 支持一大堆模型提供商，但如果你每换一个模型就要去对应官网注册、充值、拿 Key，管理起来很麻烦。TaoToken 的思路是提供一个统一的 API 通道，你只需要一个 Key，就能切换不同模型。
TaoToken 是什么：它是一个模型 API 聚合服务，提供统一的 Base URL 和 API Key，兼容 OpenAI 风格的接口格式。对 OpenClaw 来说，你只需要在配置向导里选择 OpenAI 兼容模式，然后把 Base URL 填成 TaoToken 的地址，Key 填成你在 TaoToken 后台创建的 Key，就能接入。
适合谁用：手上已经有多个模型 Key、想统一管理的人；或者不想在每个模型官网单独注册充值、想一个 Key 走通的人。它的接口地址是https://taotoken.net/api，注意这个地址不带任何查询参数，直接填到 Base URL 字段里。
你需要提前准备的东西：一个 TaoToken 账号，登录后在控制台创建一个 API Key。创建 Key 的入口在控制台的 API Keys 页面，Key 只在创建时显示一次，务必复制保存。如果你还没注册，可以先访问官网了解。
这里要强调一点：TaoToken 是正规的 API 通道服务，不是那种来路不明的中转。你填的 Base URL 和 Key 都是走标准接口，OpenClaw 那边不需要做任何特殊处理。
模型选择上，OpenClaw 配置向导会列出可用的模型。通过 TaoToken 接入时，你可以在 TaoToken 支持的模型列表里选，比如 Claude 系列、GPT 系列、DeepSeek、MiniMax、Moonshot 这些。选哪个取决于你的用途：日常对话和文件操作，Claude Sonnet 系列性价比不错；纯中文场景，MiniMax 和 Moonshot 的中文能力强；预算敏感的话，DeepSeek 的 deepseek-chat 便宜且国内直连。
把 Key 准备好之后，再开始装 OpenClaw。这样配置向导走到模型那一步时，你直接填就行，不会卡住。
3. 可复制配置：PowerShell 安装 OpenClaw 与 WSL2 环境片段
这一节是核心操作部分，所有命令都可以直接复制。先装 WSL2，再用 PowerShell 一键脚本装 OpenClaw，最后配置模型接入。
3.1 启用 WSL2 环境
以管理员身份打开 PowerShell。按 Win 键搜索 PowerShell，右键选择「以管理员身份运行」。然后执行：
wsl --install这条命令会自动启用虚拟机平台、安装 WSL2 内核、下载 Ubuntu 发行版。执行完重启电脑。重启后打开 Ubuntu，设置用户名和密码。
验证 WSL2 是否装好：
wsl --list --verbose看到 VERSION 列显示 2 就对了。如果显示 1，执行wsl --set-default-version 2切换。
3.2 解除 PowerShell 脚本执行限制
Windows 默认禁止运行未签名的脚本，OpenClaw 的安装脚本会被拦。执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 确认。这条只影响当前用户，不会动系统级策略。
3.3 执行 OpenClaw 安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex脚本会自动下载 OpenClaw 并进入交互式配置向导。如果中途跳过了向导，后面可以用openclaw onboard重新打开。
3.4 配置向导中的模型接入片段
配置向导走到模型提供商那一步时，选择 OpenAI 兼容模式。然后填入以下配置。这里给出一个 JSON 格式的配置片段，对应 OpenClaw 的配置文件结构（路径通常在~/.openclaw/config.json或 Windows 下的%USERPROFILE%\.openclaw\config.json）：
{ "provider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "你的_TaoToken_API_Key", "model": "claude-sonnet-4-5", "gateway": { "port": 18789, "host": "127.0.0.1" } }三个关键字段对照：Base URL 填https://taotoken.net/api，API Key 填你在 TaoToken 控制台创建的 Key，Model ID 填你要用的模型标识，比如claude-sonnet-4-5、deepseek-chat、minimax-m2等。这三个字段必须同时正确，缺一个都会导致请求失败。
如果你用的是 TOML 格式的配置（部分版本支持），对应写法：
[provider] type = "openai-compatible" base_url = "https://taotoken.net/api" api_key = "你的_TaoToken_API_Key" model = "claude-sonnet-4-5" [gateway] port = 18789 host = "127.0.0.1"配置向导里还会问是否配置聊天渠道（飞书、Discord、Telegram），暂时不需要就跳过。技能列表也先跳过，等基本跑通再装。
3.5 启动 Gateway 与验证
配置完成后，向导会自动启动 Gateway 守护进程。手动检查：
openclaw status看到Gateway service: running说明成功。如果没运行：
openclaw gateway start打开网页面板：
openclaw dashboard浏览器会自动打开http://localhost:18789。在里面发一条「你好，介绍一下自己」，收到回复就说明模型接入成功了。
4. 验证请求与成功结果：openclaw status 与 dashboard 实测
配置填完之后，怎么确认真的跑通了？这一节讲验证动作和预期结果。
第一步，检查 Gateway 状态。在 PowerShell 里执行：
openclaw status正常输出会包含几行关键信息：Gateway service 显示 running，端口显示 18789，模型提供商显示你配置的 provider。如果 Gateway service 显示 stopped，执行openclaw gateway start。如果启动失败，大概率是端口被占用，先openclaw gateway stop再重新 start。
第二步，打开 dashboard。执行：
openclaw dashboard浏览器打开http://localhost:18789。如果浏览器没自动打开，手动复制这个地址。页面加载出来后，你会看到一个聊天界面。在输入框里发一条测试消息，比如「你好，介绍一下自己」。如果模型接入配置正确，几秒内会收到回复。
第三步，跑一次全面检查：
openclaw doctor这个命令会逐项检查配置文件、Gateway 进程、模型连通性、端口占用等。有问题它会给出修复建议。我实测下来，最常见的 doctor 报错是模型连通性失败，原因基本都是 Base URL 或 Key 填错。
第四步，验证模型切换。如果你想换一个模型，执行：
openclaw config在配置界面里搜索 model 字段，改成你要的模型 ID。改完重启 Gateway：
openclaw gateway stop openclaw gateway run注意gateway run是前台运行，会占用当前终端；gateway start是后台运行。调试阶段用 run 方便看日志，稳定后用 start。
成功的结果长这样：dashboard 页面能正常对话，openclaw status显示 running，openclaw doctor全部通过。到这一步，OpenClaw 就在你 Windows 机器上跑起来了，模型走的是 TaoToken 的统一通道。
如果你想让 OpenClaw 读取本地文件、执行命令，还需要在配置里开启对应的权限。这部分在openclaw config里的 skills 和 permissions 字段控制。建议先在非敏感目录下测试，确认行为符合预期再扩大范围。
5. 本篇常见报错排查：401、local proxy failed 与 reading choices 报错
这一节对照真实报错，给出排查路径。以下都是我在部署过程中实际遇到或社区里高频出现的问题。
5.1 401 Unauthorized
报错原文类似：Error: 401 Unauthorized - invalid api key。
原因：API Key 填错、Key 已失效、或者 Base URL 和 Key 不匹配。排查步骤：先确认 TaoToken 控制台里的 Key 是否还在有效状态；再确认配置文件里的apiKey字段没有多余空格或换行；最后确认baseUrl填的是https://taotoken.net/api，没有多加斜杠或路径。
修复：重新在 TaoToken 控制台创建一个新 Key，替换配置文件里的旧 Key，重启 Gateway。
5.2 local proxy failed
报错原文类似：local proxy failed: connection refused或proxy error。
原因：Gateway 进程没起来，或者端口 18789 被其他程序占用。排查：执行openclaw status看 Gateway 是否 running；执行netstat -ano | findstr 18789看端口占用情况。
修复：如果端口被占用，先openclaw gateway stop，再换一个端口。在配置文件里把gateway.port改成 18790 或其他空闲端口，重启。
5.3 reading choices 报错
报错原文类似：Error reading choices: unexpected response format。
原因：模型返回的响应格式和 OpenClaw 预期的 OpenAI 格式不一致。这通常发生在 Base URL 填错、或者模型 ID 填了一个不存在的模型时。排查：确认model字段填的是 TaoToken 支持的模型 ID，不要填官网上的展示名称。比如要填claude-sonnet-4-5而不是Claude Sonnet 4.5。
修复：在 TaoToken 的模型列表里找到准确的 Model ID，替换配置文件里的 model 字段，重启 Gateway。
5.4 OAuth 相关报错
报错原文类似：OAuth token expired或authentication failed。
原因：如果你在配置向导里选了需要 OAuth 的提供商而不是 OpenAI 兼容模式，会走到 OAuth 流程。用 TaoToken 统一 Key 接入时，应该选 OpenAI 兼容模式，不需要走 OAuth。
修复：执行openclaw config，把 provider 改成openai-compatible，重新填 Base URL 和 Key。
5.5 Gateway 启动后 dashboard 打不开
排查：确认浏览器访问的是http://localhost:18789而不是https；确认没有其他程序占用这个端口；确认 Windows 防火墙没有拦截。如果用的是 WSL2，注意 localhost 转发在 WSL2 下通常是自动的，但偶尔需要重启 WSL：wsl --shutdown然后重新打开。
5.6 配置改了但没生效
OpenClaw 的配置在 Gateway 启动时加载。改完配置文件后必须重启 Gateway 才生效。执行openclaw gateway stop再openclaw gateway start。如果用的是gateway run前台模式，Ctrl+C 停掉再重新 run。
6. 跑通之后：用 TaoToken 统一 Key 管理你的 OpenClaw 模型接入
OpenClaw 在 Windows 上跑通之后，日常使用其实很简单：openclaw dashboard打开面板对话，openclaw status看状态，openclaw config改配置。真正需要花心思的是模型接入的管理。
用 TaoToken 统一 Key 的好处在这里体现出来：你不需要为每个模型单独维护一套 Key 和 Base URL。想换模型时，只改配置文件里的model字段，Base URL 和 Key 保持不变。比如从claude-sonnet-4-5换成deepseek-chat，只动一个字段，重启 Gateway 就行。
如果你打算长期用 OpenClaw 做编码辅助或 Agent 任务，可以考虑 TaoToken 的 Coding Plan，它针对高频调用场景做了额度优化。日常调试和验证模型效果，用模型对话页面就够了。需要创建和管理 Key，去 API Keys 页面。完整的接入文档在 doc 页面，里面有各语言的调用示例。
回到 OpenClaw 本身，跑通之后建议做几件事：先在非敏感目录下测试文件读写权限，确认行为符合预期；把常用的模型 ID 记下来，方便切换；定期跑openclaw doctor检查配置健康度。如果遇到 Gateway 重启失败，先openclaw gateway stop释放端口，再重新启动。这套流程走顺之后，Windows 本地跑 OpenClaw 就不再是障碍了。
