1. 为什么零基础装 OpenClaw 总卡在第一步OpenClaw 是一个跑在终端里的 AI 编程助手能读写文件、执行命令、调用工具适合想让 AI 直接动手改代码的人。它本身只是个壳真正干活的是背后接的大模型。所以安装 OpenClaw 其实分两件事装客户端、接模型。小白最容易翻车的地方不是 npm 命令敲错而是模型通道没配好装完了打开一片空白或者一直转圈连不上。我见过太多人卡在装完不会接模型这一步。本地 ollama 拉个模型能跑但能力有限想用云端更强的模型又得去各家平台注册、充值、复制 Key一个 Key 管一个平台切来切去头都大了。这篇就解决这个问题用 TaoToken 一个统一 Key同时打通 ollama 本地模型和云端 API 通道在 OpenClaw 里随时切换一次跑通对话。适合谁看Windows 电脑、没写过几行代码、想体验 AI 编程助手但不想折腾一堆账号的人。全程只需要 PowerShell 和一个浏览器跟着敲就行。下面从环境准备讲到配置验证每一步都有完整命令和预期结果。2. 装 OpenClaw 前先把 TaoToken 的 Key 拿到TaoToken 在这里的角色是统一模型入口。你可以把它理解成一个总闸本地 ollama 是一个水源云端各种大模型是另外几个水源TaoToken 帮你把云端这些水源接到一根管子上OpenClaw 只需要认这一根管子。这样你就不用为每个模型平台单独配 Key。先注册并登录官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。登录后进控制台找到 API Keys 页面创建一个新 Key复制保存好后面配置要用。这个 Key 就是 OpenClaw 访问云端模型的凭证。创建 Key 的直达入口在控制台里https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API Keys 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你后面想长期用 OpenClaw 写代码、跑 Agent 任务可以顺便看下 Coding Plan它按套餐解决模型调用比单次充值省心https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注意Key 只在创建时完整显示一次关掉页面就看不到了务必先粘到记事本里。别把 Key 直接发到群里或截图泄露了要去控制台删掉重建。TaoToken 的 API 基础地址是 https://taotoken.net/api 这个地址不加任何参数配置时原样填。模型名、可用通道这些信息可以在接入文档里查https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。3. Windows 上装 ollama 和 OpenClaw 的完整命令3.1 先装 Node.js 和 ollamaOpenClaw 通过 npm 分发所以先要有 Node.js。去 nodejs.org 下 LTS 版一路下一步装完。装完打开 PowerShell普通权限即可后面有需要再提权验证node -v npm -v能打印出版本号就说明环境 OK。如果提示不是内部或外部命令说明没装好或者没重启终端重开一个 PowerShell 再试。接着装 ollama。去 https://ollama.com/download 点 Download for Windows下载 OllamaSetup.exe双击安装。装完 ollama 会自动在后台跑一个服务。验证ollama -v然后拉一个本地模型7B 或 8B 对 16GB 内存的机器比较友好ollama pull qwen2.5:7b下载要几分钟到十几分钟取决于网速模型文件几个 GB。拉完可以用ollama list看到它。3.2 用 npm 装 OpenClaw回到 PowerShell全局安装 OpenClawnpm install -g openclaw如果报权限错误用管理员身份重开 PowerShell 再执行。装完验证openclaw --version有版本号输出就成功了。第一次运行openclaw时它会引导你初始化配置生成一个 config.toml 文件通常在用户目录下的.openclaw文件夹里。Windows 路径大概是C:\Users\你的用户名\.openclaw\config.toml。3.3 config.toml 骨架长什么样这个文件是 OpenClaw 的核心配置决定它用哪个模型、走哪个通道。下面是一个能同时容纳 ollama 本地和 TaoToken 云端的骨架你可以直接照着改# OpenClaw 主配置 [default] # 默认使用哪个 provider可切换为 taotoken 或 ollama provider taotoken model claude-3-5-sonnet [providers.ollama] type openai-compatible base_url http://localhost:11434/v1 api_key ollama model qwen2.5:7b [providers.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你从TaoToken复制的Key model claude-3-5-sonnet几个关键点解释一下。type统一写openai-compatible因为 ollama 和 TaoToken 都兼容 OpenAI 的接口格式OpenClaw 用同一套逻辑就能对接。base_url是接口地址ollama 本地默认监听 11434 端口TaoToken 填官方给的 https://taotoken.net/api 。api_key对 ollama 来说随便填个占位符就行它本地不校验TaoToken 这里必须填你真实复制的 Key。[default]段决定启动时默认走哪个通道。想默认用本地就写provider ollama想默认用云端就写provider taotoken。模型名要和对应 provider 支持的模型对得上云端具体有哪些模型名去接入文档里核对。4. 切换 ollama 与 API 通道并验证对话4.1 先验证本地 ollama 通道把 config.toml 的[default]改成[default] provider ollama model qwen2.5:7b保存后启动openclaw进入 TUI 界面后随便问一句你好帮我写个 Python 冒泡排序。如果本地模型正常几秒内会开始逐字输出。第一次加载模型会慢一点因为要把权重读进内存之后就快了。能正常回复说明 ollama 通道通了。4.2 再验证 TaoToken 云端通道退出 OpenClaw一般是 CtrlC 或输入退出命令把[default]改成[default] provider taotoken model claude-3-5-sonnet重新openclaw启动再问同样的问题。这次响应来自云端通常比本地 7B 模型更聪明代码质量也更高。如果这里报 401 或 403八成是 Key 填错了或者复制时带了空格回控制台重新复制一次。4.3 用一条命令快速测 API 是否通不想开 OpenClaw 也能单独测 TaoToken 通道用 curl 直接打接口curl https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer sk-你的Key -H Content-Type: application/json -d {\model\:\claude-3-5-sonnet\,\messages\:[{\role\:\user\,\content\:\说一句话证明你在线\}]}返回 JSON 里choices字段有内容就说明 Key 和地址都没问题问题只可能出在 OpenClaw 的配置写法上。这个排查思路很实用先确认通道本身通不通再查客户端配置。提示PowerShell 里 curl 是Invoke-WebRequest的别名多行参数用反引号换行。如果嫌麻烦把整条命令写成一行也行。5. 装完连不上这几个坑我替你踩过了第一个高频问题openclaw命令找不到。这通常是 npm 全局路径没进 PATH。执行npm config get prefix看下全局目录把它加到系统环境变量 Path 里重开终端。或者干脆用npx openclaw临时跑。第二个ollama 通道报连接拒绝。先确认 ollama 服务在跑浏览器打开 http://localhost:11434 能看到 Ollama is running 就正常。如果没反应去开始菜单手动启动 ollama或者命令行ollama serve。第三个TaoToken 通道报模型不存在。模型名必须和文档里列的一致大小写、连字符都不能错。别自己臆造模型名去接入文档复制。第四个config.toml 改了没生效。OpenClaw 有些版本会缓存配置改完要完全退出再启动不是热重载。另外注意 TOML 语法字符串要加引号段名用方括号缩进不影响但别写错括号。第五个中文乱码。Windows 终端默认编码可能是 GBK在 PowerShell 里先执行chcp 65001切到 UTF-8再启动 OpenClaw中文就正常了。如果以上都排查完还是不通直接去接入文档对照最新配置格式https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 文档会随接口更新比任何第三方教程都准。6. 想长期用就固定一套顺手的配置跑通之后建议把常用配置固化下来。我的习惯是默认走 TaoToken 云端通道因为写代码质量稳定偶尔断网或者想省额度时手动把[default]切到 ollama。切换成本就是改两行、重启一次一分钟的事。如果你打算把 OpenClaw 当日常编码助手甚至挂 Agent 自动跑任务那模型调用量会上来这时候 Coding Plan 比零散充值更划算套餐入口在这里https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。只是想先验证模型效果、对比不同模型输出用模型对话页面直接试更轻量https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后提醒一句config.toml 里那个 Key 等于你账号的通行证别把它提交到 Git 仓库也别写进公开的配置文件。本地自己用没问题一旦要分享配置先把 Key 换成占位符。装 OpenClaw 这件事难的不是命令是第一次把通道接对接对之后剩下的就是慢慢调教它帮你干活了。