企业官网建设流程全解析

1. Windows 上养龙虾，先把 PowerShell 这关过了

OpenClaw 是一个能在本地跑起来、直接操作你电脑的数字员工，整理文件、写代码、跑定时任务都能干，圈里管部署它叫“养龙虾”。它本身不绑定某一家模型，你可以把它理解成一个“调度中枢”：真正干活的是背后接的大模型，而 OpenClaw 负责把指令翻译成对文件、命令、浏览器的实际操作。问题在于，Windows 上第一次部署的人，十有八九卡在环境这一层——Node.js 版本不对、npm 全局目录没进 PATH、PowerShell 执行策略拦脚本，报错还都是英文，看着就头大。

这篇是《上》篇，只干一件事：把 Node.js/npm/PowerShell 环境校验干净，再给出一份 OpenClaw 接入 TaoToken 统一 Key/API 通道的 config.toml 与 settings.json 骨架。目标不是让你马上跑通完整对话，而是让环境自检和最小配置验证先过。适合第一次在 Windows 上碰 OpenClaw、对 PowerShell 命令不算熟的人。全程命令可直接复制，每一步都有验证动作，跑完你会得到一份能继续往下接的配置底子。

我试过在一台没装过任何开发工具的 Win11 上从零走一遍，最容易翻车的不是安装本身，而是装完 Node 后没重开终端，导致node命令找不到。所以下面每个环节都配了“验证”动作，别跳。

2. 环境自检：Node.js、npm、PowerShell 三件套

2.1 用 winget 装 Node.js LTS

Windows 10 1809 以后自带 winget，直接用它装最省事。以管理员身份打开 PowerShell，执行：

winget install OpenJS.NodeJS.LTS

装完必须重开一个新的 PowerShell 窗口，因为 PATH 是启动时读取的，旧窗口不会刷新。然后验证：

node --version npm --version

正常会看到v22.x.x和10.x.x这样的输出。如果node提示“不是内部或外部命令”，八成是没重开窗口，或者安装时没勾选加入 PATH，重装一遍并确认勾选即可。

2.2 校验 npm 全局目录是否在 PATH

OpenClaw 是全局安装的，npm 的全局 bin 目录必须在 PATH 里，否则装完openclaw命令照样找不到。先查目录：

npm config get prefix

假设输出是C:\Users\你的用户名\AppData\Roaming\npm，检查它是否在 PATH：

$env:Path -split ';' | Select-String 'npm'

没有输出就手动加，永久生效：

[Environment]::SetEnvironmentVariable( "Path", $env:Path + ";C:\Users\你的用户名\AppData\Roaming\npm", "User" )

加完同样要重开窗口。这一步很多人忽略，结果npm install -g成功、openclaw --version却报找不到命令。

2.3 PowerShell 执行策略

OpenClaw 后续会跑脚本，默认策略可能直接拦下来。先看当前策略：

Get-ExecutionPolicy

如果是Restricted，临时放开（只对当前窗口生效，最安全）：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process

想一劳永逸就永久改，需要管理员窗口：

Set-ExecutionPolicy RemoteSigned

注意：永久修改会放宽脚本运行限制。如果你平时不跑来源不明的脚本，问题不大；只是临时用一次，优先用-Scope Process那个。

2.4 可选：npm 镜像加速

国内直连 npm 官方源偶尔慢，可以换镜像：

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

验证：

npm config get registry

输出镜像地址即生效。这一步纯加速，不影响功能，网络正常也可以跳过。

3. TaoToken 前置：拿到统一 Key 和 API 通道

OpenClaw 支持自定义 Provider，也就是说你可以把模型请求指向任意兼容 OpenAI 格式的接口。TaoToken 在这里扮演的角色就是“统一 Key/API 通道”：一个 Key、一个 Base URL，后面换模型只改 Model ID，不用来回折腾各家 SDK 和鉴权。

先去官网注册并进控制台，在 API Keys 页面创建一个 Key，复制保存。这个 Key 就是后面 config.toml 里要填的凭证。Base URL 用https://taotoken.net/api，注意不要带任何多余路径后缀，OpenClaw 会自己拼接/v1/chat/completions这类端点。

需要提前确认两件事：一是你的 Key 有可用额度，二是你打算用哪个 Model ID。Model ID 填错是后面最常见的报错来源，建议先在模型对话页面确认一下目标模型能正常出结果，再写进配置。这样排障时就能把“模型本身不可用”和“OpenClaw 配置错”两件事分开。

