企业官网建设流程全解析

1. Windows 本地搭建 OpenClaw 到底在装什么

OpenClaw（社区里也常被叫 ClawBot）是一个基于 Node.js 的 AI 交互工具，跑起来之后会在本地拉起一个 Web 控制面板，你可以把它理解成「装在自己电脑上的 AI 助手外壳」：它本身不产出模型能力，而是负责把对话界面、工具调用、会话管理这些事管起来，再通过一个统一的 API 通道去请求背后的大模型。所以整条链路其实是两段：一段是 Windows 上的运行环境（Node.js、npm、Git），另一段是模型接入通道（Key、Base URL、配置文件）。

这篇面向的是第一次在 Windows 上折腾 OpenClaw 的人，尤其是被 npm 权限、PowerShell 脚本策略、环境变量这几件事卡住过的。我按「先查环境 → 再装依赖 → 初始化项目 → 写配置骨架 → 验证连通」的顺序走一遍，每一步都给可复制的命令和预期输出。模型通道这部分我用 TaoToken 做统一入口，原因是它把多家模型的 Key 收敛成一个，配置文件里只维护一份 Base URL 和一份 Key，后面换模型不用改代码结构，对本地搭建这种反复调试的场景省事很多。

需要提前说清楚：OpenClaw 目前仍在快速迭代，命令名和配置字段可能随版本变化，遇到对不上的地方以你本地--help输出为准。下面所有路径示例用的是默认用户目录，你的用户名不同就替换掉。

2. 前置环境检查：Node.js、npm、Git 三件套

2.1 先确认版本，别急着装

打开 PowerShell（普通权限即可），逐条执行：

node -v npm -v git --version

预期是三条都返回版本号。如果node或npm提示「不是内部或外部命令」，说明没装或者没进 PATH；如果git报错，说明 Git 缺失。三个都正常的话，直接跳到第 3 节。

版本上有两条硬线：Node.js 建议 18 LTS 及以上，低于 16 的版本在装依赖时容易碰到语法不兼容；npm 跟着 Node.js 走就行，不用单独升。Git 版本新旧影响不大，能正常拉取仓库即可。

2.2 Node.js 安装与 PATH 自检

去 Node.js 官网下载 Windows x64 的.msi安装包，双击一路 Next。这个安装包的好处是会自动把node、npm写进系统 PATH，省掉手动配环境变量。

装完必须做一件事：关掉所有已经打开的终端窗口，重新开一个。因为 PATH 是进程启动时读取的，旧窗口读不到新变量。然后重新跑node -v，能出版本号才算生效。

如果你之前用压缩包方式装过 Node.js，PATH 里可能残留旧路径，导致node -v出的版本和实际想用的不一致。用这条命令看真实位置：

where.exe node

返回的第一行就是当前生效的 node 路径。如果指向一个你不认识的目录，去「系统属性 → 环境变量 → 用户变量/系统变量里的 Path」把旧条目删掉，再把新安装目录（一般是C:\Program Files\nodejs\）提到前面。

2.3 Git 安装与最小配置

Git 从官网下 Windows 独立安装包，默认路径C:\Program Files\Git，安装选项一路默认即可。装完同样重开终端，git --version能出版本号就行。

顺手配一下身份信息，后面拉取依赖时不会因为缺配置报错：

git config --global user.name "your-name" git config --global user.email "you@example.com"

这两条不是必须，但配了能省掉一类「请先配置用户信息」的报错。

3. TaoToken 前置：把模型通道先备好

3.1 为什么先配通道再装项目

很多人习惯先把 OpenClaw 装完再想模型怎么接，结果初始化向导走到「填 API Key」那一步卡住，因为手上没有可用的 Key。更顺的做法是先把通道准备好：拿到 Key、确认 Base URL、想清楚要接哪个模型，再去跑初始化，整个过程一次过。

TaoToken 在这里的角色是统一入口。你注册后在控制台创建一个 API Key，之后不管底层用哪个模型，OpenClaw 侧只需要认这一个 Key 和一个 Base URL。对本地搭建来说，好处是配置文件干净，排错时变量少——连通性出问题，要么是 Key 错，要么是网络到不了，不会牵扯到「是不是这家模型的参数格式不一样」。

3.2 拿 Key 与确认接入地址

进控制台创建 Key，复制保存好，多数平台只在创建时明文展示一次。然后记下两个地址：

• 官网入口：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
• API 基址：https://taotoken.net/api

注意 API 基址后面不带 UTM 参数，配置文件里填的就是这个干净地址。Key 的形态一般是一串以固定前缀开头的长字符串，填的时候别带引号、别带空格，这是最常见的低级错误。

如果你后面打算长期跑编码类任务或者挂 Agent，可以顺带了解下 Coding Plan 这类套餐，按量还是包月取决于你的调用频率；只是偶尔对话的话，按量就够。控制台里还能看到用量和余额，调试阶段建议先充一点点，避免调通之前就被额度拦住。

4. 可复制配置：OpenClaw 项目初始化与配置文件骨架

4.1 全局安装与 PowerShell 脚本策略

先解决一个 Windows 上几乎必踩的坑。PowerShell 默认执行策略是Restricted，会拦住 npm 的.ps1脚本，报错长这样：

npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本

处理方式是管理员身份打开 PowerShell，先看当前策略：

Get-ExecutionPolicy

返回Restricted就改成允许本地脚本和已签名远程脚本：

Set-ExecutionPolicy RemoteSigned

弹确认输Y回车。改完关掉重开终端，再执行安装。这一步只影响脚本执行权限，不改系统其他设置。

