企业官网建设流程全解析

1. win10 原生装 openclaw 到底卡在哪

openclaw 是一个跑在本地的 AI 工具链网关，能把你常用的模型通道统一收口，再分发给编辑器、命令行、Agent 之类的客户端。它适合谁？适合在 win10 上想搭一套本地 AI 工作流、又不想每个工具单独配一遍 Key 的人。我这次要解决的核心问题很具体：win10 原生环境（不装 WSL、不折腾虚拟机）把 openclaw 装起来，并且用 TaoToken 的统一 Key 把模型通道接进去，最后给出可复制的config.toml骨架和settings.json片段。

先说 win10 原生安装最容易踩的坑，基本都集中在三件事上：Node.js 装到了带中文的路径、npm 全局目录默认落在C:\Users\你的中文名\AppData、以及 openclaw 的启动脚本指向了错误的entry.js。这三个问题任意一个出现，表现都是openclaw命令找不到，或者找到了但一运行就报模块缺失。excerpt 里那套「强制装到 D 盘纯英文路径」的思路是对的，我把它整理成更顺的步骤，并且补上后面配置通道的部分。

装之前确认两件事：Node.js 用 LTS 版本，安装路径手动改成D:\nodejs这种纯英文；Git 也装上，后面拉依赖会用到。验证命令就两条：

node -v npm -v

能打印出版本号就说明基础环境 OK。如果node -v报「不是内部或外部命令」，去系统变量的 PATH 里补上D:\nodejs，重开一个 PowerShell 再试。

2. TaoToken 前置：统一 Key 与 API 通道准备

openclaw 本身是个网关，它自己不带模型能力，得接一个上游通道。这里用 TaoToken 做统一入口，好处是一个 Key 管所有模型调用，openclaw 里只配一次，后面换模型不用改客户端。

先去控制台拿 Key。打开 https://taotoken.net/console ，登录后在 API Keys 页面创建一个新 Key，复制出来先存好，后面config.toml里要用。创建时注意权限范围，本地工具链场景给常规调用权限就够了。

拿到 Key 之后，记下两个地址：API 基址是https://taotoken.net/api，模型对话入口在 https://taotoken.net/model 。openclaw 的通道配置里填的就是这个 API 基址，Key 填你刚复制的那串。如果你后面要跑长期编码或者 Agent 任务，可以顺带看下 Coding Plan 页面 https://taotoken.net/coding-plan ，按自己的调用量选，不用一上来就买大的。

这一步不用装任何东西，纯粹是把「钥匙」和「门牌号」准备好。很多人卡在后面配置报 401，回头查半天，其实就是 Key 复制时带了空格，或者把控制台地址误当成 API 地址填进去了。API 地址结尾是/api，别填成网页地址。

3. 可复制配置：config.toml 骨架与 settings.json 片段

先把 openclaw 装干净。如果你之前装过，先清一遍：

npm uninstall -g openclaw Remove-Item -Recurse -Force "$env:USERPROFILE\openclaw" -ErrorAction SilentlyContinue Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue npm cache clean --force

然后把 npm 全局目录挪到 D 盘纯英文路径，这一步是 win10 中文用户名的救命操作：

mkdir D:\npm-global npm config set prefix D:\npm-global

接着把D:\npm-global加进系统 PATH，加完重开 PowerShell。安装时临时把用户目录指到 D 盘，避免脚本往中文目录里写：

$env:USERPROFILE = "D:\" npm install -g openclaw --registry=https://registry.npmmirror.com

装完检查一下入口文件在不在：

where.exe openclaw npm root -g Test-Path "D:\npm-global\node_modules\openclaw-cn\dist\entry.js"

正常应该输出D:\npm-global\openclaw.cmd、D:\npm-global\node_modules、True。如果openclaw.cmd里的路径不对，用记事本打开它，内容替换成：

@ECHO off SETLOCAL SET "OPENCLAW_ROOT=D:\npm-global\node_modules\openclaw-cn" node "%OPENCLAW_ROOT%\dist\entry.js" %* ENDLOCAL

同目录下那个无后缀的openclaw文件也改一下：

#!/bin/sh exec node "D:/npm-global/node_modules/openclaw-cn/dist/entry.js" "$@"

现在写配置。openclaw 的主配置是config.toml，放在D:\openclaw\config.toml（目录自己建）。下面这份骨架可以直接抄，把 Key 换成你自己的：

