1. Windows 上跑 OpenClaw 到底卡在哪WSL2 与 PowerShell 的部署场景拆解OpenClaw 是一个可以在本地运行的 AI 助手框架它能读取你电脑上的文件、执行命令、调用大模型完成自动化任务适合想把 AI 接入日常工作流的开发者。但它的原生运行环境是 LinuxWindows 用户直接跑会遇到一堆路径、权限、依赖问题。这篇教程聚焦 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/apiAPI Key 填你在 TaoToken 控制台创建的 KeyModel 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。改完重启 Gatewayopenclaw gateway stop openclaw gateway run注意gateway run是前台运行会占用当前终端gateway start是后台运行。调试阶段用 run 方便看日志稳定后用 start。成功的结果长这样dashboard 页面能正常对话openclaw status显示 runningopenclaw 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 下通常是自动的但偶尔需要重启 WSLwsl --shutdown然后重新打开。5.6 配置改了但没生效OpenClaw 的配置在 Gateway 启动时加载。改完配置文件后必须重启 Gateway 才生效。执行openclaw gateway stop再openclaw gateway start。如果用的是gateway run前台模式CtrlC 停掉再重新 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 就不再是障碍了。