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 安装程序（.msi，64 位），安装时保持默认勾选「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 git@github.com:执行后无输出就是成功。这一步很多人跳过，结果 npm 安装时报spawn git失败，回头查半天。
3. TaoToken 前置：先把统一 Key 拿到手
在接 OpenClaw 之前，建议先把模型通道准备好。TaoToken 提供统一的 API Key 和兼容接口，好处是你不用为每个工具单独申请一套凭证，OpenClaw、其他编码工具、脚本调用都能共用同一个 Key，换模型只改一个模型名。
先到官网注册并登录：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
登录后进入控制台创建 API Key，入口在这里：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite
创建完把 Key 复制出来，形如sk-xxxx，先存到记事本，后面配置要用。API 基础地址是：
https://taotoken.net/api注意这个地址后面不加 UTM 参数，配置里填干净的就行。如果你后面要长期跑编码任务或 Agent，可以了解下 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite
想先在网页里验证模型通不通，可以用模型对话页：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=model&utm_campaign=rewrite
Key 管理页也再放一次，方便你回头找：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite
4. 安装 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填你刚创建的 Key，model填你想用的模型名。本地兜底那段指向 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. 启动自检与请求验证
配置写完，启动 OpenClaw：
openclaw 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 接口返回 401：Key 复制错了或带了空格。重新去 API Keys 页面复制，注意别把前后空白带进去。
模型名报 not found：配置里的模型名和实际可调用的不一致。先去模型对话页确认可用模型名，再回填配置。
本地兜底 404：Ollama 的兼容端点要带/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_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite
接入文档在这里，配置字段有更新时以文档为准：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite
Key 管理和新建入口：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite
最后提醒一句：配置文件里的 Key 别提交到 Git 仓库，本地留好就行。整套流程里最容易翻车的是前置环境和 Git 协议那一步，先把这两块确认干净，后面基本一路顺。
