（Windows）本地安装openclaw，完成配置并接入本地大模型（ollama）全流程指南：TaoToken 统一 Key 与 config.toml 骨架

1. Windows 上跑 openclaw ollama到底难在哪openclaw 是一个可以本地部署的 AI 助手网关它能对接云端 API也能对接你本机跑的大模型ollama 则是 Windows 上最省心的本地大模型运行工具一条命令就能把 qwen 系列模型拉下来跑起来。把这两个东西接在一起你就能得到一个完全跑在自己电脑上的对话入口数据不出本机断网也能用。适合谁适合想折腾本地 AI、又不想被各种 Key 和额度卡住的开发者尤其是手里有 16G 以上内存、装了独显或者能接受 CPU 推理慢一点的 Windows 用户。但真上手你会发现坑不少Node.js 版本不对导致 npm 全局安装失败、ollama 的/v1接口和 openclaw 的 provider 类型对不上、config.toml 里 endpoint 写错一个斜杠就连不上、API key 明明 ollama 不需要却被校验拦住。我试过在几台 Windows 机器上重复这套流程最耗时间的从来不是安装而是配置骨架写错之后的报错定位。这篇就按「环境准备 → 安装 openclaw → 写 config.toml → 接入 ollama → 验证对话 → 排错」的顺序走一遍同时把 TaoToken 的统一 Key 通道也接进来这样你本地模型和云端模型可以共用一套配置骨架后面想切模型只改几行。全程命令可直接复制配置文件给完整片段。2. 前置准备Node.js、ollama 与 TaoToken 统一 Key2.1 Node.js 环境openclaw 通过 npm 分发所以第一步是装 Node.js。去 Node.js 官网下载 Windows 安装包选 LTS 版本即可安装时勾选「Add to PATH」。装完用管理员权限打开 PowerShell 验证node -v npm -v正常会输出类似v22.x.x和10.x.x的版本号。如果提示「不是内部或外部命令」说明 PATH 没生效重开一个 PowerShell 窗口或者手动把 Node 安装目录加进系统环境变量。注意不要用太老的 Node比如 16 以下openclaw 的部分依赖要求 Node 18版本过低会在npm install -g阶段报 engine 不匹配。2.2 ollama 安装与模型拉取去 ollama 官网下载 Windows 安装包双击装完它会自动在后台起一个服务默认监听127.0.0.1:11434。打开一个新的 PowerShell 验证ollama -v ollama pull qwen2.5:7b ollama psollama ps会列出当前加载的模型全名比如qwen2.5:7b。这个名字后面要一字不差地填进 openclaw 的配置里写错一个字符就会报模型不存在。ollama 的 OpenAI 兼容接口地址是http://127.0.0.1:11434/v1注意结尾的/v1不能少openclaw 走的是 OpenAI 兼容协议靠这个路径区分。2.3 TaoToken 统一 Key 的作用本地 ollama 其实不需要真实 API key但 openclaw 的 provider 配置里这个字段不能为空随便填一串字符也能过。那为什么还要提 TaoToken因为实际用起来你往往不止一个模型本地 qwen 跑简单任务遇到复杂推理想切云端模型。如果每个 provider 都单独配 Key、单独记地址config.toml 会越来越乱。TaoToken 提供的是统一 Key 和统一 API 通道你可以在一个地方管理 Key然后让 openclaw 通过同一个 base_url 访问不同模型。它的 API 地址是https://taotoken.net/api控制台在https://taotoken.net/consoleKey 在https://taotoken.net/api-keys生成。这样你的 config.toml 里可以同时保留本地 ollama 端点和 TaoToken 端点切换时只改默认模型指向。3. 安装 openclaw 并生成 config.toml 骨架3.1 全局安装用管理员权限打开 PowerShell执行npm install -g openclawlatest等它跑完验证openclaw --version有版本号输出就说明装好了。如果卡在下载阶段多半是 npm 源慢可以临时切到国内镜像npm config set registry https://registry.npmmirror.com装完再切回来也行或者保持镜像源不影响使用。3.2 初始化配置openclaw 的配置走 onboard 流程但为了让你看清结构我建议先手动建好 config.toml 再启动。默认配置目录在用户目录下C:\Users\你的用户名\.openclaw\config.toml如果目录不存在就手动建。下面是一份可直接用的骨架包含本地 ollama 和 TaoToken 两个 provider# ~/.openclaw/config.toml default_provider ollama-local [providers.ollama-local] type openai-compatible base_url http://127.0.0.1:11434/v1 api_key ollama default_model qwen2.5:7b [providers.taotoken] type openai-compatible base_url https://taotoken.net/api api_key 你的_TaoToken_Key default_model claude-sonnet-4-20250514 [gateway] host 127.0.0.1 port 8787几个关键点解释一下。type必须写openai-compatible因为 ollama 的/v1就是标准 OpenAI 格式选错类型会直接连不上。base_url结尾不要多加斜杠http://127.0.0.1:11434/v1/这种多一个斜杠在某些版本会拼出双斜杠导致 404。api_key对 ollama 来说随便填但字段不能省。default_model要和ollama ps显示的全名完全一致。提示TaoToken 的 Key 建议单独放环境变量再引用避免明文写在配置文件里。openclaw 支持${ENV_VAR}语法写成api_key ${TAOTOKEN_KEY}也行。3.3 启动网关配置写好后启动openclaw gateway run第一次启动它会读 config.toml加载 provider。看到类似gateway listening on 127.0.0.1:8787就说明起来了。如果端口被占用改 config.toml 里的 port 再重启。4. 验证请求从命令行到对话闭环4.1 命令行验证 ollama 端点先确认 ollama 本身能被 OpenAI 协议访问用 curl 测一下curl http://127.0.0.1:11434/v1/chat/completions -H Content-Type: application/json -d {\model\:\qwen2.5:7b\,\messages\:[{\role\:\user\,\content\:\你好\}]}能返回一段 JSON 带choices字段就说明 ollama 侧没问题。如果这里就报错先解决 ollama别急着调 openclaw。4.2 通过 openclaw 发起对话网关起来后另开一个 PowerShell 窗口openclaw chat --provider ollama-local --message 用一句话解释什么是本地大模型如果配置正确你会看到模型返回的中文回答。这一步跑通说明 openclaw → ollama 的链路完整了。4.3 切换到 TaoToken 端点想验证云端通道把 provider 换成 taotokenopenclaw chat --provider taotoken --message 你好测试统一 Key 通道返回正常就说明 TaoToken 的 Key 和 base_url 都配对了。你也可以打开模型对话页面https://taotoken.net/models直接在网页里对比同一个问题的输出确认通道一致。4.4 打开 Dashboardopenclaw 自带一个 Control UI执行openclaw dashboard它会自动带 token 打开浏览器跳到已授权的页面。如果提示 token_missing说明网关没起或者 token 没生成先openclaw gateway status看状态再openclaw gateway stop然后openclaw gateway run重启。5. 本篇常见报错排查5.1 npm install 报 EACCES 或权限错误Windows 上全局安装偶尔会因为目录权限失败。解决办法是用管理员权限开 PowerShell或者改 npm 全局目录到用户目录npm config set prefix C:\Users\你的用户名\npm-global然后把C:\Users\你的用户名\npm-global加进 PATH重开终端再装。5.2 连接 ollama 报 ECONNREFUSED这个报错基本是 ollama 服务没起或者地址写错。先确认ollama ps如果命令本身报错说明 ollama 没装好或没启动。如果ollama ps正常但 openclaw 连不上检查 config.toml 里的base_url是不是http://127.0.0.1:11434/v1别写成localhost某些环境解析到 IPv6 会失败也别漏了/v1。5.3 报 model not found模型名和ollama ps显示的不一致。比如你拉的是qwen2.5:7b配置里写成qwen2.5就会报错。ollama 的模型名带 tag必须完整。改完 config.toml 记得重启网关。5.4 返回 404 或路径错误多半是 base_url 结尾多了斜杠或者 provider type 写成了别的。确认type openai-compatiblebase_url结尾是/v1不带斜杠。5.5 TaoToken 通道报 401Key 无效或没填对。去https://taotoken.net/api-keys重新生成一个确认复制时没有多余空格。如果用了环境变量引用确认变量名拼写一致且启动网关的终端里能读到这个变量。5.6 网关端口冲突openclaw gateway run报端口被占用改 config.toml 里的port比如改成 8788然后重启。也可以用openclaw gateway stop先停掉旧进程。6. 后续怎么用本地与云端共存的配置思路这套骨架跑通后你手里其实有了一个可扩展的模型网关。本地 ollama 负责隐私敏感、断网可用的场景TaoToken 通道负责需要更强推理能力的任务。config.toml 里加新模型就是复制一段 provider 块改base_url、api_key、default_model三处。如果你打算长期用 openclaw 做编码助手或者接 Agent 工作流建议把 TaoToken 的 Coding Plan 也了解一下地址在https://taotoken.net/coding-plan它针对长时间编码场景做了额度优化配合 openclaw 的 provider 配置可以直接用。接入文档在https://taotoken.net/doc里面有各语言 SDK 的调用示例想自己写脚本调模型的时候能省不少事。最后提醒一句改完 config.toml 一定要重启网关openclaw 不会热加载配置。每次改完先openclaw gateway stop再openclaw gateway run然后openclaw gateway status确认状态这三步养成习惯能省掉一半的「明明改了却没生效」的困惑。