1. OpenClaw 在 Windows 上装完之后模型接入才是真正的分水岭OpenClaw小龙虾是一个跑在本地、能操作文件系统与执行自动化任务的 AI 智能体框架适合已经装好 Node.js/npm、想让自己的 Windows 机器拥有一个可编程助手的开发者。很多人卡住的地方不是安装本身而是安装完之后模型通道接不上openclaw onboard走完了Dashboard 也打开了发一句「你好」却一直转圈或者直接报鉴权失败。这篇就聚焦这个环节把 TaoToken 统一 Key 的填写位置、settings.json的配置骨架、以及一条能立刻确认通道连通的 curl 命令讲清楚让你从安装到可用一次闭环。我试过在 Windows 11 上反复重装 OpenClaw最后发现 90% 的「装完不能用」都不是安装问题而是模型接入配置写错了字段或者 Base URL 多带了/v1。下面按顺序来每一步都能直接复制。2. 前置准备TaoToken 统一 Key 与 OpenClaw 的对接位置TaoToken 在这里扮演的角色是「统一模型入口」你不需要为每个模型单独申请 Key、单独记 Base URL而是拿一个统一 Key通过一个兼容 OpenAI 协议的地址去调用不同模型。对 OpenClaw 来说它只需要知道三件事——Key、Base URL、Model Name。先去控制台把 Key 建出来入口在控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite创建时建议给这个 Key 设一个月度限额OpenClaw 会频繁调用模型限额能防止意外超额。拿到形如sk-xxxx的字符串后先放一边下面配置要用。OpenClaw 的模型配置有两个落点一个是openclaw onboard向导里的交互式填写另一个是直接改settings.json。向导适合第一次跑通settings.json适合后续换模型、换 Key、批量改参数。两者改的是同一份东西理解settings.json的骨架向导里填什么就一目了然了。注意OpenClaw 拥有文件读写和自动化执行权限建议在干净的备用机或独立环境里测试不要放在存有重要资产的主力工作机上。3. 可复制配置settings.json 骨架与统一 Key 填写位置OpenClaw 的配置文件默认在用户目录下Windows 路径通常是C:\Users\你的用户名\.openclaw\settings.json如果这个文件不存在可以先跑一次openclaw onboard --flow quickstart让它生成再手动改。下面是一份可直接复制的骨架重点看providers和models两段{ gateway: { mode: local, port: 18789 }, providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken统一Key, models: [ claude-sonnet-4-5, gpt-4o, deepseek-chat ] } }, models: { default: taotoken/claude-sonnet-4-5, fallback: taotoken/deepseek-chat }, agent: { maxTokens: 4096, temperature: 0.7 } }几个字段必须说清楚写错了就是连不上baseUrl填https://taotoken.net/api末尾不要加/v1。OpenClaw 内部会按 OpenAI 兼容协议自动补路径你手动加/v1会变成/v1/v1/chat/completions直接 404。apiKey就是刚才在控制台建的那个统一 Key整串粘进去不要带引号外的空格。models.default的写法是provider名/模型名provider 名要和providers里的键一致这里是taotoken。模型名按你实际要用的填TaoToken 侧支持的模型列表可以在模型对话页确认模型对话https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite如果你更习惯用向导openclaw onboard里遇到「AI 模型」这一步时选Custom (OpenAI Compatible)然后向导字段填写值Auth MethodAPI KeyBase URLhttps://taotoken.net/apiAPI Keysk-你的统一KeyModel Nameclaude-sonnet-4-5或你要用的模型向导填完本质就是往settings.json写上面那段结构所以两种方式等价改完记得重启网关。4. 验证请求一条 curl 确认通道连通配置写完先别急着开 Dashboard用一条 curl 直接打通道能最快定位是 Key 问题还是 OpenClaw 问题。在 PowerShell 里执行curl.exe -X POST https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer sk-你的TaoToken统一Key -H Content-Type: application/json -d {\model\:\claude-sonnet-4-5\,\messages\:[{\role\:\user\,\content\:\ping\}]}注意这里 curl 打的是完整路径/api/v1/chat/completions因为 curl 不会帮你补路径而settings.json里的baseUrl只写到/api补路径是 OpenClaw 干的两者不冲突。返回里能看到choices数组和一段回复内容就说明 Key 和通道都没问题。如果返回401是 Key 错了或没带Bearer返回404多半是路径写错返回429是触发了限额或频率限制。通道确认后回到 OpenClaw 启动网关并验证openclaw config set gateway.mode local openclaw gateway start openclaw dashboard浏览器打开http://127.0.0.1:18789/在聊天框输入「你好」能收到回复就说明整条链路通了。如果 Dashboard 里报模型错误但 curl 是通的那问题一定在settings.json的字段上回去对照第 3 节检查baseUrl和models.default的写法。5. 本篇常见错排查settings.json 与网关的那些坑报错openclaw 不是内部或外部命令npm 全局目录没进 PATH。关掉当前 PowerShell用管理员重开或手动把C:\Users\用户名\AppData\Roaming\npm加进系统 PATH。网关启动失败、Dashboard 离线先看安装路径有没有中文改成D:\OpenClaw这类纯英文路径再确认安全软件没有拦截OpenClaw 会做键鼠模拟和文件读写容易被误判。改完跑一次openclaw doctor --fix自动修配置。模型一直转圈不出字八成是baseUrl带了/v1或者models.default里的 provider 名和providers键对不上。把settings.json贴出来逐字比对尤其是引号和逗号。改了 Key 但没生效settings.json改完必须重启网关openclaw daemon restart或openclaw gateway restart热改不生效。首次启动特别慢正常现象首次要初始化依赖和环境等 1 到 3 分钟之后启动会快很多。想换模型不用重装直接改settings.json里models.default或者重跑openclaw onboard换 Key 换模型。长期跑编码和 Agent 任务的话可以了解下 Coding Plan额度模型更适合高频调用Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite6. 把 Key 管好比装得快更重要OpenClaw 这类本地智能体一旦跑起来调用频率会比你想象的高统一 Key 的好处是只在一个地方管额度、换模型不用改多处配置。接入文档里有完整的字段说明和更多模型示例遇到协议细节可以直接查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你用的是 Claude Code 这类编码工具Anthropic 兼容的接入方式也有单独说明ClaudeCodeAnthropichttps://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite最后给一个实操建议把settings.json备份一份换模型前先复制改坏了直接还原比重装 OpenClaw 快得多。