企业官网建设流程全解析

1. OpenClaw 源码本地部署到底难在哪：Node 版本、Git Bash 与 npm 脚本的连环坑

OpenClaw 是一个可以本地跑起来的开源 AI 网关项目，社区里习惯叫它「小龙虾」。它能做什么？简单说，就是把你在各家平台申请的模型 API 统一收口到一个本地服务里，再通过 Web 聊天界面或者兼容接口对外提供调用。适合谁？适合想在自己电脑上折腾一套可控 AI 入口的开发者，尤其是手里已经有模型 Key、又不想被某个客户端绑死的人。

但第一次接触 OpenClaw 源码部署的人，大概率会卡在三个地方：Node 版本不够、Windows 下 npm 脚本调用 bash 失败、以及依赖装完却不知道服务有没有真正起来。这三个问题不是孤立的，它们会连环出现——Node 版本低导致构建报错，构建脚本里又依赖 bash，bash 在 Windows 默认终端里不存在，于是npm run build直接 ELIFECYCLE。你以为是代码问题，其实是环境问题。

我自己第一次跑的时候，机器上已经有一个 Node 18，结果 OpenClaw 要求 Node >= 22.12.0，npm install阶段就警告不断，到了npm run build直接抛'bash' 不是内部或外部命令。后来才明白，OpenClaw 的构建脚本里有.sh文件，Windows 的 cmd 和 PowerShell 都不认，必须用 Git Bash 来执行。这篇就按「环境准备 → 源码获取 → 依赖安装 → 构建启动 → 验证排障」的顺序，把每一步的命令和回显都写清楚，让你一次跑通。

核心检索词先明确：OpenClaw 源码部署、Node 版本检查、Git Bash 安装、npm 构建脚本、本地服务端口验证。下面所有命令都可以直接复制，路径按你自己的项目目录替换即可。

2. 部署前的 TaoToken 与模型接入准备：API Key、Base URL 与 Model ID 三件套

OpenClaw 本身是一个网关壳子，它需要你提供一个模型服务的接入信息才能真正对话。这里我用 TaoToken 作为模型接入方来演示，因为它同时提供兼容接口和多种模型，配置起来比较直接。你需要提前准备三样东西：Base URL、API Key、Model ID。这三件套在后面的onboard配置环节会依次填入。

先到 TaoToken 控制台创建一个 API Key。打开 https://taotoken.net/console ，登录后进入 API Keys 页面，新建一个 Key 并复制保存。这个 Key 只显示一次，丢了就得重建。接着确认 Base URL，TaoToken 的兼容接口地址是 https://taotoken.net/api ，注意这个地址后面不加任何路径后缀，OpenClaw 配置时会自动拼接。

Model ID 需要根据你想用的模型来填。在模型对话页面可以先试一下有哪些模型可用： https://taotoken.net/models 。选一个你常用的模型名称记下来，比如某个通用对话模型或者代码模型。如果你打算长期用 OpenClaw 做编码辅助或者 Agent 调度，可以考虑 Coding Plan 方案，具体在 https://taotoken.net/coding-plan 查看。

这里要提醒一点：OpenClaw 的onboard流程会问你 API 地址和密钥，如果你填的是百炼或者其他平台，逻辑是一样的，只要那个平台提供兼容接口即可。我下面用 TaoToken 的地址做示例，你替换成自己的即可。配置文档可以参考 https://taotoken.net/doc ，里面有接口说明和常见参数。

把这三样东西先写在一个临时文本里：

准备好之后，再回到源码部署流程。因为 OpenClaw 启动后需要读取这些配置，如果 Key 没准备好，onboard环节会卡住，你还得重新跑一遍。所以顺序上，先拿 Key，再装环境，最后启动配置。

3. Node + Git + Bash 环境配置：可复制的版本检查与依赖安装命令

这一节是整篇的核心操作区。我会把 Node 版本检查、Git Bash 安装、npm 镜像设置、依赖安装、构建命令全部列出来，你按顺序执行即可。重点在于：Node 必须 >= 22.12.0，构建必须在 Git Bash 里跑。

3.1 Node 版本检查与多版本共存处理

先检查你当前的 Node 版本。打开终端输入：

node -v npm -v

