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 版本支持 WSL2（Win10 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结尾，有些只要到/api，OpenClaw 的自定义 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_url（JSON 里不认下划线），或者 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 found：Model ID 填错了。去 TaoToken 文档或控制台确认准确的模型标识，别自己猜。不同模型的 ID 不一样，复制粘贴最保险。
排查的顺序建议是：先 curl 直连验证三件套，再查 OpenClaw 配置，最后查服务和端口。这样能快速定位问题在哪一层，不用瞎试。
6. 后续接入与长期使用：把 OpenClaw 纳入日常 Agent 工作流
装好并验证通过后，OpenClaw 就可以作为你本地的 Agent 入口长期用了。日常你可以通过 Web UI 跟它对话，也可以让它跑一些自动化任务。因为模型通道走的是 TaoToken 统一 Key，所以你换模型、查用量、管额度都在一个地方，不用每个工具单独配。
如果你后面还想接别的工具，比如 Claude Code 或者 Cline 这类，三件套的逻辑是一样的：Base URL 填https://taotoken.net/api，Key 用同一个，Model ID 按需选。这样你所有 AI 工具的调用都收拢到一条通道上，排查问题和看用量都方便。
对于长期跑编码或 Agent 任务的场景，可以考虑用 Coding Plan 这类套餐，额度更划算，适合高频调用。如果你只是偶尔用，按量付费的 Key 就够了。具体选哪种，看你的调用频率。
接入文档里有各工具的详细配置示例，遇到不确定的字段名可以去对照。模型对话页面可以直接测试模型是否可用，不用装任何东西就能验证 Key 和模型 ID。API Keys 页面管理你的密钥，建议定期轮换。
最后给一个实用习惯：把 OpenClaw 的配置文件和三件套单独存一份到密码管理器或加密笔记里。重装系统或换机器时，直接恢复配置，几分钟就能重新跑起来，不用再走一遍初始化向导。这个习惯能帮你省下不少重复折腾的时间。
