1. Windows 下 OpenClaw 本地部署踩坑记PowerShell 与 WSL 环境准备OpenClaw 是一个可以跑在本地的 AI Agent 网关简单说就是把你常用的模型能力统一收拢到一个本地服务里再通过 Web UI 或命令行去调用。它适合想在自己电脑上折腾 Agent、又不想把请求散落到各种第三方客户端的人。这一篇接着上一篇的环境准备专门讲 Windows 下怎么用 PowerShell 配合 WSL 把 OpenClaw 装起来并且把模型 endpoint 切到 TaoToken 的统一通道上。我第一次装的时候卡在 WSL 没装好、curl 命令跑一半断掉、以及模型授权那一步反复跳浏览器。后来把流程拆开先确认 WSL 可用再跑安装脚本最后单独处理模型接入就顺很多。下面按这个顺序来你可以直接跟着敲。先说清楚整体链路Windows 上打开 PowerShell管理员用wsl进入 Linux 子系统在子系统里执行 OpenClaw 的安装脚本脚本会引导你完成初始化。初始化里最关键的一步是选模型来源这里我们不选官方默认的云端授权而是改成自定义 endpoint指向 TaoToken 的 API 地址。这样后面所有 Agent 调用都走同一个 Key管理起来清爽。在动手前确认三件事一是 Windows 版本支持 WSL2Win10 2004 以上或 Win11 都行二是 PowerShell 用管理员身份打开三是你有一个 TaoToken 的 API Key没有的话先去控制台建一个。这三点齐了后面基本不会卡。WSL 的检查很简单在 PowerShell 里敲wsl --status能看到默认版本和内核信息就说明可用。如果提示没安装用wsl --install装一下装完重启。这一步别跳过因为 OpenClaw 的安装脚本是 bash 脚本必须在 Linux 环境里跑纯 PowerShell 是跑不了的。我试过直接在 PowerShell 里硬跑那个 curl 管道命令结果因为 shell 差异报了一堆错。所以记住curl 那条命令一定要在 WSL 里执行不是在 PowerShell 里。PowerShell 只负责把你送进 WSL。进入 WSL 后先更新一下包列表避免安装脚本依赖的工具缺失。然后就可以跑 OpenClaw 的安装命令了。安装过程中会弹出一个安全告知问你是否理解「默认个人使用、多用户需要加固」用方向键选 Yes 回车即可。这个提示不是吓唬人它是在提醒你别把服务直接暴露到公网个人本地用没问题。接着会问你是 QuickStart 还是 Manual。新手直接 QuickStart它会帮你把大部分默认配置填好。然后到选模型这一步就是我们要动手改的地方——不选它列出的云端授权而是走自定义 endpoint填 TaoToken 的地址和 Key。2. TaoToken 前置准备Key、Base URL 与模型 ID 三件套在改 OpenClaw 配置之前先把 TaoToken 这边的三样东西准备好后面填配置就是复制粘贴的事。很多人卡在接入这一步其实不是 OpenClaw 的问题而是 Key 或地址填错了。第一样是 API Key。去 TaoToken 控制台在 API Keys 页面新建一个复制出来先存到记事本。注意这个 Key 只在创建时完整显示一次关掉页面就看不全了所以一定要先存好。如果你已经有 Key直接拿来用就行。第二样是 Base URL。TaoToken 的 API 地址是https://taotoken.net/api注意这里不带任何查询参数就是干净的域名加路径。有些工具要求填到/v1结尾有些只要到/apiOpenClaw 的自定义 endpoint 一般填到/api即可具体看它配置项怎么描述。如果它要求 OpenAI 兼容格式通常填https://taotoken.net/api就能被识别。第三样是 Model ID。这个取决于你想用哪个模型TaoToken 支持多种模型你在控制台或文档里能看到可用的模型名。填的时候要用准确的模型标识不能自己编。比如常见的对话模型、代码模型都有对应的 ID选一个你常用的填进去。把这三样凑齐就是所谓的「三件套」Base URL API Key Model ID。任何 OpenAI 兼容的客户端接入本质都是填这三样。OpenClaw 也不例外只是它的配置入口藏得深一点可能在初始化向导里也可能在装完后的配置文件里。这里提醒一个常见误区有人把官网地址https://taotoken.net当成 API 地址填进去结果请求 404。官网是给人看的API 是给程序调的两者路径不同。填配置时认准https://taotoken.net/api。另外如果你用的是 Claude Code 这类工具它的配置格式和 OpenClaw 不一样但三件套的逻辑是一样的。Claude Code 一般通过环境变量或 settings 文件配置OpenClaw 则是在初始化向导或配置文件里填。搞清楚这个对应关系换工具时就不会慌。准备好之后回到 OpenClaw 的初始化流程。如果它已经装完并进入了配置界面找到模型或 provider 相关的设置项把默认的云端授权改成自定义。如果初始化时没找到入口就等装完后直接改配置文件下一节给具体片段。3. 可复制配置OpenClaw 接入 TaoToken 的 JSON 与 settings 片段OpenClaw 装完后配置一般落在用户目录下的隐藏文件夹里常见路径是~/.openclaw/或~/.config/openclaw/。具体位置以安装完成时终端输出的提示为准它会告诉你配置文件在哪。找到之后用编辑器打开把模型相关的段落改成 TaoToken 的地址和 Key。下面给一个通用的 JSON 配置片段字段名可能因版本略有差异但结构大同小异。你对照自己文件里的实际字段名替换即可{ provider: { name: taotoken, type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: 你的模型ID }, gateway: { port: 18789, host: 127.0.0.1 } }如果你的 OpenClaw 版本用的是 TOML 格式那配置长这样[provider] name taotoken type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model 你的模型ID [gateway] port 18789 host 127.0.0.1注意几个点baseUrl或base_url填https://taotoken.net/api不要多加斜杠也不要少写apiKey填你刚才存的那个model填准确的模型 ID。gateway那段是本地服务监听的地址和端口保持127.0.0.1就只在本机可访问安全。如果你用的是 Claude Code 并且想接 TaoToken配置方式不同一般是在~/.claude/settings.json里加环境变量或者用ANTHROPIC_BASE_URL指向兼容地址。但 OpenClaw 这边我们按上面的 JSON/TOML 来。改完配置后保存文件。有些版本需要重启 OpenClaw 服务才能生效重启命令通常是openclaw restart或在 Web UI 里点重启。如果不确定直接关掉终端重新跑一次启动命令也行。这里再强调一次三件套的完整性Base URL、API Key、Model ID一个都不能少。少任何一个请求都会失败。特别是 Model ID填错了会报模型不存在的错误而不是认证错误排查时容易搞混。配置写好后先别急着跑复杂任务用最简单的连通性验证确认通道是通的。下一节给具体命令和预期结果。4. 验证请求用 curl 和 Web UI 确认 OpenClaw 已走 TaoToken配置改完第一步是确认 OpenClaw 服务本身起来了。在 WSL 里跑启动命令看终端有没有报错有没有输出监听地址。正常的话会看到类似listening on 127.0.0.1:18789的提示。如果端口被占用换个端口再试。服务起来后先用 curl 直接打 TaoToken 的接口确认 Key 和地址没问题。这一步是绕过 OpenClaw单独验证三件套curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: 你的模型ID, messages: [{role: user, content: 你好}] }如果返回里有choices字段和一段回复内容说明 Key、地址、模型都对。如果返回 401是 Key 错了返回 404是地址或模型 ID 错了返回超时检查网络。这一步通了再回到 OpenClaw 里测。接着在 OpenClaw 的 Web UI 里发一条消息。打开浏览器访问终端提示的地址一般是http://127.0.0.1:18789。进去后找到对话入口随便问一句看有没有正常回复。如果回复正常说明 OpenClaw 已经成功走 TaoToken 通道了。如果 Web UI 里报错但 curl 直连是通的那问题就在 OpenClaw 的配置上。回头检查配置文件里的字段名有没有写错比如baseUrl写成了base_urlJSON 里不认下划线或者 Key 前后多了空格。这些细节最容易翻车。验证通过后你可以试着让它跑一个稍微复杂点的任务比如让它读一个本地文件再总结。这一步能确认 Agent 的工具调用链路也是通的不只是单纯对话。如果工具调用报错可能是权限或路径问题跟模型通道无关单独排查。实测下来只要三件套填对OpenClaw 接 TaoToken 这一步基本一次过。真正花时间的是前面 WSL 环境和安装脚本的折腾。所以验证通过后建议把配置文件备份一份下次重装直接覆盖省得再填一遍。5. 本篇常见错排查401、local proxy failed 与 reading choices 报错装和接的过程中报错基本集中在几个地方。下面按我遇到的和社区里常见的整理对照着看。401 Unauthorized这个最直接Key 不对。检查三件事Key 有没有复制完整有没有漏字符、Key 前面有没有多余空格、Key 是不是已经失效。去 TaoToken 控制台重新建一个换上基本能解决。注意别把官网地址当 API 地址填那会报 404 不是 401。local proxy failed / connection refused这个通常是 OpenClaw 服务没起来或者端口不对。先在 WSL 里确认进程在跑ps aux | grep openclaw看一下。如果没跑重新启动。如果跑了但连不上检查配置文件里的 host 和 port以及你访问的地址是否一致。有时候服务监听在127.0.0.1你却用localhost访问某些环境下会解析失败统一用127.0.0.1更稳。reading choices 报错 / cannot read property choices这个说明请求发出去了但返回的结构不对程序解析choices字段时失败。常见原因是 Base URL 填错了比如填成了官网地址返回的是 HTML 而不是 JSON自然没有choices。确认地址是https://taotoken.net/api并且路径拼接到/v1/chat/completions时没有重复或缺失。OAuth 授权卡住 / 浏览器打不开初始化时如果选了官方云端授权会跳浏览器。如果你不想走这条路就改成自定义 endpoint跳过 OAuth。已经卡住的可以中断初始化手动改配置文件把 provider 换成 openai-compatible 类型填三件套。WSL 里 curl 命令断掉 / 脚本执行一半退出多半是网络波动或权限问题。重跑一次安装命令或者在跑之前先sudo apt update确保依赖齐全。如果提示权限不足确认你是在 WSL 的普通用户下跑必要时加sudo但安装脚本一般不建议全程 sudo。模型不存在 / model not foundModel ID 填错了。去 TaoToken 文档或控制台确认准确的模型标识别自己猜。不同模型的 ID 不一样复制粘贴最保险。排查的顺序建议是先 curl 直连验证三件套再查 OpenClaw 配置最后查服务和端口。这样能快速定位问题在哪一层不用瞎试。6. 后续接入与长期使用把 OpenClaw 纳入日常 Agent 工作流装好并验证通过后OpenClaw 就可以作为你本地的 Agent 入口长期用了。日常你可以通过 Web UI 跟它对话也可以让它跑一些自动化任务。因为模型通道走的是 TaoToken 统一 Key所以你换模型、查用量、管额度都在一个地方不用每个工具单独配。如果你后面还想接别的工具比如 Claude Code 或者 Cline 这类三件套的逻辑是一样的Base URL 填https://taotoken.net/apiKey 用同一个Model ID 按需选。这样你所有 AI 工具的调用都收拢到一条通道上排查问题和看用量都方便。对于长期跑编码或 Agent 任务的场景可以考虑用 Coding Plan 这类套餐额度更划算适合高频调用。如果你只是偶尔用按量付费的 Key 就够了。具体选哪种看你的调用频率。接入文档里有各工具的详细配置示例遇到不确定的字段名可以去对照。模型对话页面可以直接测试模型是否可用不用装任何东西就能验证 Key 和模型 ID。API Keys 页面管理你的密钥建议定期轮换。最后给一个实用习惯把 OpenClaw 的配置文件和三件套单独存一份到密码管理器或加密笔记里。重装系统或换机器时直接恢复配置几分钟就能重新跑起来不用再走一遍初始化向导。这个习惯能帮你省下不少重复折腾的时间。