★ FEATURED ARTICLE 1. Win11 WSL2 跑 OpenClaw 到底卡在哪环境配置与首次启动验证全流程OpenClaw 是一个可以在本地跑起来的 AI 网关工具它把模型调用、插件、Dashboard 面板整合到一个进程里适合想在自己电脑上折腾 AI 助手、又不想把数据全丢到云端的开发者。你可以在 Win11 上通过 WSL2 把它跑起来浏览器打开http://127.0.0.1:18789就能看到控制面板。这篇文章面向的是第一次在 Windows 上部署 OpenClaw 的人尤其是那些敲完安装脚本却发现网关起不来、RPC 探针失败、Dashboard 提示 token 缺失的朋友。我自己在 Win11 WSL2 上装 OpenClaw 的时候本以为一行curl | bash就完事结果被 systemd 和 npm 版本两个坑卡了大半天。所以这篇会把环境自查、WSL2 发行版安装、依赖配置、OpenClaw 安装、网关启动、Dashboard 验证、以及几个高频报错的排查都写清楚命令可以直接复制。你跟着走一遍基本能绕开我踩过的那些坑。需要提前说明的是OpenClaw 的网关默认只绑定127.0.0.1也就是只有本机 WSL2 环境内的客户端能连这是它的默认安全策略不是配置错误。另外模型 API Key 这块如果你暂时没有可用的 Key可以先跳过先把网关跑起来后面再补配置。本文不涉及任何网络加速工具所有操作都在本地 WSL2 内完成。环境自查清单先过一遍Node 版本要 ≥ 22这是硬性要求低于这个版本安装脚本会直接罢工系统是 Win11 WSL2发行版推荐 Ubuntu 22.04 或 24.04pnpm 只有从源码编译才需要用官方安装脚本的话不用管。如果你不确定自己的 Node 版本进 WSL2 后敲node -v看一眼。2. TaoToken 前置准备模型接入的 Base URL、Key 与 Model ID 三件套OpenClaw 本身是个网关框架它需要接一个模型服务才能真正干活。你可以把它理解成一个“插座”模型服务是“电源”而 TaoToken 就是那个提供稳定电源的地方。在配置 OpenClaw 的模型之前你需要先拿到三样东西Base URL、API Key、Model ID。这三件套缺一不可后面在openclaw onboard向导里会用到。先说 Base URL。TaoToken 的 API 地址是https://taotoken.net/api注意这里不要加任何多余的路径后缀OpenClaw 的模型配置里填的就是这个根地址。API Key 需要你去控制台创建地址是https://taotoken.net/console登录后在 API Keys 页面新建一个复制出来保存好这个 Key 只会完整显示一次。Model ID 则取决于你想用哪个模型比如claude-sonnet-4-20250514这类标识具体以你控制台里模型列表显示的为准。如果你用的是 Claude Code 或者类似的编码工具TaoToken 也提供了对应的接入文档地址是https://taotoken.net/doc里面有不同工具的配置示例。对于 OpenClaw 来说你主要关注的是 OpenAI 兼容格式的 Base URL 和 Key因为 OpenClaw 的模型配置走的是标准接口。这里有个细节要注意OpenClaw 的配置文件默认在~/.openclaw/openclaw.json服务配置和 CLI 配置指向同一个文件。你在向导里填的 Base URL、Key、Model ID 最终都会写进这个 JSON。如果你后面想手动改直接编辑这个文件也行但改完记得重启网关。另外如果你打算长期跑编码类任务或者 Agent 工作流可以考虑用 Coding Plan地址是https://taotoken.net/coding-plan它在额度和稳定性上更适合高频调用场景。拿到三件套之后先别急着往 OpenClaw 里填。你可以先用一个简单的 curl 请求验证一下 Key 是否可用避免后面在 OpenClaw 里排查半天才发现是 Key 的问题。验证命令在下一节会给出来。如果你还没有 Key也可以先跳过模型配置OpenClaw 允许你先跑起来网关Dashboard 能打开只是模型调用会失败不影响你验证环境。3. 可复制配置WSL2 安装、systemd 启用与 OpenClaw 安装命令这一节是核心操作部分命令都可以直接复制。先处理 WSL2 的安装和 systemd 启用这是 OpenClaw 网关能作为服务运行的前提。第一步在 Win11 的 PowerShell管理员模式里安装 WSL2 和 Ubuntu 发行版wsl --install -d Ubuntu-22.04 wsl --set-default-version 2装完之后重启电脑然后从开始菜单打开 Ubuntu设置用户名和密码。进去之后先更新一下包列表sudo apt update sudo apt upgrade -y第二步启用 systemd。这是最容易漏掉的一步。在 WSL2 里编辑/etc/wsl.confsudo tee /etc/wsl.conf /dev/null EOF [boot] systemdtrue EOF写完必须彻底重启 WSL否则配置不生效。回到 PowerShell 执行wsl --shutdown等几秒重新打开 Ubuntu验证 systemd 是否启用systemctl --user status如果输出里没有Failed to connect to bus这类错误说明 systemd 已经正常。这一步没过后面 OpenClaw 网关一定起不来。第三步检查 Node 版本并安装 OpenClaw。先看 Nodenode -v如果低于 22用 nvm 装一个curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22然后升级 npm这一步很关键npm 版本太低会导致安装脚本报错npm install -g npmlatest接着跑 OpenClaw 官方安装脚本curl -fsSL https://openclaw.ai/install.sh | bash安装过程中会问一些配置项一路 YES 即可。装完之后执行配置向导openclaw onboard --install-daemon向导里会让你选模型提供商。如果你用 TaoToken选择 OpenAI 兼容或者自定义 Base URL 的选项然后填入三件套{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的_API_Key, modelId: claude-sonnet-4-20250514 }, gateway: { bind: loopback, port: 18789 } }上面这段是~/.openclaw/openclaw.json的核心结构示意实际向导会帮你写入。如果你手动编辑注意 JSON 格式不要有尾逗号。配置完成后启动网关openclaw gateway status openclaw gateway --port 18789如果 systemd 正常网关会作为用户服务跑起来。你可以用systemctl --user status查看服务状态。4. 验证请求与成功结果Dashboard 访问、RPC 探针与模型调用测试网关启动后先确认进程和端口状态openclaw gateway status正常输出里应该能看到Gateway: bindloopback (127.0.0.1), port18789以及RPC probe: ok或者类似的成功标识。如果 RPC probe 显示 failed先别急着往下走回到上一节检查 systemd 是否真的启用了。接着在 WSL2 里用 curl 验证端口是否监听curl -I http://127.0.0.1:18789/返回 HTTP 200 或 302 都算正常。然后在 Win11 的浏览器里打开http://127.0.0.1:18789/第一次打开可能会提示gateway token missing。这是正常的OpenClaw 的 Dashboard 需要 token 认证。按照页面提示在 WSL2 里执行命令生成 tokenopenclaw gateway token把输出的 token 复制到 Dashboard 的概览页面里保存刷新后就能进入控制面板。接下来验证模型调用。在 Dashboard 里找到模型对话入口或者直接用 curl 测一下 TaoToken 的接口是否通curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的_API_Key \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 你好}] }如果返回里有choices字段和正常的回复内容说明 Key 和 Base URL 都没问题。回到 OpenClaw 的 Dashboard发一条测试消息能看到模型回复就说明整条链路通了。如果你想在网页上直接体验模型对话也可以访问https://taotoken.net/model-chat先确认 Key 可用再回来配 OpenClaw。实测下来只要 systemd 启用正确、npm 版本够新、三件套填对整个流程大概 15 分钟能跑通。Dashboard 打开后你可以在里面看到网关状态、模型配置、插件列表等信息。飞书等插件如果依赖缺失装不上可以先跳过不影响核心的模型调用功能。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth 报错对照这一节把几个高频报错和对应解法列出来你遇到的时候可以直接对照。报错一401 Unauthorized。这个通常是 API Key 填错或者过期。检查~/.openclaw/openclaw.json里的apiKey字段确认没有多余空格。然后用上一节的 curl 命令单独测 Key如果 curl 也 401说明 Key 本身有问题去https://taotoken.net/console重新创建一个。如果 curl 正常但 OpenClaw 里 401检查 Base URL 是不是写成了https://taotoken.net/api/带了尾斜杠去掉尾斜杠再试。报错二local proxy failed。这个报错一般出现在网关启动阶段原因是 systemd 用户服务不可用导致网关无法作为后台服务运行。回到/etc/wsl.conf确认systemdtrue已写入然后必须在 PowerShell 里执行wsl --shutdown彻底重启。重启后systemctl --user status应该能正常输出。如果还是不行执行openclaw doctor --repair让工具自动修复服务配置。报错三reading choices 相关错误。这个通常出现在模型调用返回解析阶段说明接口返回的结构和 OpenClaw 预期的不一致。先确认 Base URL 是https://taotoken.net/apiModel ID 和控制台里显示的一致。然后用 curl 直接请求看返回 JSON 里有没有choices数组。如果 curl 返回正常但 OpenClaw 报错检查 OpenClaw 版本是否最新执行openclaw update升级。报错四OAuth 或认证跳转失败。如果你在配置插件时遇到 OAuth 相关报错先跳过该插件把模型配置跑通。OAuth 类插件通常需要额外的回调地址配置在 WSL2 的 loopback 环境下可能受限。你可以先在 Dashboard 里确认核心模型功能可用插件后面再单独处理。报错五gateway closed (1006 abnormal closure)。这是 WebSocket 连接异常关闭根本原因还是网关没稳定运行。检查openclaw gateway status的输出如果显示systemd (disabled)说明 systemd 没启用。按上面的步骤重新配置/etc/wsl.conf并重启 WSL。另外确认端口 18789 没有被其他进程占用用ss -tlnp | grep 18789查一下。报错六npm 版本不兼容。安装脚本报错时先看 npm 版本。Node 22 需要配 npm 10 以上执行npm install -g npmlatest升级后重跑安装脚本。如果 nvm 管理的 Node 版本切换后 npm 没跟着变用nvm reinstall-packages或者直接重装 npm。排查的时候有个通用思路先看openclaw gateway status的输出它会告诉你网关是否在跑、RPC 探针是否通、配置文件路径在哪。然后看日志文件默认在/tmp/openclaw/openclaw-日期.log里面会有更详细的错误堆栈。最后用 curl 单独测 TaoToken 接口排除 Key 和网络问题。这三步走完大部分问题都能定位。6. 跑通之后把 OpenClaw 接入日常编码与 Agent 工作流网关跑起来、Dashboard 能打开、模型能回复之后你可以开始把 OpenClaw 用起来。最直接的用法是在 Dashboard 的对话界面里测试不同模型看看哪个模型在你的场景下响应质量和速度更合适。如果你主要用它做编码辅助可以在 OpenClaw 里配置对应的编码插件或者直接通过 API 把 OpenClaw 的网关地址接到你的编辑器里。对于长期跑编码任务或者 Agent 工作流的场景建议关注一下 Coding Plan地址是https://taotoken.net/coding-plan它在调用额度和稳定性上更适合高频使用。如果你需要管理多个 API Key 或者查看调用量控制台地址是https://taotoken.net/consoleAPI Keys 页面可以创建和吊销 Key。接入文档在https://taotoken.net/doc里面有不同工具和语言的配置示例。如果你用的是 Claude Code可以参考文档里的 Claude Code 接入部分Base URL 同样填https://taotoken.net/apiKey 和 Model ID 按三件套填。OpenClaw 的配置文件~/.openclaw/openclaw.json建议备份一份后面改配置改坏了可以直接恢复。最后提醒几个实用点WSL2 的 systemd 配置改完一定要wsl --shutdown重启这是最多人漏掉的npm 版本要跟着 Node 22 一起升级Dashboard 的 token 生成后保存好换浏览器或者清缓存后需要重新填。网关默认只绑 loopback这是安全设计不要改成0.0.0.0暴露到局域网。如果你在配置过程中遇到本文没覆盖的报错先跑openclaw doctor看诊断建议再去文档里搜对应错误码。
阅读完成 · 觉得有帮助？
