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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。登录后进控制台，找到 API Keys 页面创建一个新 Key，复制保存好，后面配置要用。这个 Key 就是 OpenClaw 访问云端模型的凭证。

创建 Key 的直达入口在控制台里：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API Keys 管理页：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。如果你后面想长期用 OpenClaw 写代码、跑 Agent 任务，可以顺便看下 Coding Plan，它按套餐解决模型调用，比单次充值省心：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

注意：Key 只在创建时完整显示一次，关掉页面就看不到了，务必先粘到记事本里。别把 Key 直接发到群里或截图，泄露了要去控制台删掉重建。

TaoToken 的 API 基础地址是 https://taotoken.net/api ，这个地址不加任何参数，配置时原样填。模型名、可用通道这些信息可以在接入文档里查：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

3. Windows 上装 ollama 和 OpenClaw 的完整命令

3.1 先装 Node.js 和 ollama

OpenClaw 通过 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，全局安装 OpenClaw：

npm 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（一般是 Ctrl+C 或输入退出命令），把[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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，文档会随接口更新，比任何第三方教程都准。

6. 想长期用就固定一套顺手的配置

跑通之后，建议把常用配置固化下来。我的习惯是默认走 TaoToken 云端通道，因为写代码质量稳定；偶尔断网或者想省额度时，手动把[default]切到 ollama。切换成本就是改两行、重启一次，一分钟的事。

如果你打算把 OpenClaw 当日常编码助手，甚至挂 Agent 自动跑任务，那模型调用量会上来，这时候 Coding Plan 比零散充值更划算，套餐入口在这里：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。只是想先验证模型效果、对比不同模型输出，用模型对话页面直接试更轻量：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

最后提醒一句：config.toml 里那个 Key 等于你账号的通行证，别把它提交到 Git 仓库，也别写进公开的配置文件。本地自己用没问题，一旦要分享配置，先把 Key 换成占位符。装 OpenClaw 这件事，难的不是命令，是第一次把通道接对；接对之后，剩下的就是慢慢调教它帮你干活了。