1. Windows 上 OpenClaw 配 GLM 5.0卡住新手的到底是什么OpenClaw 是一个能在你本机干活的 AI 智能体框架GLM 5.0 是智谱推出的编程向大模型两者组合起来你相当于在 Windows 上养了一个能读写文件、跑命令、开浏览器的数字助手。这套组合适合零基础但愿意动手的 Windows 用户尤其是想把 AI 从“聊天窗口”拉进“真实工作流”的人。但真正上手时大多数人卡的不是安装本身而是配置环节。OpenClaw 的模型接入需要填 API Key、选 provider、指定 base URL、挑默认模型每一步都有格式要求。如果你同时用多个模型服务Key 散落在不同平台配置文件里改来改去一个空格或字段名写错启动就报错。我见过太多人在这步反复重装最后放弃。这篇教程的目标很明确让你在 Windows 上用 TaoToken 的统一 Key 和 API 通道一次性把 OpenClaw 和 GLM 5.0 跑通。我会给出可直接复制的settings.json和config.toml骨架演示启动验证并把最常见的报错和排查动作列清楚。你不需要理解每个字段的底层含义照着填就能跑。TaoToken 在这里的角色是“统一入口”你不需要在 OpenClaw 里分别配置智谱、OpenAI 或其他平台的 Key而是用 TaoToken 生成一个 Key通过它的 API 通道转发到 GLM 5.0。这样配置文件里只有一套认证信息换模型时只改模型名不动 Key。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 后面配置里会反复用到。2. 前置准备Node.js、Git 与 TaoToken Key2.1 安装 Node.js 和 GitOpenClaw 基于 Node.js所以第一步是装运行环境。打开 https://nodejs.org/zh-cn/download 下载 Windows x64 的 LTS 版本.msi安装包双击后一路 Next。装完打开 PowerShell 验证node -v npm -v看到v24.x.x和对应的 npm 版本号就说明成功了。Git 同样去 https://git-scm.com/install/windows 下载 64 位安装包默认选项一路 Next装完验证git --version这两个工具装好后后面 OpenClaw 的安装和依赖拉取才不会报“找不到命令”。2.2 获取 TaoToken 统一 Key打开 https://taotoken.net/api-keys 注册或登录后创建一个 API Key。这个 Key 就是你在 OpenClaw 里唯一需要填的认证信息。复制时注意不要带前后空格建议先粘贴到记事本里检查一遍。注意API Key 只显示一次创建后立即保存。不要把它提交到 Git 仓库或截图发到公开群组。TaoToken 的 API 基础地址是https://taotoken.net/api兼容 OpenAI 风格的接口路径。OpenClaw 支持自定义 base URL所以我们可以把 provider 指向 TaoToken再由 TaoToken 转发到 GLM 5.0。这样你不需要在本地存智谱的 Key也不需要改 OpenClaw 的源码。如果你后续想长期跑编码任务或 Agent 工作流可以了解 Coding Plan 方案入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它更适合高频调用场景。现在先专注把单次配置跑通。3. 安装 OpenClaw 并写入 settings.json 与 config.toml3.1 安装 OpenClaw以管理员身份运行 PowerShell在开始菜单搜索“PowerShell”右键选择“以管理员身份运行”。先放开脚本执行权限Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force然后全局安装 OpenClawnpm install -g openclawlatest如果 npm 下载慢可以先切到国内镜像npm config set registry https://registry.npmmirror.com安装完成后验证openclaw --version看到类似openclaw 2026.x.x的版本号即可。如果提示openclaw不是内部或外部命令关闭 PowerShell 重新打开一次让 PATH 生效。3.2 配置文件放在哪OpenClaw 在 Windows 下的配置目录通常是%USERPROFILE%\.openclaw\。你可以在 PowerShell 里直接打开cd $env:USERPROFILE\.openclaw dir如果目录不存在先手动创建mkdir $env:USERPROFILE\.openclaw接下来要写两个文件settings.json负责模型 provider 和认证config.toml负责运行时行为和默认模型。下面给出可复制骨架。3.3 settings.json 可复制骨架{ providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 把你的TaoToken Key粘贴到这里, models: { glm-5.0: { id: glm-5.0, contextWindow: 128000, maxOutputTokens: 8192 } } } }, defaultProvider: taotoken, defaultModel: glm-5.0 }关键点说明type用openai-compatible因为 TaoToken 的 API 路径兼容 OpenAI 格式baseUrl填https://taotoken.net/api不要多加/v1或结尾斜杠apiKey就是你在上一步创建的那串字符models里的id是请求时传给服务端的模型名这里用glm-5.0。3.4 config.toml 可复制骨架[gateway] port 18789 host 127.0.0.1 [agent] default_model glm-5.0 provider taotoken max_turns 20 timeout_seconds 120 [logging] level info file openclaw.log [skills] enabled false [hooks] enabled falsegateway.port默认 18789如果被占用可以改成 18790 或其他空闲端口。agent.default_model和settings.json里的defaultModel保持一致避免启动时找不到模型。skills和hooks先关掉减少首次启动的变量。提示两个文件都保存为 UTF-8 无 BOM 格式。用 VS Code 或 Notepad 编辑时注意编码选项Windows 记事本有时会加 BOM 导致 JSON 解析失败。4. 启动验证从 Gateway 到第一次对话4.1 启动 OpenClaw Gateway在 PowerShell 里执行openclaw onboard --install-daemon如果你已经手动写好配置文件也可以直接启动openclaw gateway start启动后观察终端输出正常会看到类似Gateway listening on http://127.0.0.1:18789 Provider: taotoken Model: glm-5.0如果看到Provider: taotoken和Model: glm-5.0说明配置被正确读取。然后打开浏览器访问http://127.0.0.1:18789应该能看到 OpenClaw 的 TUI 或 Web 界面。4.2 发一条验证请求在界面输入框里发一句简单的话比如“用 Python 写一个读取 CSV 并打印前五行的脚本”。如果配置正确GLM 5.0 会返回代码和解释。你也可以用命令行直接测 API 通道是否通curl -X POST https://taotoken.net/api/chat/completions -H Authorization: Bearer 你的TaoToken Key -H Content-Type: application/json -d {\model\:\glm-5.0\,\messages\:[{\role\:\user\,\content\:\你好\}]}如果返回 JSON 里有choices字段和内容说明 TaoToken 到 GLM 5.0 的链路是通的。这一步能帮你区分是 OpenClaw 配置问题还是 API 通道问题。4.3 确认模型对话正常回到 OpenClaw 界面如果智能体回复了内容并且你能继续追问、让它执行文件操作说明整条链路跑通。此时你可以尝试让它“在当前目录创建一个 test.txt 并写入 hello”观察它是否真的调用了文件写入能力。这一步验证的是 OpenClaw 的执行层而不仅仅是聊天层。如果你想单独测试模型对话效果也可以直接访问 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在网页里选 GLM 5.0 发消息对比一下返回质量。5. 本篇常见报错与排查动作5.1 PowerShell 禁止运行脚本报错信息通常是“无法加载文件因为在此系统上禁止运行脚本”。解决方式是确认以管理员身份运行 PowerShell然后重新执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force执行后输入Y确认。如果公司电脑有组策略限制可能需要联系 IT 放开或者改用-Scope Process只对当前会话生效。5.2 npm 安装慢或超时表现是npm install -g openclawlatest卡住不动或报ETIMEDOUT。先切镜像npm config set registry https://registry.npmmirror.com npm config get registry确认输出是https://registry.npmmirror.com后重新安装。如果仍然慢检查是否有本地网络策略限制不要使用任何非正规的网络加速手段。5.3 API Key 无效或 401OpenClaw 启动后发消息报401 Unauthorized或invalid api key。排查顺序第一检查settings.json里apiKey字段是否有多余空格或换行第二确认 Key 没有过期或被删除可以到 https://taotoken.net/api-keys 查看状态第三确认baseUrl是https://taotoken.net/api没有拼错或多加路径。5.4 Gateway 启动失败或端口占用报错可能是EADDRINUSE或port 18789 already in use。用下面命令查占用netstat -ano | findstr :18789找到 PID 后可以在任务管理器里结束对应进程或者把config.toml里的port改成 18790 再启动。改完端口后浏览器访问地址也要同步改成http://127.0.0.1:18790。5.5 模型名不识别如果报model not found或unknown model检查settings.json里models下的键名和config.toml里default_model是否一致。TaoToken 侧支持的模型名以接入文档为准可以到 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 核对当前可用的模型标识。如果 GLM 5.0 的标识有更新以文档为准替换。6. 配好之后怎么把这套环境用起来一次配置成功之后你后续换模型只需要改settings.json里的models和defaultModelKey 和 baseUrl 都不用动。如果你要跑长期编码任务或 Agent 工作流建议把 Coding Plan 开起来入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它针对高频调用做了额度优化。日常排查接入问题优先看 API Keys 页面和接入文档https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 与 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。实测下来最容易翻车的不是安装而是配置文件里的空格和路径。建议你每次改完settings.json后先用curl测一次 API 通道再启动 OpenClaw这样能把问题定位在更小的范围内。跑通之后把两个配置文件备份一份下次重装或换机器直接复制五分钟就能恢复环境。