企业官网建设流程全解析

1. Windows 上跑 OpenClaw 为什么绕不开 WSL2

OpenClaw 是一个面向个人和小团队的智能体网关，能对接多种大模型、管理节点、跑自动化任务。它本身没有原生 Windows 二进制包，官方推荐在 Linux 环境里运行。Windows 用户想“人人养虾”，最省事的路子就是 WSL2——Windows Subsystem for Linux 2，适用于 Linux 的 Windows 子系统第二版。它给你一个完整的 Linux 内核，性能接近原生，还能和 Windows 文件系统互通。

我试过直接在 Windows 上折腾 Node 环境，依赖冲突和路径问题能把人劝退。换成 WSL2 Ubuntu 之后，OpenClaw 的安装脚本一次跑通。这篇就按“PowerShell 启用 WSL2 → Ubuntu 初始化 → 依赖安装 → TaoToken 统一 Key 配置 → curl 验证”的顺序，把每一步的可复制命令和配置片段交给你。适合谁：用 Windows 10/11、想本地跑 OpenClaw 网关、又不想装双系统的开发者。核心检索词就三个：OpenClaw、WSL2、Windows。读完你能得到一个能启动、能验证、能排错的养虾环境。

先说清楚硬件门槛，避免白忙活。Windows 10 21H2+ 或 Windows 11；CPU 支持虚拟化（VT-x/AMD-V）；内存 8GB 起步，16GB 更稳；磁盘留 20GB 可用空间。低于这个配置，WSL2 和 OpenClaw 抢内存会很难受。

WSL2 和 WSL1 的区别值得提一句：WSL1 是系统调用翻译层，WSL2 是轻量虚拟机里跑真 Linux 内核。OpenClaw 依赖的一些网络和进程行为在 WSL2 下才正常，所以务必确认版本是 2。后面wsl -l -v那一步就是干这个的。

2. PowerShell 启用 WSL2 与 Ubuntu 初始化

这一章全在 Windows 侧操作，用管理员身份打开 PowerShell。最省心的是微软的一键安装：

wsl --install

这条命令会自动启用 WSL 功能、装 WSL2 内核、拉取 Ubuntu 默认发行版。跑完重启电脑，重启后 Ubuntu 会自动弹窗让你设用户名和密码。设完就进 Linux 了。

如果一键安装卡住或报错，走手动流程。逐条执行：

# 1. 启用 WSL 功能 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart # 2. 启用虚拟机平台 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart # 3. 重启电脑 Restart-Computer # 4. 设置 WSL 默认版本为 2 wsl --set-default-version 2 # 5. 安装 Ubuntu 22.04 wsl --install -d Ubuntu-22.04

重启后确认版本，这条命令的输出里 VERSION 必须是 2：

wsl -l -v

正常输出类似：

NAME STATE VERSION * Ubuntu-22.04 Running 2

如果 VERSION 显示 1，用wsl --set-version Ubuntu-22.04 2转换。转换过程可能几分钟，别中断。

进入 Ubuntu 环境，直接敲：

wsl

第一次进去先更新系统，再装依赖。OpenClaw 需要 Node.js 20 以上：

sudo apt update && sudo apt upgrade -y curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs node -v

node -v应输出 v20.x 或更高。然后装 OpenClaw：

npm install -g openclaw openclaw --version

到这一步，OpenClaw 本体就位。接下来是网络和 Key 配置，这才是能不能真正跑起来的关键。

注意：WSL2 默认用 NAT 网络，Windows 宿主机访问 WSL2 里的服务需要端口转发。新版 Windows 11 对 localhost 有自动转发，但 IP 每次启动可能变，后面会给启动脚本。

3. TaoToken 统一 Key 与 OpenClaw settings 配置

OpenClaw 要调用大模型，得配 API 通道。TaoToken 提供统一的 Key 和兼容接口，把 Base URL 指向https://taotoken.net/api，一个 Key 就能管多个模型。先去控制台拿 Key：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=console

拿到 Key 后，在 WSL2 Ubuntu 里配置 OpenClaw。OpenClaw 的配置文件通常在~/.openclaw/settings.json。先建目录：

mkdir -p ~/.openclaw

然后写入配置。下面这段是可复制的 JSON，路径和字段名按 OpenClaw 实际结构来：

