企业官网建设流程全解析

1. 为什么要在 Windows 上折腾 OpenClaw 电脑端部署

OpenClaw 是最近在开发者圈子里被频繁提到的一个本地智能体运行框架，它能让你在电脑上跑一个带工具调用能力的对话入口，通过浏览器界面完成文件整理、命令执行、简单任务编排这类操作。和纯网页版对话不同，OpenClaw 跑在你自己的机器上，能直接读写本地目录、调用系统命令，所以对 node.js、git、powershell 这些环境有硬性依赖。适合谁？适合想在自己 Windows 电脑上体验本地 Agent、又不想一上来就买云服务器的人；也适合已经有一堆 API Key、想找个统一入口管理模型调用的开发者。

但真正动手时，坑往往不在 OpenClaw 本身，而在环境准备：node.js 版本不对、git 没装导致依赖拉不下来、powershell 脚本执行策略被拦、openclaw-cn 配置时模型通道填错。我试过在一台干净的 Windows 11 上从零走一遍，最耗时间的不是安装，而是把模型通道统一到一个 Key 上。这篇就按“环境准备 → 安装 → 配置 → 启动验证 → 排错”的顺序，把每一步的可复制命令和配置片段给全，最后用 TaoToken 的统一 Key 把模型通道接上，省得你在多个平台之间来回切。

核心检索词先明确：OpenClaw 电脑端部署、node.js 环境、git 安装、powershell 执行策略、openclaw-cn 配置、TaoToken 统一 Key。这几个词会贯穿全文，你照着做就能在本地跑通一次完整启动。

先说清楚整体链路：OpenClaw 本体负责本地 Agent 调度，模型调用走 OpenAI 兼容的 API 通道。TaoToken 提供的就是这个兼容通道，一个 Key 可以调不同模型，Base URL 固定，Model ID 按需换。这样你就不用为每个模型单独配一套环境变量。下面进入实操。

2. 前置准备：node.js、git、powershell 环境一次装齐

这一章把三个依赖装好，顺序建议 node.js → git → powershell 策略调整。别跳步，git 缺失会在 openclaw-cn 安装阶段报依赖拉取失败。

2.1 node.js 安装与版本确认

去 nodejs.org 下载 LTS 版本，Windows 选.msi安装包，一路下一步即可。安装完成后必须验证，很多人装完没进 PATH 就直接跑 openclaw-cn，结果报node 不是内部或外部命令。

打开一个新的 powershell 窗口（普通权限即可），输入：

node -v npm -v

正常输出类似v20.11.1和10.2.4。如果提示找不到命令，说明安装时没勾选 “Add to PATH”，重新运行安装包修复一下，或者手动把 nodejs 安装目录加进系统环境变量。

版本建议 node.js 18 以上，OpenClaw 的部分依赖用了较新的 ESM 特性，16 及以下容易在安装阶段报语法错误。npm 会随 node.js 一起装好，不用单独处理。

2.2 git 安装与验证

git 的作用是让 openclaw-cn 在安装和更新时能拉取仓库依赖。去 git-scm.com 的 Windows 下载页拿安装包，下载慢是常态，多试几次或者换个时间段。安装时保持默认选项即可，其中 “Adjusting your PATH environment” 选默认的 “Git from the command line and also from 3rd-party software”。

装完同样开新窗口验证：

git --version

输出git version 2.44.0.windows.1这类信息就对了。如果报错，检查是否装到了非默认路径且没加 PATH。

2.3 powershell 执行策略调整

OpenClaw 的安装脚本是.ps1文件，Windows 默认执行策略会拦截。手动搜索 “powershell”，右键选择“以管理员身份运行”，在打开的终端里输入：

Set-ExecutionPolicy Unrestricted

回车后如果弹出确认提示，输入Y再回车。如果没有任何提示，说明之前已经改过，直接继续。这一步只影响脚本执行权限，不改系统其他设置。

注意：执行策略调整后，建议只在当前用户范围生效。如果你在意安全，可以用Set-ExecutionPolicy -Scope CurrentUser Unrestricted，效果一样但作用域更小。

三个依赖装完，可以用一条命令快速自检：

node -v; npm -v; git --version

三条版本信息都出来，环境就算齐了。接下来装 OpenClaw 本体。

3. 安装 openclaw-cn 并接入 TaoToken 统一 Key 配置

这一章是核心，分两步：先装 openclaw-cn，再写配置文件把模型通道指向 TaoToken。

3.1 安装 openclaw-cn

保持管理员 powershell 窗口，输入官方安装脚本：

iwr -useb https://clawd.org.cn/install.ps1 | iex

这条命令会下载并执行安装脚本，过程中会拉取 npm 包和 git 依赖，耐心等它跑完。看到安装完成提示后，连续按两次Ctrl+C退出当前会话，然后新开一个 powershell 窗口（这次普通权限就行），输入：

openclaw-cn onboard

这是初始化配置向导，方向键上下选择，回车确认。向导会问你运行模式、端口、模型通道等。模型通道这一步先随便选一个占位，我们下一步用配置文件覆盖成 TaoToken。

3.2 写入 TaoToken 统一 Key 配置

OpenClaw 的模型通道配置支持 OpenAI 兼容格式。TaoToken 的 API 地址是https://taotoken.net/api，Key 在控制台创建。配置文件通常位于用户目录下的.openclaw文件夹，文件名可能是config.json或settings.json，以你安装版本实际生成的为准。下面给一份可复制的 JSON 片段，路径和字段名按你本地实际文件对齐：

