企业官网建设流程全解析

1. Win10 装完 OpenClaw 却连不上模型？先把通道这件事捋清楚

OpenClaw 是一个可以跑在本地、通过命令行和 Web 控制台驱动的 AI 智能体框架，能接多种模型提供商，适合想在 Win10 上搭一套自己的编码/自动化助手的开发者。它的核心检索词就三个：Win10、OpenClaw、settings 配置。很多人卡住不是因为装不上，而是装完之后模型通道没配对，openclaw gateway start起来了，一发请求就报 401 或者local proxy failed。

我自己在 Win10 22H2 上从零走了一遍：一键脚本装依赖、npm install -g openclaw@latest、openclaw onboard初始化，最后把模型通道统一改到 TaoToken 的 API 地址上。整个过程最花时间的不是安装，而是搞清楚 settings 文件里baseUrl、apiKey、model这三个字段到底写在哪、写成什么格式。这篇就把这份配置记录完整摊开，包括可复制的 settings 片段、启动日志怎么读、模型列表怎么拉、最小对话请求怎么发，以及几个我实际撞到的报错。

适合谁看：已经在 Win10 上装好 OpenClaw、但模型通道还没跑通的人；或者正准备装、想一次性把通道配好的人。如果你还没装，第 2 节会把前置动作补齐，装和配连起来做。

先说结论性的东西，省得你翻到最后：OpenClaw 的模型通道配置集中在用户目录下的 settings 文件里，Win10 路径通常是C:\Users\你的用户名\.openclaw\settings.json。把里面的 provider 指向 TaoToken 的 API 地址https://taotoken.net/api，填上统一 Key，再指定一个 Model ID，重启 gateway 就能生效。下面按顺序拆。

2. 前置准备：Win10 环境依赖与 TaoToken 统一 Key 获取

这一节解决两件事：把 OpenClaw 装到能跑，以及拿到一个能用的 API Key。装的部分参考官方一键脚本，配的部分走 TaoToken。

2.1 Win10 依赖清单与一键安装

Win10 家庭版和专业版都能装。硬件上 4GB 内存起步，留 10GB 左右硬盘空间，网络能正常访问 GitHub 和 npm 就行。右键开始菜单，选“Windows PowerShell (管理员)”，先放开脚本执行策略：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

然后跑官方安装脚本：

iwr -useb https://openclaw.ai/install.ps1 | iex

脚本会自动把 Node.js、Git 这些依赖拉下来配好。如果你更想手动控制，也可以自己装 Node.js LTS（22.x 或 24.x，安装时勾选 Add to PATH）、Git（同样勾 Add to PATH）、最新版 Visual C++ Redistributable x64。手动装完再全局装 OpenClaw：

npm install -g openclaw@latest

国内网络拉包慢的话，可以先切镜像再装：

npm config set registry https://registry.npmmirror.com/

装完验证一下版本，能打印出版本号就说明 PATH 没问题：

openclaw --version

如果提示openclaw 不是内部或外部命令，多半是 npm 全局路径没进 PATH。用npm prefix -g看全局目录，把它加到系统环境变量里，重开终端再试。

2.2 拿 TaoToken 统一 Key

OpenClaw 支持多家模型提供商，但一家家配 Key、记不同 Base URL 很烦。TaoToken 的做法是给一个统一入口：一个 Key、一个 API 地址，背后可以切不同模型。对 OpenClaw 这种要在 settings 里写死 provider 的工具来说，统一通道省事很多。

获取步骤不复杂：打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册登录后进控制台，在 API Keys 页面创建一个新 Key。创建时给它起个能认出来的名字，比如openclaw-win10，方便以后在 OpenClaw 里对号入座。Key 只在创建时完整显示一次，复制下来存好，后面 settings 里要用。

控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API Keys 页面是 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。API 的基础地址是https://taotoken.net/api，注意这个地址后面不加任何路径后缀，OpenClaw 的 settings 里就填这个。

注意：Key 属于敏感凭据，别写进会提交到 Git 的公开文件里。settings.json 在用户目录下，一般不会被仓库跟踪，但如果你手动复制配置到项目里，记得排除。

拿到 Key 之后，先别急着改 OpenClaw，可以用一条 curl 确认 Key 本身是通的。Win10 的 PowerShell 里 curl 是 Invoke-WebRequest 的别名，建议直接用curl.exe：

curl.exe https://taotoken.net/api/models ` -H "Authorization: Bearer 你的Key"

能返回模型列表 JSON，说明 Key 和网络都没问题，再往下配 OpenClaw 就少一个变量。这一步很多人跳过，结果后面报 401 时分不清是 Key 错还是 OpenClaw 配置错。

