企业官网建设流程全解析

1. Windows 装 Openclaw 到底卡在哪：从 Git 到 pnpm 的真实链路

Openclaw 是一个跑在本地、通过命令行驱动的 AI Agent 网关工具，它能让你用统一入口调度不同模型完成编码、联网检索、文件操作这类任务，适合想在 Windows 上折腾本地 Agent、又不想被各种环境问题劝退的开发者。很多人第一次装它，卡住的地方往往不是 Openclaw 本身，而是前面那串依赖：Git 没配好、Node.js 版本不对、pnpm 装完跑不起来、依赖拉取超时，最后连node openclaw.mjs --version都出不来结果。

我自己在 Windows 上完整走了一遍这条链路，踩过的坑集中在三个地方：一是 Git 残留的代理配置导致后续拉包失败，二是 PowerShell 默认禁止脚本执行让 pnpm 装不上，三是 npm 默认源在国内网络下慢到怀疑人生。这篇就把从 Git、Node.js 到 pnpm 的每一步拆开，再补上 TaoToken 统一 Key 和 API 通道的接入配置，让你装完之后 Openclaw 能真正调通模型，而不是停在「装好了但用不了」。

整条链路的目标很明确：装好 Git 用来拉源码，装好 Node.js 作为运行时，用 pnpm 管理依赖，把 Openclaw 跑起来，最后通过 TaoToken 的 API 通道让 Openclaw 能正常请求模型。下面按顺序来，每一步都给可复制的命令和预期结果。

2. 前置准备：Git、Node.js 与 TaoToken 通道的安装顺序

这一节把「装什么、从哪装、装完怎么确认」讲清楚。顺序不能乱，因为 pnpm 依赖 Node.js，Openclaw 依赖 pnpm，而模型调用依赖 TaoToken 的 Key 和 Base URL。

2.1 安装 Git 并清理历史代理配置

Git 的作用是拉取 Openclaw 源码，同时 pnpm 在安装某些依赖时也会调用 git。去 Git 官网下载 Windows 安装包，一路默认下一步即可。装完后打开 CMD，输入：

git --version

能输出版本号就说明装好了。接下来这一步很关键，很多人忽略：清理可能存在的全局代理配置。如果你之前配过代理，残留设置会让后续拉包直接失败。执行：

git config --global --unset http.proxy git config --global --unset https.proxy

如果提示not found之类的信息，说明本来就没配，忽略即可。这一步的目的是让 Git 走干净的网络配置，为后面用国内镜像源拉依赖做准备。

2.2 安装 Node.js 并确认版本

Node.js 是 Openclaw 的运行时。去 Node.js 官网下载 LTS 版本（长期支持版），Windows 选.msi安装包，双击安装，记得勾选「Add to PATH」。装完新开一个 CMD 窗口，执行：

node -v npm -v

两条命令都要能输出版本号。如果node -v报「不是内部或外部命令」，说明 PATH 没生效，重开窗口或者重启一下终端。Node.js 版本建议 18 以上，太低会导致 pnpm 和 Openclaw 的部分依赖装不上。

2.3 在 TaoToken 获取统一 Key 与 API 通道

Openclaw 要调模型，需要一个统一的 API 入口。TaoToken 提供的就是这个通道：一个 Key、一个 Base URL，就能对接多种模型，省得你为每个模型单独配一套密钥。

先去控制台创建 API Key，入口在 https://taotoken.net/api-keys ，登录后新建一个 Key，复制保存好，后面配置里要用。模型对话的调试入口在 https://taotoken.net/models ，可以先用它确认 Key 能正常出结果。如果你打算长期跑编码类 Agent 任务，可以看下 Coding Plan：https://taotoken.net/coding-plan 。

这里先把三件套记下来，后面配置 Openclaw 会反复用到：

注意 Base URL 用https://taotoken.net/api，不要带多余的路径后缀，Openclaw 会自己拼接具体端点。

3. 可复制配置：pnpm 安装、镜像源与 Openclaw 环境变量

这一节是全文的核心操作区，所有命令都能直接复制。先把 Openclaw 源码准备好：从 GitHub 下载 Openclaw 源码压缩包，解压到一个纯英文路径的文件夹，比如D:\projects\openclaw。路径里不要有中文和空格，否则后面 pnpm 装依赖容易出莫名其妙的错。

3.1 开启 PowerShell 脚本权限并全局装 pnpm

进入 Openclaw 文件夹，在地址栏输入cmd回车，打开命令行。先解决 PowerShell 脚本执行权限问题，否则 pnpm 装不上：

Set-ExecutionPolicy -Scope Process Bypass

执行后会提示确认，输入y回车。这个设置只对当前进程生效，关掉窗口就恢复，安全。

接着全局安装 pnpm：

npm install -g pnpm

装完确认：

pnpm -v

能输出版本号即可。然后把 pnpm 的源换成国内镜像，速度会快很多：

pnpm config set registry https://registry.npmmirror.com

3.2 安装依赖并校验 Openclaw

在 Openclaw 目录下执行：

pnpm install

这一步会拉取项目所有依赖，第一次跑时间稍长，耐心等它跑完，出现Done之类的提示即可。然后跑开发模式构建：

pnpm dev

最后执行校验命令，确认 Openclaw 本体没问题：