{ "model": { "provider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "modelId": "claude-3-5-sonnet", "timeout": 60000 }, "gateway": { "port": 18789, "host": "127.0.0.1" } }

三个关键字段必须写全，缺一个都会在启动时报错：

如果你用的是 Cline MCP 或 Codex 的auth.json体系，逻辑一样：Base URL 填https://taotoken.net/api，Key 填 TaoToken 控制台生成的，Model ID 按你要调的模型填。三件套齐了，通道就通了。

提示：Key 不要写进会提交到 git 的文件里。本地配置文件加进.gitignore，或者用环境变量TAOTOKEN_API_KEY引用，OpenClaw 支持从环境变量读取。

配置写完保存，回到 powershell 准备启动验证。

4. 启动 gateway 与 dashboard 完成一次完整验证

这一章演示从启动到看到 Web 界面的完整过程，并验证模型通道是否真的通了。

4.1 启动 gateway

gateway 是 OpenClaw 的后台服务，负责接收请求、调度模型。开一个管理员 powershell 窗口，输入：

openclaw-cn gateway

这个窗口全程不能关，关了服务就断。正常启动会输出监听地址，类似Gateway listening on 127.0.0.1:18789。如果卡住不动或者报端口占用，换一个端口，改配置文件里的gateway.port即可。

4.2 打开 dashboard

再开一个新的 powershell 窗口（普通权限），输入：

openclaw-cn dashboard

它会自动打开浏览器跳转到 Web 界面，地址通常是http://127.0.0.1:18789。如果没自动跳，手动复制终端里输出的 URL 到浏览器。

4.3 发一条验证请求

在 Web 界面输入框里发一句简单的话，比如“你好，帮我列一下当前目录的文件”。如果模型通道配置正确，你会看到回复正常返回，并且可能触发一次工具调用（列目录）。这一步成功，说明 node.js、git、powershell、openclaw-cn、TaoToken 通道全部打通。

验证模型通道是否走的是 TaoToken，可以看 gateway 窗口的日志，正常会打印请求的 baseUrl 和 modelId。如果日志里出现401或invalid api key，回到第 3 章检查 Key 和 baseUrl。

想单独验证模型对话是否可用，可以直接用 TaoToken 的模型对话页面发一条测试消息，确认 Key 本身有效，再回来排查 OpenClaw 配置。这一步能快速区分是 Key 问题还是配置问题。

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

这一章按真实报错对照排查，都是我在部署过程中实际遇到或社区里高频出现的。

5.1 401 Unauthorized

报错原文通常是401 Unauthorized或invalid api key。原因就三类：Key 写错、Key 过期、baseUrl 写错。检查配置文件里的apiKey是否完整复制，有没有多余空格；baseUrl必须是https://taotoken.net/api，结尾不要多加/v1或斜杠。改完重启 gateway。

5.2 local proxy failed

报错local proxy failed或connect ECONNREFUSED，一般是 gateway 没启动，或者 dashboard 连的端口和 gateway 监听端口不一致。确认 gateway 窗口还在运行，且配置文件里gateway.port和 dashboard 实际访问的端口一致。如果改了端口，两个地方都要改。

5.3 reading choices 报错

报错里出现reading 'choices'或Cannot read properties of undefined (reading 'choices')，说明模型返回的响应结构不符合 OpenAI 兼容格式。常见原因是 modelId 填错，或者 baseUrl 指向了一个不兼容的端点。确认 modelId 是 TaoToken 支持的模型标识，baseUrl 用https://taotoken.net/api。

5.4 OAuth 相关报错

如果报错提到OAuth或token refresh failed，说明你误用了需要 OAuth 的通道配置。OpenClaw 接 TaoToken 用的是 API Key 模式，不需要 OAuth。检查配置文件里有没有残留的 OAuth 字段，删掉，只保留 baseUrl、apiKey、modelId 三件套。

5.5 安装阶段依赖拉取失败

npm install或 git clone 阶段报网络错误，先确认 git 已装且能访问外网。如果公司网络有限制，配置 npm 镜像和 git 代理设置（这里指正常的网络配置，不是绕过限制）。重试安装脚本即可。

排查完记得每次改配置后重启 gateway，配置不会热加载。

6. 把统一 Key 用顺：后续维护与接入入口

跑通一次之后，日常使用就是两个窗口：一个跑openclaw-cn gateway不关，一个用openclaw-cn dashboard打开界面。模型想换，只改配置文件里的modelId，baseUrl 和 Key 不用动，这就是统一 Key 的好处。

如果你要长期跑编码类任务或 Agent 工作流，建议把 Key 管理集中起来，用 Coding Plan 这类方案控制额度，避免单个 Key 被多项目共用导致超额。接入文档里有完整的字段说明和示例，遇到配置字段不确定时直接查文档比猜快。

• 创建和管理 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
• 单独验证模型对话：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite
• 长期编码与 Agent 额度方案：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite

最后给一个实用技巧：把 gateway 启动命令写成一个.bat文件，双击就能跑，省得每次开管理员终端。配置文件备份一份，换机器时直接复制.openclaw目录，改一下 Key 就能用。环境变量TAOTOKEN_API_KEY建议设成系统级，这样配置文件里可以不写明文 Key，更安全。