3. 可复制配置：把 OpenClaw 的 settings 改到 TaoToken

这一节是全文核心。OpenClaw 的模型通道配置写在 settings 文件里，改对它，通道就通了。

3.1 找到 settings 文件

Win10 上 OpenClaw 的用户级配置默认在：

C:\Users\你的用户名\.openclaw\settings.json

如果你跑过openclaw onboard，这个文件应该已经生成了，里面可能有向导写入的默认 provider。用记事本或 VS Code 打开它。如果文件不存在，手动建一个也行，OpenClaw 启动时会读。

先备份一份，改坏了能回退：

copy $env:USERPROFILE\.openclaw\settings.json $env:USERPROFILE\.openclaw\settings.json.bak

3.2 settings.json 完整片段

下面这份是实测能跑通的配置，把 provider 指向 TaoToken，字段名和路径都按 OpenClaw 的实际结构来。你可以整段替换，也可以只改对应字段：

{ "providers": { "taotoken": { "type": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "你的TaoToken Key", "models": { "default": { "id": "claude-sonnet-4-5", "name": "Claude Sonnet 4.5" } } } }, "defaultProvider": "taotoken", "gateway": { "port": 18789, "host": "127.0.0.1" } }

几个字段逐个说清楚，免得你改错：

type写openai-compatible，因为 TaoToken 的 API 走的是 OpenAI 兼容协议，OpenClaw 用这个类型去发请求。baseUrl就是https://taotoken.net/api，不要加/v1也不要加斜杠结尾，加了容易拼出双斜杠导致 404。apiKey填你刚才创建的那串 Key。models.default.id是 Model ID，这个值要和你实际想用的模型对上，写错了会在拉模型或发请求时报model not found。

defaultProvider指向taotoken，这样 OpenClaw 默认走这个通道。gateway那段是本地网关的监听地址，默认127.0.0.1:18789，一般不用动，除非端口被占。

提示：如果你在 OpenClaw 里同时配了多家 provider，defaultProvider决定默认用哪家。想临时切模型，改models.default.id再重启 gateway 即可，不用动 Key。

3.3 三件套对照：Base URL、Key、Model ID

不管你是用 OpenClaw 原生 settings，还是通过 CC Switch、Cline MCP、Codex 的 auth.json 这类工具接入，模型通道永远就三件套，缺一不可：

这三样在 OpenClaw 的 settings 里分别对应baseUrl、apiKey、models.default.id。如果你用的是 Codex，它的auth.json里对应的是base_url、api_key和模型字段，字段名不同但含义一样。Cline 的 MCP 配置里则是baseUrl、apiKey、model。记住这三件套，换任何工具都是同一套逻辑。

改完保存，别急着启动，先确认 JSON 没语法错误。PowerShell 里可以快速校验：

Get-Content $env:USERPROFILE\.openclaw\settings.json | ConvertFrom-Json

没报错就说明 JSON 结构合法。报Invalid JSON的话，多半是多了逗号、少了引号，或者中文引号混进去了。

4. 验证请求：启动日志、模型列表与最小对话

配置写完不算完，得逐项验证。这一节按启动日志、模型列表、最小对话三步走，每步都有明确的成功标志。

4.1 启动 gateway 并读日志

先停掉可能还在跑的旧服务，再启动：

openclaw gateway stop openclaw gateway start openclaw gateway status

status显示 running 就说明进程起来了。但进程起来不代表通道通，关键看启动日志。日志里会打印它加载了哪个 provider、baseUrl 是什么。如果看到类似provider taotoken loaded, baseUrl=https://taotoken.net/api的行，说明 settings 被正确读取了。如果日志里还是旧的 provider 名字，说明你改的文件不是它实际读的那个，检查路径和文件名。

日志里如果出现local proxy failed，通常是 gateway 想连本地某个代理端口但没连上。检查 settings 里有没有残留的 proxy 字段，或者系统环境变量里有没有指向本地端口的代理设置，清掉再重启。

4.2 拉取模型列表

通道通不通，拉一次模型列表最直接：

openclaw models list

成功的话会打印一列可用模型。如果这一步报 401，说明 Key 没被正确带上，回去检查 settings 里apiKey字段有没有拼错、有没有多余空格。如果报reading choices之类的解析错误，多半是 baseUrl 写成了带/v1的地址，导致返回结构和预期对不上，改回https://taotoken.net/api再试。

也可以直接用 curl 对照，确认是 OpenClaw 的问题还是通道本身的问题：

curl.exe https://taotoken.net/api/models -H "Authorization: Bearer 你的Key"