相关入口我放在这里，按需取用：模型对话用来验证模型可用性，API Keys 用来管理凭证，接入文档用来核对参数格式。

4. 可复制配置：config.toml 与 settings.json 骨架

OpenClaw 的配置分两层：config.toml管网关和 Provider，settings.json管运行时行为。下面给的是最小骨架，先跑通再扩展。

4.1 config.toml 骨架

工作目录建议放非系统盘，比如D:\openclaw\workspace。配置文件一般位于%USERPROFILE%\.openclaw\config.toml，没有就手动建：

[gateway] host = "127.0.0.1" port = 18789 auth_mode = "token" [provider.taotoken] type = "openai-compatible" base_url = "https://taotoken.net/api" api_key = "你的_TaoToken_Key" model = "你的_Model_ID" [agent] workspace = "D:\\openclaw\\workspace" tool_executor = "local"

几个关键点：type必须是openai-compatible，这是 OpenClaw 识别接口格式的依据；base_url不要带/v1，让它自己拼；api_key直接填明文，本地自用够用，介意的话后续可以换成环境变量引用。

4.2 settings.json 骨架

同目录下建settings.json，控制运行时行为：

{ "gateway": { "bind": "loopback", "log_level": "info" }, "provider": { "default": "taotoken" }, "tools": { "enabled": ["file", "shell"], "confirm_dangerous": true } }

bind设成loopback表示只允许本机访问，安全优先；confirm_dangerous打开后，危险操作会先问你，避免它自作主张删文件。这两个骨架先照抄，跑通后再按需加技能和钩子。

5. 验证请求：从环境自检到最小配置跑通

配置写完别急着开聊，先做三层验证，一层层排除问题。

第一层，环境自检：

node --version npm --version Get-ExecutionPolicy

三个都有正常输出，说明基础环境没问题。

第二层，配置语法校验。OpenClaw 一般带校验命令：

openclaw config validate

如果提示 TOML 解析错误，多半是引号或反斜杠转义问题。Windows 路径在 TOML 里要用双反斜杠\\，或者改用正斜杠/，两种都行。

第三层，最小请求验证。启动网关：

openclaw gateway

窗口保持打开，另开一个 PowerShell 发一条测试请求：

curl.exe -X POST http://127.0.0.1:18789/v1/chat/completions ` -H "Content-Type: application/json" ` -H "Authorization: Bearer 你的网关Token" ` -d '{\"model\":\"你的_Model_ID\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}'

注意 Windows 上要用curl.exe而不是curl，后者在 PowerShell 里是Invoke-WebRequest的别名，参数格式不一样。返回里出现正常的choices结构，说明从 OpenClaw 到 TaoToken 再到模型的整条链路通了。这一步过了，后面接 Web 界面、加技能都是顺水推舟。

6. 本篇常见错排查

node不是内部或外部命令：没重开终端，或安装时没勾选加入 PATH。重开窗口，还不行就重装并确认勾选。

openclaw找不到命令：npm 全局 bin 目录没进 PATH，回到 2.2 节处理。

无法加载文件，因为在此系统上禁止运行脚本：执行策略没放开，回到 2.3 节。

EADDRINUSE端口被占用：查占用进程再结束：

netstat -ano | findstr :18789 taskkill /PID 进程ID /F

Model not found：Model ID 写错，或该模型在你的 Key 下不可用。先去模型对话页面确认。

Authentication failed：Key 无效或过期，去 API Keys 页面重新生成，注意别把 Key 前后的空格复制进去。

Insufficient quota：额度用尽，检查账户余额或换模型。

TOML 解析报错：路径反斜杠没转义，改成\\或/。

排障时优先看网关窗口的日志，log_level设成debug能看到完整请求体，定位问题快很多。接入参数细节可以对照接入文档核对，凭证问题去 API Keys 页面处理。

7. 下一步：把骨架接上真实对话

环境自检和最小配置验证跑通后，你已经有了一个能继续扩展的底子。接下来要做的是把网关 Token 配好、登录 Web 界面发第一条真实消息，确认 OpenClaw 能正常调用你配置的模型。如果你打算长期跑编码类任务或接 Agent 流程，可以了解下 Coding Plan，它在长会话和工具调用场景下更省心；只是先验证模型通不通，模型对话页面就够用。

《下》篇会在这个骨架上继续加东西：把工作目录、技能、钩子按需补全，再处理后台常驻和日志轮转。现在先把这篇的验证动作走完，环境干净了，后面每一步都省事。