1. OpenClaw 装完为什么还是不能用
OpenClaw 安装方法在 Windows 上其实就两条命令的事,但很多人卡在最后一步:openclaw --version已经打印出2026.x.xx,终端里敲openclaw也能进交互界面,可一旦让它回答问题或者跑 Agent 任务,就报模型不可用、请求超时、provider 未配置。原因不复杂——OpenClaw 本体只是一个调度壳子,它自己不产出任何 Token,真正干活的是背后挂载的模型通道。安装脚本只负责把 CLI 和运行时铺好,不会替你选模型入口,也不会替你填接口地址和密钥。
我见过太多人装完之后在配置文件里翻来翻去,试图找一个"默认模型"开关,结果发现 OpenClaw 的 provider 配置是空的,或者指向一个根本没配好的本地推理后端。这时候正确的补法不是继续折腾安装,而是把模型通道单独接出来。这篇就按"安装照旧、通道补一步"的思路写:Windows 的 npm 安装流程、EPERM 报错怎么绕、mac/linux 的一行脚本,这些保持原样;重点放在装完之后,把 OpenClaw 的模型 provider 指向 TaoToken,让对话和 Agent 请求统一从这条通道出去,装完立刻能发一次真实请求验证。
适合谁看:已经在 Windows 10/11、Linux 或 macOS 上把 OpenClaw 装起来、--version能出号,但模型调用还没通的人。如果你连安装都还没过,前半段照抄命令即可,后半段才是这篇真正要补的那一步。
2. 先把 OpenClaw 安装这步走完
2.1 Windows 下的 npm 安装与 EPERM 绕行
Windows 上用管理员模式打开 cmd,执行下面这条。加--registry是为了走国内镜像,避免拉包时卡在网络上:
npm i -g openclaw@latest --registry=https://registry.npmmirror.com如果这条顺利跑完,直接跳到 2.3 检查版本。但实测下来,相当一部分机器会在这里翻车,典型报错是EPERM: operation not permitted, rmdir,路径指向node_modules\openclaw\node_modules\@slack\web-api\dist\types这类目录。这个错的本质是 npm 在清理旧目录时权限不够,跟 OpenClaw 本身没关系。
紧接着还会看到node-llama-cpp的 postinstall 阶段在克隆ggml-org/llama.cpp,克隆到 100% 之后开始下载 cmake,然后报Failed to download cmake,再退化成从源码构建,最后抛出ERR_DLOPEN_FAILED和一个SpawnError,退出码是4294963238。这一串看着吓人,其实就是本地推理后端的预编译二进制没加载成功、cmake 又没下下来。你如果不需要本地跑 llama.cpp,完全可以让它跳过脚本:
npm i -g openclaw --ignore-scripts --registry=https://registry.npmmirror.com--ignore-scripts会跳过 postinstall,node-llama-cpp那套克隆和编译就不会触发,EPERM 的清理动作也一并绕开。代价是本地推理能力不装,但既然模型通道要走 TaoToken,本地那套本来也用不上。这一步是整篇安装里最容易被卡住的地方,记住"报 EPERM 或 cmake 失败就换带--ignore-scripts的那条"即可。
2.2 mac/linux 一行脚本
mac 和 linux 简单得多,终端里执行:
curl -fsSL https://openclaw.ai/install.sh | bash过程中会打印一些警告,比如依赖版本提示、路径提示,这些不用理,只要最后没有Error级别的中断就算过。脚本跑完同样进入 2.3 验证。
2.3 确认安装成功
不管哪个平台,装完都在终端敲:
openclaw --version出现2026.x.xx这样的版本号,说明 CLI 本体已经就位。到这一步,原教程就结束了,但 OpenClaw 此时还是个空壳——它能启动,却没有可用的模型通道。下面这步才是让它可以真正对话的关键。
3. 补上模型通道:把 provider 指向 TaoToken
3.1 创建一把 Key
打开https://taotoken.net/?utm_source=taotoken_aicg_blog_end注册账号,进控制台后到 API Keys 页面创建一把新 Key。创建完立刻复制保存,页面刷新后通常不再完整显示。这把 Key 就是 OpenClaw 调用模型时的凭证,后面要填进 provider 配置里。
如果你更习惯直接进控制台操作,可以走这个入口:https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite,Key 管理在左侧菜单的 API Keys 里。创建时给个能认出来的名字,比如openclaw-local,方便以后区分。
3.2 接口地址与参数对照
OpenClaw 的模型 provider 配置里,核心就两个字段:接口地址和 Key。地址填https://taotoken.net/api,注意这里不带/v1,也不加任何 UTM 参数。很多人习惯性补/v1,结果请求打到不存在的路径上,报 404 或者连接被拒。Key 就填 3.1 里创建的那把。
| 配置项 | 填写值 | 说明 |
|---|---|---|
| provider 类型 | OpenAI 兼容 | OpenClaw 走标准 chat completions 协议 |
| 接口地址 / baseURL | https://taotoken.net/api | 不带/v1,不带 UTM |
| API Key | 刚创建的那把 | 形如sk-开头 |
| 模型名 | 按需选择 | 填控制台里可用的模型标识 |
注意:地址末尾不要带斜杠,也不要拼
/v1/chat/completions这种完整路径。OpenClaw 会自己在 baseURL 后面拼接口路径,你多写一段就会拼出双份,直接 404。
3.3 写进 OpenClaw 的 provider 配置
OpenClaw 的 provider 配置一般在用户目录下的配置文件中,具体路径随版本略有差异,可以用openclaw config path之类的子命令查,或者直接看安装后提示的配置目录。找到 provider 或 models 段落,按下面的结构填:
{ "providers": { "taotoken": { "type": "openai-compatible", "baseURL": "https://taotoken.net/api", "apiKey": "sk-你的Key", "models": { "default": "你选定的模型标识" } } }, "defaultProvider": "taotoken" }字段名不同版本可能叫baseUrl、api_base或endpoint,认准"接口地址"这个语义填https://taotoken.net/api就行。defaultProvider指向taotoken,这样 OpenClaw 启动后默认就走这条通道,不用每次手动切。
如果你更想用环境变量方式注入,也可以设:
export OPENAI_BASE_URL=https://taotoken.net/api export OPENAI_API_KEY=sk-你的KeyOpenClaw 在 provider 未显式配置时会读这两个变量。Windows 下用set或系统环境变量面板设置,效果一样。
4. 发一次真实请求验证通道
配置写完,别急着关终端,直接发一次请求确认通道是通的。最直接的方式是用 curl 打一发 chat completions:
curl https://taotoken.net/api/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的Key" \ -d '{ "model": "你选定的模型标识", "messages": [{"role": "user", "content": "用一句话说明你已连通"}] }'返回里出现choices数组和一段正常回复,说明 Key 和地址都没问题。如果返回 401,是 Key 填错或没带上;返回 404,多半是地址多写了/v1;返回 429,是额度或频率问题,去控制台看一眼。
curl 通了之后,回到 OpenClaw 里跑一次真实对话:
openclaw "帮我列三条今天可以做的待办"能正常出内容,就说明 OpenClaw 的对话请求已经统一从 TaoToken 通道出去了。再试一个 Agent 任务,比如让它读一个本地文件并总结,确认 Agent 链路也走通。两条都过,安装加通道这整套就算闭环了。
5. 本篇常见错排查
EPERM rmdir 反复出现:说明 npm 在清理旧目录,权限不够。除了换--ignore-scripts,也可以先手动删掉node_modules\openclaw再重装,或者确认 cmd 是管理员模式。nvm 管理的 Node 有时会有路径占用,关掉其他占用该目录的进程再试。
node-llama-cpp 下载 cmake 失败:这是 postinstall 在拉本地推理依赖,跟模型通道无关。带--ignore-scripts重装即可跳过。如果你确实需要本地推理,再单独处理 cmake 环境,但走 TaoToken 通道的话不需要。
openclaw --version 没输出或报 command not found:npm 全局 bin 目录没进 PATH。用npm config get prefix看全局路径,把它加到系统 PATH 里,重开终端再试。
配置写完仍报 provider 未配置:检查defaultProvider是否拼写一致,provider 名字和引用名要完全对应。JSON 里多一个逗号或少一个引号都会导致整段配置被忽略,用openclaw config validate之类的命令校验一下。
请求返回 404:九成是 baseURL 多写了/v1。OpenClaw 会自己拼路径,你只填到https://taotoken.net/api为止。带 UTM 参数也会导致路径不匹配,地址栏里那串?utm_source=...是给网页用的,不要填进配置。
返回 401 Unauthorized:Key 复制时带了空格,或者用了已删除的 Key。重新创建一把,注意Bearer后面有一个空格。
6. 装完之后怎么继续用
安装这步走完、通道接上之后,OpenClaw 才算真正可用。日常用的时候,对话和 Agent 请求都会从 TaoToken 这条通道出去,你不需要每次改配置。如果后面要换模型,只改 provider 里的模型标识即可,地址和 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/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite。Key 管理和接入文档分别在https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite和https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite,配置字段对不上时翻文档比猜快。
最后提醒一句:安装阶段照原流程走,EPERM 就换--ignore-scripts;模型阶段只认https://taotoken.net/api这个地址,不带/v1、不带 UTM。这两条守住,OpenClaw 从装好到能真实对话,中间不会再卡。