curl 能出结果、OpenClaw 出不来，那就是 settings 的问题；两个都出不来，那就是 Key 或网络的问题。

4.3 发一次最小对话请求

最后一步，发一条最短的对话，确认端到端能跑：

openclaw chat "用一句话说明什么是递归"

能返回一句正常的中文回答，就说明从 OpenClaw 到 TaoToken 再到模型这条链路全通了。如果返回空、或者报超时，先看 gateway 日志里这次请求的状态码。200 但内容空，可能是 Model ID 写错导致路由到了不存在的模型；4xx 则是鉴权或参数问题。

想更直观地验证模型行为，也可以直接在模型对话页面手动发一条，对照 OpenClaw 的输出是否一致：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。两边都能出结果，基本可以确定配置没问题。

如果你打算长期用 OpenClaw 跑编码或 Agent 任务，而不是偶尔试一下，可以考虑 Coding Plan 这类长期方案，省得每次手动管额度：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

5. 本篇常见报错排查：401、local proxy failed、reading choices

配置过程中撞到的报错就那么几个，逐个对照着排，比盲改快得多。

5.1 401 Unauthorized

最常见。含义是请求没带上有效凭据，或者凭据不对。排查顺序：先确认 settings 里apiKey字段的值和你控制台创建的那串完全一致，注意有没有复制时带上首尾空格；再确认baseUrl没写错，写错地址会导致请求发到别处，自然 401；最后确认 Key 没过期或被删。用 curl 单独测一次 Key，能区分是 Key 的问题还是 OpenClaw 读取的问题。

5.2 local proxy failed

这个报错说明 gateway 尝试走本地代理但失败了。Win10 上常见原因是系统里设了本地代理端口，或者 settings 里残留了 proxy 配置。检查settings.json里有没有proxy相关字段，有就删掉；再检查系统环境变量HTTP_PROXY、HTTPS_PROXY有没有指向本地端口，有就临时清掉再重启 gateway。清掉后如果恢复正常，说明就是代理配置在捣乱。

5.3 reading choices 解析错误

报错里带reading choices或类似字段解析失败，通常是返回的 JSON 结构和 OpenClaw 预期的不一致。头号原因是 baseUrl 写成了https://taotoken.net/api/v1这种带后缀的形式，导致请求路径拼错、返回了非预期内容。把 baseUrl 改回https://taotoken.net/api，重启 gateway 再试。另一个可能是 Model ID 写错，通道把请求路由到了不存在的模型，返回了错误结构。

5.4 OAuth 相关报错

如果你在 onboard 阶段选了需要 OAuth 的 provider，后面又改成 TaoToken，可能会残留 OAuth 配置导致冲突。表现是启动时提示 OAuth token 无效或找不到。解决办法是检查 settings 里有没有oauth字段，删掉；或者干脆重新跑一次openclaw onboard，在选 provider 时直接选 OpenAI 兼容类型，填 TaoToken 的三件套。

5.5 命令找不到 / PATH 问题

openclaw命令找不到，或者npm全局装的包调不起来，基本都是 PATH 没配好。用npm prefix -g看全局安装目录，把那个目录加到系统环境变量的 Path 里，重开终端。Win10 上改完环境变量一定要新开一个 PowerShell 窗口，旧窗口不会自动刷新。

排障时如果拿不准是通道问题还是工具问题，接入文档里有更细的字段说明可以对照：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。需要重新生成或管理 Key 就去 API Keys 页面：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

6. 把通道固定下来：后续维护与统一入口

配置跑通之后，日常维护其实就几件事。模型想换，改models.default.id重启 gateway；Key 想轮换，去控制台新建一个，替换 settings 里的apiKey，重启；端口冲突，改gateway.port。每次改完都用Get-Content ... | ConvertFrom-Json校验一下 JSON，能省掉很多“改了没生效”的困惑。

我自己的习惯是把 settings.json 的备份和当前版本放一起，改之前先 copy 一份带日期的备份，出问题直接回退，比逐行找错快。另外，OpenClaw 的 gateway 日志建议留着，排障时它是唯一能告诉你“请求到底发去哪了”的地方。

如果你后面要在多台机器、多个工具之间共用同一套模型通道，统一入口的价值会更明显——一个 Key、一个 Base URL，OpenClaw、Codex、Cline 都填同一套三件套，不用每家单独记。控制台里可以随时看 Key 的使用情况，需要新建或吊销也在同一处：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。Claude Code 这类工具的接入配置，文档里有对应章节：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

最后留一个实操建议：每次改完 settings，别只跑openclaw chat，把openclaw models list也跑一遍。前者验证端到端，后者验证通道鉴权，两个都过，才算真的配好了。