如果回显是 v22.12.0 或更高，恭喜你可以跳过安装。如果低于这个版本，或者你机器上有多个 Node 想临时切换，推荐下载免安装压缩包。到 Node 官网下载 v24.x 的 win-x64 zip 包，解压到项目根目录，比如E:\ai\aicode\traeHome\workHome\openclaw-main\node-v24.14.0-win-x64。

然后在 Git Bash 里临时设置 PATH，让当前终端优先使用这个高版本 Node：

export PATH="/e/ai/aicode/traeHome/workHome/openclaw-main/node-v24.14.0-win-x64:$PATH" node -v

回显应该是 v24.14.0。注意这个设置只在当前终端窗口有效，关掉就失效，所以每次新开 Git Bash 都要重新 export。如果你在 cmd 里操作，对应命令是：

set PATH=E:\ai\aicode\traeHome\workHome\openclaw-main\node-v24.14.0-win-x64;%PATH%

PowerShell 则是：

$env:PATH = "E:\ai\aicode\traeHome\workHome\openclaw-main\node-v24.14.0-win-x64;$env:PATH"

三种写法效果一样，选你顺手的。我建议统一用 Git Bash，因为后面构建脚本本来就需要 bash。

3.2 Git Bash 安装与 npm 镜像配置

Windows 上npm run build报'bash' 不是内部或外部命令，就是因为构建脚本里有bash scripts/bundle-a2ui.sh这样的调用。解决办法是安装 Git for Windows，安装时务必勾选「Git Bash Here」。装完后在项目目录右键就能看到「Git Bash Here」。

安装完成后，顺手把 npm 镜像换成国内源，避免依赖下载超时：

npm config set registry https://registry.npmmirror.com npm install -g pnpm pnpm -v

这里用 pnpm 是因为 OpenClaw 的依赖树比较大，pnpm 的硬链接机制能省不少磁盘和时间。如果你习惯 npm 也可以，但后续命令里的pnpm要换成npm run。

3.3 源码克隆与依赖安装

获取源码有两种方式。用 Git 克隆：

git clone https://github.com/openclaw/openclaw.git cd openclaw

或者手动下载 ZIP 解压。克隆完成后进入项目目录，确认目录结构里有package.json、scripts文件夹、pnpm-workspace.yaml等文件。然后安装依赖：

pnpm install

这一步会下载大量包，耐心等待。如果中途报网络错误，重跑一次通常能续上。安装完成后，先构建 UI 再构建主项目：

pnpm ui:build pnpm build

ui:build负责前端资源打包，build负责后端和整体编译。两个都成功回显 Done 或类似字样，才算构建通过。

3.4 配置文件片段参考

OpenClaw 的配置最终会落到C:\Users\你的用户名\.openclaw-dev\openclaw.json。在onboard之前，你可以先了解它的大致结构。下面是一个配置片段示例，字段名以实际版本为准：