然后全局安装：

npm install -g openclaw@latest

如果卡在下载或者报ECONNRESET，是拉包时的网络波动，换镜像源重试：

npm config set registry https://registry.npmmirror.com npm install -g openclaw@latest

装完验证：

openclaw --version

如果提示「不是内部或外部命令」，八成是 npm 全局目录没进 PATH。先查全局目录：

npm config get prefix

返回的路径（常见是C:\Users\你的用户名\AppData\Roaming\npm）加到系统 PATH 里，重开终端再试。

4.2 初始化项目目录

找个你放项目的盘，建目录并进入：

mkdir D:\projects\openclaw-demo cd D:\projects\openclaw-demo

如果你是从源码方式跑，先克隆仓库再装依赖：

git clone <仓库地址> . npm install

如果是全局安装的 CLI 方式，直接在目标目录跑初始化向导：

openclaw onboard

向导会依次问部署模式、模型服务商、鉴权方式、Key、Agent 启动方式。部署模式新手选 QuickStart，后面随时能用openclaw configure改。走到模型服务商那一步，如果你用 TaoToken 做统一通道，就选支持自定义 Base URL 的通用/OpenAI 兼容选项，把 Base URL 填成https://taotoken.net/api，Key 填你在控制台创建的那串。

4.3 配置文件骨架

向导跑完会在用户目录下生成配置，路径一般是：

~\.openclaw\openclaw.json

工作空间和会话数据分别在~\.openclaw\workspace和~\.openclaw\agents\main\sessions。下面给一份骨架，字段名以你本地版本为准，重点是结构：

{ "model": { "provider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的Key", "defaultModel": "你的模型ID" }, "agent": { "name": "main", "workspace": "~/.openclaw/workspace" }, "server": { "host": "127.0.0.1", "port": 18789 } }

几个要点：baseUrl结尾不要多加斜杠，有些实现会把/v1拼重复；apiKey直接写明文，本地个人机器可以接受，但别把这个文件提交到 Git；defaultModel填你在 TaoToken 侧确认可用的模型 ID，填错会在请求时返回模型不存在。

改完配置存盘，重启服务让配置生效。

5. 验证请求：确认通道真的通了

5.1 先用命令行打一发

在写业务代码之前，先用最朴素的方式确认 Key 和地址没问题。PowerShell 里这样发一个请求：

$headers = @{ "Authorization" = "Bearer sk-你的Key" "Content-Type" = "application/json" } $body = @{ model = "你的模型ID" messages = @(@{ role = "user"; content = "只回复两个字：通了" }) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri "https://taotoken.net/api/v1/chat/completions" ` -Method Post -Headers $headers -Body $body

返回里能看到choices[0].message.content就是成功。如果返回 401，是 Key 问题；返回 404，多半是路径拼错，检查/v1/chat/completions有没有重复或缺失；超时则是网络到不了，先ping taotoken.net看解析。

5.2 再验证 OpenClaw 侧

服务起来后，浏览器打开：

http://127.0.0.1:18789/chat?session=main

在输入框发一句「你能做什么」，能正常流式返回就说明 OpenClaw 到 TaoToken 再到模型的整条链路通了。左侧导航能看到会话、活动日志、用量这些面板，调试阶段多看看活动日志，请求失败时错误信息比界面提示详细。

如果界面能打开但发消息报错，回到 5.1 的命令行测试：命令行通、界面不通，问题在 OpenClaw 配置；命令行也不通，问题在 Key 或地址。

6. 本篇常见错排查

npm 装到一半 EPERM。报错类似EPERM: operation not permitted, rmdir，是目标目录被占用或权限不够。先关掉可能占用AppData\Roaming\npm的编辑器、终端，用管理员身份重开终端再装。残留的旧版本目录删不掉就手动进路径删。

openclaw命令找不到。按 4.1 的方法把 npm 全局目录加进 PATH，务必重开终端。改环境变量不重启窗口是不生效的，这个坑我见过太多次。

向导里填完 Key 校验失败。先确认 Key 没多复制空格或换行，再确认 Base URL 没写错。如果用的是自定义通道，检查是不是把/v1写进了 baseUrl 又在请求时拼了一次。

服务起来了但端口被占。18789 被别的程序占用时，改配置里的server.port换一个，比如 18790，重启即可。查端口占用：

netstat -ano | findstr 18789

改了配置不生效。配置文件是启动时读的，改完必须重启服务。另外注意~在 JSON 里不一定被展开，保险起见写绝对路径，比如C:/Users/你的用户名/.openclaw/workspace。

想临时关掉联网搜索或技能。向导里跳过的项后面都能补，用openclaw configure重新进对应 section 即可，不用重装。

7. 接下来怎么走

环境通了之后，下一步通常是两件事：一是把常用模型在 TaoToken 侧都试一遍，找到适合你任务的；二是把 OpenClaw 接到你日常用的客户端或消息通道里。

想快速对比不同模型的表现，直接开模型对话页发同样的 prompt 看输出差异，比在配置文件里反复改模型 ID 高效得多：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

如果你打算长期跑编码或 Agent 类任务，调用频率上来了，可以看下 Coding Plan 的额度方案，避免按量计费在高峰期成本失控：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

需要新建或管理多个 Key（比如给不同项目分开计量），在控制台操作：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

Key 的创建和权限说明看这里：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

接入参数、路径拼接、错误码这些细节，文档里写得比本文细，遇到对不上的字段优先查文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

最后提醒一句：配置文件里的 Key 别提交到公开仓库，本地调试用的 Key 建议单独建一个，方便随时吊销重发。