[gateway] host = "127.0.0.1" port = 8787 log_level = "info" [provider.taotoken] type = "openai-compatible" base_url = "https://taotoken.net/api" api_key = "sk-你的TaoTokenKey" default_model = "claude-sonnet-4-20250514" [channel.default] provider = "taotoken" model = "claude-sonnet-4-20250514" timeout_seconds = 120 [channel.coding] provider = "taotoken" model = "claude-sonnet-4-20250514" timeout_seconds = 300

base_url一定填https://taotoken.net/api，不要带后面的路径。type用openai-compatible是因为 TaoToken 的接口兼容这套协议，openclaw 能直接识别。

如果你用的客户端读settings.json（比如某些编辑器插件），片段这样写：

{ "openclaw.endpoint": "http://127.0.0.1:8787", "openclaw.channel": "default", "openclaw.apiKey": "sk-你的TaoTokenKey", "openclaw.timeout": 120000 }

注意这里的apiKey和config.toml里的是同一个，客户端只是通过本地网关转发，不直接连上游。

4. 启动与验证：确认 Key 生效、通道连通

配置写完，先跑一次配置检查：

openclaw config

它会打印当前解析到的 provider、base_url、默认模型。重点看base_url是不是https://taotoken.net/api，api_key有没有被正确读取（一般显示为掩码）。如果这里显示为空，说明config.toml路径不对，openclaw 默认读当前目录或~/.openclaw/config.toml，你可以用openclaw config --path看它到底读的哪个文件。

然后启动网关：

openclaw gateway run

看到监听127.0.0.1:8787就说明起来了。另开一个 PowerShell 窗口，发一条测试请求：

curl.exe http://127.0.0.1:8787/v1/chat/completions ` -H "Content-Type: application/json" ` -d '{\"channel\":\"default\",\"messages\":[{\"role\":\"user\",\"content\":\"说一句你好\"}]}'

返回里带choices和正常文本，就说明 Key 生效、通道连通。如果返回 401，是 Key 的问题；返回 404，多半是base_url多写了路径；返回超时，检查网络能不能正常访问taotoken.net。

想更直观地看模型通不通，直接去 https://taotoken.net/model 发一条对话，确认账号本身能正常调用。这一步能帮你快速区分是「账号/Key 问题」还是「openclaw 配置问题」。

最后开面板看整体状态：

openclaw dashboard

浏览器打开它提示的地址，能看到通道列表和最近请求记录。面板里default通道显示绿色、有请求计数，就闭环了。

5. 本篇常见错排查

openclaw不是内部或外部命令。PATH 没生效。确认D:\npm-global在系统变量 PATH 里，改完必须重开 PowerShell，旧窗口不会刷新。

启动报Cannot find module ...entry.js。openclaw.cmd里的OPENCLAW_ROOT路径写错了，或者包名不是openclaw-cn。去D:\npm-global\node_modules下看实际文件夹名，按实际改。

配置里 Key 明明填了却报 401。九成是复制时带了首尾空格，或者 Key 已经失效。重新去 https://taotoken.net/api-keys 生成一个，粘贴时注意别多选空格。

请求一直超时。先确认base_url是https://taotoken.net/api，没有多余斜杠或路径。再确认本机网络能正常访问该域名。如果公司网络有出口限制，换网络环境试。

改了config.toml不生效。openclaw 启动时读一次配置，改完要重启openclaw gateway run。另外确认你改的文件就是它实际读的那个，用openclaw config --path核对。

通道列表里没有default。config.toml里[channel.default]段名拼错，或者 TOML 缩进/引号有问题。TOML 对格式敏感，字符串必须用双引号，段名用方括号。

6. 接下来怎么走

装完这一套，你手上就有了一个本地网关：openclaw 负责收口，TaoToken 负责供模型。后面不管接编辑器、命令行还是自己写的 Agent，都只需要指向http://127.0.0.1:8787，Key 只在config.toml里维护一份。

如果你主要拿它跑长期编码任务，去 https://taotoken.net/coding-plan 看下套餐，比按量调用省心。日常调试模型效果，直接用 https://taotoken.net/model 最快。要新建或轮换 Key，入口在 https://taotoken.net/api-keys 。接入细节和参数说明都在 https://taotoken.net/doc ，遇到配置项拿不准就翻文档，比在群里问快。

最后留个实用习惯：把D:\openclaw\config.toml备份一份，换机器时直接拷过去改 Key 就能用，省得再走一遍安装。