Windows 下 Ollama 安装 OpenClaw 完整教程：TaoToken 统一 Key 配置与验证

1. Windows 上跑 OpenClaw 到底卡在哪如果你在 Windows 上搜「Ollama 安装 OpenClaw」大概率已经踩过几个坑Node.js 版本不够、Git 的 SSH 协议拉依赖直接报错、Ollama 装完不知道下一步点哪里、浏览器打开 127.0.0.1:18789 一片空白。这篇就把这条链路从头到尾走一遍目标很明确——让 OpenClaw 在你本机跑起来并且用 TaoToken 的统一 Key 把模型通道接上后面换模型、换项目都不用再改一堆配置。OpenClaw 是一个本地运行的 AI 编码助手类工具它本身不绑定某一家模型而是通过配置去调用模型服务。Ollama 在这里扮演的是「本地模型运行时」的角色负责把模型拉下来、跑起来、暴露一个本地接口。两者配合你就能在 Windows 上拥有一个不依赖特定客户端的编码助手环境。适合谁看刚接触本地大模型、想在 Windows 上把工具链跑通的新手已经装了 Ollama 但 OpenClaw 起不来的同学以及想把模型调用统一到一个 Key 上、不想每个工具单独配一遍的开发者。整篇按「前置环境 → Ollama → OpenClaw → 统一 Key 接入 → 验证 → 排障」的顺序走命令都可以直接复制。2. 前置环境Node.js 与 Git 别偷懒OpenClaw 依赖 Node.js 和 Git这两个不达标后面全是连锁报错。Node.js 要求 22.x 及以上npm 要求 11.11 及以上。先去 Node.js 官网下载 Windows 安装程序.msi64 位安装时保持默认勾选「Add to PATH」路径别带中文。装完按 Win R 输入 cmd执行node -v npm -v正常会输出类似v22.14.0和11.11.0。如果提示「不是内部或外部命令」说明 PATH 没生效重启命令行或重新安装并确认勾选。版本低了直接覆盖安装新版即可不用先卸载。Git 去官网下载 Windows 版安装到「Adjusting your PATH environment」这一步时选「Git from the command line and also from 3rd-party software」其余默认。装完执行一条关键配置把 SSH 协议替换成 HTTPS避免拉依赖时权限报错git config --global url.https://github.com/.insteadOf gitgithub.com:执行后无输出就是成功。这一步很多人跳过结果 npm 安装时报spawn git失败回头查半天。3. TaoToken 前置先把统一 Key 拿到手在接 OpenClaw 之前建议先把模型通道准备好。TaoToken 提供统一的 API Key 和兼容接口好处是你不用为每个工具单独申请一套凭证OpenClaw、其他编码工具、脚本调用都能共用同一个 Key换模型只改一个模型名。先到官网注册并登录https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content登录后进入控制台创建 API Key入口在这里https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite创建完把 Key 复制出来形如sk-xxxx先存到记事本后面配置要用。API 基础地址是https://taotoken.net/api注意这个地址后面不加 UTM 参数配置里填干净的就行。如果你后面要长期跑编码任务或 Agent可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite想先在网页里验证模型通不通可以用模型对话页https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelutm_campaignrewriteKey 管理页也再放一次方便你回头找https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite4. 安装 Ollama 并拉取模型去 Ollama 官网下载 Windows 安装包OllamaSetup.exe双击按提示装完默认路径即可。装完 Ollama 会在后台起一个本地服务默认监听 11434 端口。打开命令行验证ollama -v有版本号输出说明装好了。接着拉一个模型比如ollama pull qwen2.5-coder:7b拉取时间取决于网速和模型大小7B 量化版大概几个 GB。拉完确认模型在列表里ollama list再确认本地服务能响应curl http://127.0.0.1:11434/api/tags返回 JSON 里能看到模型名说明 Ollama 这条链路通了。如果你的机器显卡一般选小一点的量化模型显存够再上更大的。Ollama 的接口是 OpenAI 兼容风格的这一点对后面接 OpenClaw 很关键。5. 安装 OpenClaw 并写配置骨架OpenClaw 通过 npm 全局安装npm install -g openclaw如果报 npm 版本过低按提示先npm update -g npm再重试。装完验证openclaw --version接下来是配置。OpenClaw 一般读取用户目录下的配置文件Windows 下通常在C:\Users\你的用户名\.openclaw\目录。先建目录再写settings.json骨架{ provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514, localFallback: { enabled: true, baseUrl: http://127.0.0.1:11434/v1, model: qwen2.5-coder:7b } }这里的设计思路是主通道走 TaoToken 的统一接口本地 Ollama 作为兜底。baseUrl填 TaoToken 的 API 地址apiKey填你刚创建的 Keymodel填你想用的模型名。本地兜底那段指向 Ollama 的 OpenAI 兼容端点/v1。如果你更习惯用 TOML 风格可以写config.toml[provider] type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model claude-sonnet-4-20250514 [local_fallback] enabled true base_url http://127.0.0.1:11434/v1 model qwen2.5-coder:7b两个文件按 OpenClaw 实际读取的那个来别同时写冲突。配置里的模型名要和你实际能调用的模型一致不确定就先在模型对话页试一下。6. 启动自检与请求验证配置写完启动 OpenClawopenclaw start正常会看到服务启动日志默认监听 18789 端口。打开浏览器访问http://127.0.0.1:18789能看到操作界面就说明起来了。如果界面空白先看命令行窗口有没有报错别急着关。接着验证模型通道。用 curl 直接打 TaoToken 的接口确认 Key 和地址没问题curl https://taotoken.net/api/v1/chat/completions ^ -H Authorization: Bearer sk-你的TaoToken密钥 ^ -H Content-Type: application/json ^ -d {\model\:\claude-sonnet-4-20250514\,\messages\:[{\role\:\user\,\content\:\ping\}]}Windows 命令行换行用^如果你用 PowerShell换成反引号或直接写成一行。返回里有choices字段和内容说明统一 Key 通道通了。再验证本地 Ollama 兜底curl http://127.0.0.1:11434/v1/chat/completions ^ -H Content-Type: application/json ^ -d {\model\:\qwen2.5-coder:7b\,\messages\:[{\role\:\user\,\content\:\ping\}]}两条都通OpenClaw 里切换主备通道就不会翻车。回到 OpenClaw 界面发一条测试消息能正常返回就完整跑通了。7. 本篇常见报错排查npm 安装报 spawn git 失败Git 没装或 PATH 没生效。重开命令行确认git --version有输出并检查前面那条 HTTPS 替换配置是否执行过。访问 127.0.0.1:18789 打不开OpenClaw 进程没起来或端口被占。看命令行有没有running提示用netstat -ano | findstr 18789查端口占用必要时换端口。Node.js 版本验证不通过低于 22 就覆盖安装新版装完重开命令行再验。Ollama 拉模型卡住或超时换小一点的量化模型或检查磁盘空间。拉完用ollama list确认。TaoToken 接口返回 401Key 复制错了或带了空格。重新去 API Keys 页面复制注意别把前后空白带进去。模型名报 not found配置里的模型名和实际可调用的不一致。先去模型对话页确认可用模型名再回填配置。本地兜底 404Ollama 的兼容端点要带/v1别只写http://127.0.0.1:11434。8. 后续怎么用这套环境跑通之后日常就是ollama serve保证本地服务在openclaw start起助手模型通道走 TaoToken 统一 Key。想换模型只改配置里的model字段不用动 Key 和地址。本地兜底那段建议保留断网或主通道波动时还能用本地模型顶一下。如果你要把这套接进更长的编码流程或 Agent 任务Coding Plan 那条线可以看看https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入文档在这里配置字段有更新时以文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteKey 管理和新建入口https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite最后提醒一句配置文件里的 Key 别提交到 Git 仓库本地留好就行。整套流程里最容易翻车的是前置环境和 Git 协议那一步先把这两块确认干净后面基本一路顺。