{ "gateway": { "port": 7681, "host": "0.0.0.0" }, "providers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "model": "claude-sonnet-4-20250514", "type": "openai-compatible" } }, "defaultProvider": "taotoken" }

三个关键件必须齐全：Base URL 是https://taotoken.net/api，Key 是你控制台生成的，Model ID 按你要用的模型填。缺任何一个都会在启动时报错。

如果你用 Claude Code 或 Cline 这类工具，配置逻辑一样，把 Base URL 和 Key 填进对应位置即可。OpenClaw 的 provider 类型写openai-compatible，因为 TaoToken 的接口兼容 OpenAI 格式。

模型 ID 可以在模型对话页确认：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=models

配完保存，启动网关：

openclaw gateway start

如果提示端口占用，改 settings.json 里的 port，或者先openclaw gateway stop再启。

注意：Key 不要提交到 Git，也不要在截图里露出。settings.json 权限设成 600：chmod 600 ~/.openclaw/settings.json。

4. curl 验证连通性与端口转发实测

配置写完，先别急着开浏览器。用 curl 直接打 TaoToken 接口，确认 Key 和网络通：

curl -s https://taotoken.net/api/v1/models \ -H "Authorization: Bearer sk-你的TaoToken密钥" \ -H "Content-Type: application/json"

返回 JSON 里能看到模型列表，说明 Key 有效、网络可达。如果返回 401，是 Key 错了或没带 Bearer 前缀；返回超时，检查 WSL2 的 DNS。

再验证 OpenClaw 网关本身：

curl -s http://localhost:7681/health

返回{"status":"ok"}之类就说明网关起来了。

接下来处理 Windows 宿主机访问。先拿 WSL2 的 IP：

wsl hostname -I

假设输出172.20.10.5，在管理员 PowerShell 里加端口转发：

netsh interface portproxy add v4tov4 listenport=7681 listenaddress=0.0.0.0 connectport=7681 connectaddress=172.20.10.5 New-NetFirewallRule -DisplayName "OpenClaw" -Direction Inbound -LocalPort 7681 -Protocol TCP -Action Allow

然后在 Windows 浏览器访问http://localhost:7681。新版 Windows 11 通常自动转发，不生效再手动加。

WSL2 每次重启 IP 会变，转发规则就失效。写个启动脚本start-openclaw.ps1：

$wslIp = (wsl hostname -I).Trim() Write-Host "WSL2 IP: $wslIp" netsh interface portproxy delete v4tov4 listenport=7681 listenaddress=0.0.0.0 netsh interface portproxy add v4tov4 listenport=7681 listenaddress=0.0.0.0 connectport=7681 connectaddress=$wslIp wsl -e openclaw gateway start

每次开机跑一次这个脚本，转发和网关一起搞定。

资源占用高的话，在 Windows 用户目录建.wslconfig：

[wsl2] memory=4GB processors=2 swap=2GB localhostForwarding=true

改完wsl --shutdown再进。

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

养虾路上最容易卡在几个固定报错上，逐个拆。

401 Unauthorized：curl 或 OpenClaw 日志里出现 401，九成是 Key 问题。检查三点：Key 有没有复制全（前后空格也算错）；请求头是不是Authorization: Bearer sk-xxx；Key 有没有在控制台被禁用。重新生成一个 Key 再试。

local proxy failed / connection refused：OpenClaw 启动时报这个，通常是 Base URL 写错或网络不通。确认 settings.json 里是https://taotoken.net/api，不是https://taotoken.net/api/v1（路径重复会 404）。再 curl 一次接口确认网络。

reading choices 报错：调用模型后返回结构解析失败，报reading 'choices'之类。这多半是 Model ID 填错，或者 provider 类型没写openai-compatible。回 settings.json 核对 model 字段，去模型对话页确认可用 ID。

OAuth 相关报错：如果你用 Claude Code 接入，可能遇到 OAuth 流程问题。Claude Code 的配置在~/.claude/settings.json，Base URL 和 Key 要填对。参考接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=doc

WSL2 安装失败：先确认 BIOS 里虚拟化开了（VT-x/AMD-V）。wsl --install无响应就检查 Windows Update，或走手动 dism 流程。

DNS 解析失败：WSL2 里ping taotoken.net不通，改 DNS：

echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf

文件系统性能差：项目别放/mnt/c/，放/home/你的用户名/下，IO 快很多。

端口访问不了：Windows 防火墙拦了，确认New-NetFirewallRule那条执行过；或者 WSL2 IP 变了，重跑启动脚本。

排查顺序建议：先 curl TaoToken 接口 → 再 curl 网关 health → 再看 OpenClaw 日志openclaw logs --tail 50。日志里报错行通常直接指向配置字段。

6. 把养虾环境固化成日常流程

环境跑通只是开始，日常用起来要顺手。在 PowerShell 里加个别名，直接调 WSL 里的 OpenClaw：

function openclaw { wsl openclaw $args }

写进$PROFILE，以后openclaw status、openclaw nodes、openclaw logs --tail 20都能在 PowerShell 里直接敲。

长期跑编码和 Agent 任务的话，Coding Plan 比按量更划算，适合高频调用：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=coding-plan

Key 管理在 API Keys 页面，可以随时轮换：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=api-keys

最后提醒一句：WSL2 的 IP 会变，启动脚本记得每次开机跑；settings.json 权限锁 600；Key 别外泄。把这三件事做成习惯，OpenClaw 在 Windows 上就能稳定养虾了。