★ FEATURED ARTICLE 1. 装完 OpenClaw 却卡在模型接入先理清这一步OpenClaw 在 Windows 上完成图形化安装后很多人会停在同一个地方界面能打开Gateway 也显示在线但一发指令就报模型不可用。原因不复杂——OpenClaw 本体只是「数字员工」的躯干真正让它能听懂人话、拆解任务、调用工具的是背后的大模型服务。安装包内置的体验额度用完后你必须自己接一个模型通道否则它就是个空壳。这篇教程专门解决「安装完成之后」这一段面向零基础 Windows 用户交付一份可直接复制的settings.json配置骨架说明 TaoToken 统一 Key 该填在哪一行再给出安装完成后的连通性验证动作。目标很明确——让你从「装好了」走到「真的能用」一次跑通。适合谁看刚用图形化安装包部署完 OpenClaw、没写过配置文件、看到 JSON 就头大的 Windows 用户。全程不需要命令行基础复制粘贴为主改两个字段即可。下面所有路径、字段名都以 Windows 10/11 64 位为准Mac 用户字段逻辑一致路径换成~/Library/Application Support下的对应目录即可。2. TaoToken 前置准备拿到统一 Key 和接入地址TaoToken 在这里扮演的角色是「模型接入层」——你不需要分别去注册好几家模型厂商、记好几套 Key而是用一套统一 Key 对接多个模型。对新手来说这省掉了最烦的账号管理和额度分散问题。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。登录后进入控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。控制台里能看到你的账户余额、已用额度、以及最关键的 API Key 管理入口。第二步创建 API Key。进入 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 点「新建密钥」起个能认出来的名字比如openclaw-win。生成后那串以sk-开头的字符串就是你的统一 Key。注意这串 Key 只在创建时完整显示一次立刻复制存到本地记事本关掉页面就看不全了。第三步确认接入地址。TaoToken 的 API 基址是 https://taotoken.net/api 注意这个地址后面不加任何 UTM 参数配置里要原样填写。OpenClaw 走的是 OpenAI 兼容协议所以基址填到/api这一层即可具体路径由 OpenClaw 自己拼接。提示Key 属于敏感凭证不要截图发群、不要提交到 Git 仓库。如果不小心泄露回控制台把旧 Key 删掉、重新建一个几秒钟的事。如果你还想先确认某个模型在 TaoToken 上是否可用、响应风格是否符合预期可以先用模型对话页面试几句 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。确认没问题再写进配置能少走一轮排障。3. 可复制配置settings.json 骨架与 Key 填写位置OpenClaw 的模型配置集中在settings.json里。Windows 图形化安装后这个文件通常在安装目录下的config文件夹路径类似D:\OpenClaw\config\settings.json。如果你安装时选了别的盘就去对应目录找。找不到的话在 OpenClaw 主界面点右上角设置图标一般会有「打开配置目录」的入口。打开settings.json你会看到一堆字段。新手不用全懂只需要盯住models这一段。下面是一份可直接复制的骨架把你的Key替换成上一步复制的那串sk-开头字符串即可{ models: { default: taotoken-gpt, providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的Key, models: [ { id: taotoken-gpt, name: gpt-4o-mini, contextWindow: 128000 }, { id: taotoken-claude, name: claude-3-5-sonnet, contextWindow: 200000 } ] } } }, gateway: { host: 127.0.0.1, port: 18789 } }几个字段逐个说清楚避免你改错type固定填openai-compatible因为 TaoToken 走的是 OpenAI 兼容协议OpenClaw 认这个类型。baseUrl填https://taotoken.net/api结尾不要加斜杠也不要加/v1OpenClaw 会自己补。apiKey就是你的统一 Key整串粘进去前后不要留空格。这是最容易出错的地方——从网页复制时经常带上换行或空格导致鉴权失败。models数组里id是你在 OpenClaw 里调用时用的别名随便起但要好记name是 TaoToken 侧真实的模型名必须和平台上的模型标识一致写错了会报「模型不存在」。contextWindow按模型实际能力填填小了长文档会被截断填大了部分模型会拒绝请求拿不准就按上面示例的值来。default指向你默认想用的那个id。新手建议先用taotoken-gpt这类通用模型跑通链路稳定后再换。注意改完settings.json必须保存为 UTF-8 编码Windows 记事本默认可能是 ANSI中文注释会乱码。建议用 VS Code 或 Notepad 打开右下角确认编码是 UTF-8。改完保存回到 OpenClaw 主界面点右上角「重启 Gateway」让新配置生效。这一步不做配置不会加载。4. 验证请求三步确认模型真的通了配置写完不代表通了必须做连通性验证。下面三步从浅到深任何一步失败都能定位到具体环节。第一步看 Gateway 状态。重启后主界面右上角应显示「Gateway 在线」。如果显示离线先别急着怀疑模型配置多半是端口被占用或进程没起来点「重启」再等 10 秒。第二步发一条最小指令。在底部输入框敲一句最简单的你好请回复连通成功四个字如果模型通了几秒内会返回类似「连通成功」的回复。这一步验证的是 Key 鉴权和 baseUrl 是否正确。如果报 401就是 Key 错了或带了空格报 404就是 baseUrl 写错了检查是不是多写了/v1。第三步发一条带工具调用的指令验证完整链路帮我在桌面新建一个名为 test-openclaw.txt 的文件内容写hello这条指令会触发 OpenClaw 的文件操作工具。如果它能真的在桌面创建出文件说明模型不仅能对话还能正确驱动工具调用——这才是「数字员工」真正跑通的标志。只回文字不执行操作通常是模型不支持 function calling换taotoken-claude或taotoken-gpt里支持工具调用的型号再试。三步都过你的 OpenClaw 就算真正可用了。后续想加技能、接本地模型都是在这个通路上扩展。5. 本篇常见错排查新手最容易踩的五个坑坑一Key 复制带了空格或换行。表现是 401 鉴权失败。解决把apiKey的值删掉重新粘粘完在末尾按一下 Delete 确认没有隐藏字符。可以用apiKey: sk-xxx这种紧凑写法肉眼检查引号内是否干净。坑二baseUrl 多写了/v1。表现是 404 或路径找不到。TaoToken 的基址就是https://taotoken.net/apiOpenClaw 内部会拼/v1/chat/completions你多写一层就变成/api/v1/v1/...。删掉多余的/v1。坑三模型name和平台标识不一致。表现是「模型不存在」。回 TaoToken 控制台或模型列表页核对模型的确切标识大小写、连字符都要一致。别凭记忆写。坑四改了配置没重启 Gateway。表现是配置明明对了却还是旧行为。OpenClaw 只在启动时读一次settings.json改完必须重启。养成「改配置→重启→验证」的固定动作。坑五settings.json编码不对导致解析失败。表现是 Gateway 起不来或配置整段失效。用编辑器确认保存为 UTF-8且 JSON 语法合法——多一个逗号、少一个引号都会让整个文件失效。不确定的话把内容粘到在线 JSON 校验工具里过一遍。如果以上都排查完还是不通最直接的办法是回控制台重新生成一个 Key排除 Key 本身的问题。接入相关的完整说明可以对照文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。6. 跑通之后按你的用法选下一步链路通了之后接下来怎么用取决于你的场景。如果你只是想让 OpenClaw 处理日常文件整理、表格生成这类轻量任务现在这套配置已经够用把default设成响应快、成本低的模型即可。如果你打算长期用它做编码辅助、跑 Agent 任务频繁调用会消耗不少额度这时候可以了解一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 按用量规划比零散充值更划算。如果你更习惯在编辑器里直接调用模型Claude Code 的接入方式可以参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。新手阶段最容易犯的错是配置一次就想覆盖所有场景。我的建议是先用一个模型把主流程跑顺等你能稳定地让 OpenClaw 完成三五个固定任务后再按任务类型分配不同模型。配置这东西能跑通比配得全重要得多。
阅读完成 · 觉得有帮助？