node openclaw.mjs --version

成功输出无报错，说明安装链路走通了。

3.3 写入 TaoToken 环境变量与配置文件

Openclaw 读取模型配置的方式是环境变量加配置文件。在 Openclaw 目录下新建或编辑.env文件，写入：

OPENCLAW_API_BASE=https://taotoken.net/api OPENCLAW_API_KEY=你的TaoToken_Key OPENCLAW_MODEL=你的模型ID

如果你更习惯用 JSON 配置，可以在项目配置目录下建一个config.json：

{ "provider": { "baseUrl": "https://taotoken.net/api", "apiKey": "你的TaoToken_Key", "model": "你的模型ID" } }

Windows 下也可以用系统环境变量持久化，避免每次开窗口重设。在 CMD 里执行：

setx OPENCLAW_API_BASE "https://taotoken.net/api" setx OPENCLAW_API_KEY "你的TaoToken_Key" setx OPENCLAW_MODEL "你的模型ID"

setx写入的是用户级环境变量，执行完要新开一个 CMD 窗口才生效。三件套（Base URL、Key、Model ID）必须齐全，缺一个都会在调用时报错。

4. 验证请求：确认 Openclaw 能正常调用 API

配置写完不代表能用，得实际发一次请求验证。先启动 Openclaw 的初始化向导：

node openclaw.mjs gateway onboard

按提示一步步配置，走到模型配置环节时，填入前面准备的 Base URL、Key 和 Model ID。向导跑完后，启动网关：

node openclaw.mjs gateway run

网关起来后，另开一个 CMD 窗口，发一条测试请求。如果你用的是 OpenAI 兼容的调用方式，可以用 curl 直接打 TaoToken 的接口确认 Key 有效：

curl https://taotoken.net/api/v1/chat/completions ^ -H "Authorization: Bearer 你的TaoToken_Key" ^ -H "Content-Type: application/json" ^ -d "{\"model\":\"你的模型ID\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"

Windows CMD 里换行用^，如果你用 PowerShell，换成反引号。返回里能看到choices字段和模型回复内容，就说明 Key 和通道都正常。

再回到 Openclaw 里跑一个实际任务，比如让它读一个本地文件或者做一次简单检索。如果 Openclaw 能正常返回模型输出，整条链路就通了。实测下来，最容易出问题的是 Model ID 填错，返回里会提示模型不存在，这时候回 TaoToken 的模型列表核对一下名称即可。

5. 常见报错排查：401、local proxy failed 与 reading choices

装的过程中报错很正常，这一节把几个高频错误对照着讲清楚。

401 Unauthorized：Key 无效或没带上。检查.env或环境变量里的OPENCLAW_API_KEY是不是复制时多了空格，或者 Key 已经被删除。重新去 https://taotoken.net/api-keys 生成一个再试。注意 Base URL 必须是https://taotoken.net/api，写成别的路径会导致鉴权失败。

local proxy failed / 连接超时：多半是网络配置残留。回到第 2.1 步，确认 Git 的代理已经清掉，pnpm 源换成了国内镜像。如果之前设过系统级代理，也要检查一下环境变量里有没有HTTP_PROXY、HTTPS_PROXY这类残留，有就清掉。

reading 'choices' of undefined：这个报错说明请求发出去了，但返回结构不对，通常是 Model ID 写错或者接口路径拼错。确认你填的 Model ID 在 TaoToken 模型列表里存在，Base URL 不要自己加/v1后缀（Openclaw 会处理）。如果用的是自定义配置，检查 JSON 里字段名有没有拼错。

OAuth 相关报错：如果你在配置里误开了需要 OAuth 的 provider，而实际用的是 Key 鉴权，就会报这个。把配置里的鉴权方式改回 API Key 模式，或者删掉 OAuth 相关字段。

pnpm install 卡住不动：先确认镜像源设对了，再检查 Node.js 版本是否过低。实在不行删掉node_modules和pnpm-lock.yaml重新装。

排查思路就一条：先确认 Key 和 Base URL 三件套齐全，再看网络配置干不干净，最后核对 Model ID。大部分报错都出在这三处。

6. 装完之后：让 Openclaw 稳定跑起来的几个实用建议

装完只是开始，日常用起来还有几个点值得注意。第一，把三件套写进系统环境变量而不是每次手动设，省得换窗口就失效。第二，Openclaw 的 skill 工具是可选的，需要联网检索能力时再装，命令是npm i -g clawhub，然后按需添加 skill，不需要就别装，减少依赖冲突。第三，长期跑编码或 Agent 任务的话，用 Coding Plan 会比按量调用更省心，入口在 https://taotoken.net/coding-plan 。

再启动 Openclaw 就简单了，进入源码目录执行：

node openclaw.mjs gateway run

关机或退出后重新跑，也是这一条命令。如果想让配置更规范，可以翻一下接入文档 https://taotoken.net/doc ，里面有不同场景的配置示例。模型调试阶段多用 https://taotoken.net/models 验证 Key 是否正常，能省掉很多「到底是网络问题还是配置问题」的纠结。

最后提醒一句：路径保持纯英文、三件套别写错、报错先看是不是 401 或 Model ID 问题，这三条能覆盖你 90% 的安装故障。剩下的就是跑起来用，遇到具体任务再针对性调配置。