{ "gateway": { "port": 19001, "host": "127.0.0.1" }, "providers": [ { "name": "taotoken", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的密钥", "model": "你的模型ID" } ] }

注意：不要手动去改这个文件，让onboard命令帮你生成，避免字段不匹配。这里只是让你知道配置长什么样，方便排障时对照。

4. 启动与验证：onboard 配置、gateway:watch 与端口探测

构建通过后，进入启动配置环节。OpenClaw 提供了一个交互式引导命令：

pnpm openclaw onboard --install-daemon

执行后会依次问你几个问题：API 地址、API 密钥、模型名称、要安装的 skill、以及其他参数。API 地址填https://taotoken.net/api，密钥填你刚才在控制台生成的，模型名称填你选定的 Model ID。skill 按需勾选，不确定就选默认。全部回答完后会显示配置完毕。

接着启动网关开发模式：

pnpm gateway:watch

这个命令会持续运行，终端里会打印服务启动日志。看到类似Gateway listening on 127.0.0.1:19001的输出，说明服务已经起来了。此时不要关闭这个终端窗口。

然后打开浏览器，访问：

http://127.0.0.1:19001/webchat/overview

页面会要求填写令牌。令牌在哪里？打开C:\Users\你的用户名\.openclaw-dev\openclaw.json，找到token字段，复制它的值填进去。提交后就能进入聊天界面，发一条消息测试模型是否正常响应。

验证动作分三步：第一，终端回显端口监听；第二，浏览器能打开 webchat 页面；第三，发消息能收到模型回复。三步都通过，说明 OpenClaw 源码部署成功。如果第三步失败，多半是 API Key 或 Base URL 填错，回到onboard重新配置即可。

端口探测也可以用命令行确认：

curl http://127.0.0.1:19001/webchat/overview

如果返回 HTML 内容，说明服务在正常响应。如果连接被拒绝，检查gateway:watch是否还在运行。

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

部署过程中最容易遇到的几个报错，我逐个拆解。

401 Unauthorized：这个通常出现在聊天界面发消息后，模型返回 401。原因一般是 API Key 填错、Key 已失效、或者 Base URL 多了斜杠。检查openclaw.json里的apiKey和baseUrl，确保 Base URL 是https://taotoken.net/api，结尾没有多余路径。如果 Key 是在别的平台生成的，确认那个平台支持兼容接口。

local proxy failed：这个报错说明 OpenClaw 尝试连接模型服务时网络不通。先确认你的机器能正常访问外网，再检查 Base URL 是否可达。可以在 Git Bash 里用curl https://taotoken.net/api测试连通性。如果返回 404 或 401，说明地址可达但路径需要调整；如果超时，说明网络层有问题。

reading choices 报错：这个通常出现在模型返回结构不符合预期时。OpenClaw 期望的是标准兼容响应格式，如果模型服务返回了非标准结构，就会在解析choices字段时报错。解决办法是确认你用的模型和接口是兼容格式。TaoToken 的接口是兼容的，如果还有问题，检查 Model ID 是否拼写正确。

OAuth 相关报错：如果你在onboard时选了需要 OAuth 的 provider，但没完成授权流程，启动后会报 OAuth token 缺失。建议第一次部署先用 API Key 方式，简单直接。等跑通后再研究 OAuth。

Codex auth.json 相关：如果你同时装了 Codex 类工具，注意它的auth.json和 OpenClaw 的配置是分开的，不要混用。OpenClaw 的配置在.openclaw-dev/openclaw.json，Codex 的在它自己的目录。两者互不影响，但如果你手动改错了文件，会导致启动读取失败。

CC Switch / Cline MCP 场景：如果你是通过 CC Switch 或 Cline 的 MCP 来调用 OpenClaw，需要确保三件套完整：Base URL、Key、Model ID 都正确填入对应工具的配置里。MCP 直连生产库是禁止的，只连本地 OpenClaw 网关即可。

排障时建议打开gateway:watch的终端日志，报错信息会直接打印在那里，比浏览器控制台更直观。遇到看不懂的堆栈，先看最后一行，通常是根因。

6. 跑通之后：把 OpenClaw 接入日常开发流的几个实用建议

服务跑起来只是第一步。实际用的时候，有几个点值得注意。

第一，gateway:watch是开发模式，适合调试，但不适合长期后台运行。如果你想让它在后台常驻，可以用--install-daemon参数安装成守护进程，具体命令在onboard时已经问过你。装成 daemon 后，开机自启，不用每次手动敲命令。

第二，令牌不要泄露。openclaw.json里的 token 相当于你本地网关的访问密码，如果暴露到公网会有风险。默认监听127.0.0.1是安全的，不要改成0.0.0.0除非你清楚自己在做什么。

第三，模型切换很方便。你可以在openclaw.json里配置多个 provider，然后在 webchat 界面切换。比如一个通用模型用于日常对话，一个代码模型用于编码辅助。TaoToken 的模型列表在 https://taotoken.net/models 可以查，按需添加即可。

第四，如果你打算把 OpenClaw 作为长期编码助手，建议走 Coding Plan，额度和稳定性更适合高频调用。配置方式不变，只是 Key 的来源不同。

第五，源码更新后，重新执行pnpm install、pnpm ui:build、pnpm build三步即可，配置文件和 token 不会丢。如果更新后启动报错，先删掉node_modules重装，多数问题能解决。

最后，接入文档在 https://taotoken.net/doc ，API Key 管理在 https://taotoken.net/api-keys ，模型对话测试在 https://taotoken.net/models 。遇到配置问题先查文档，再对照本文的排障章节。整套流程走下来，从环境准备到聊天验证，顺利的话半小时内能完成。