企业官网建设流程全解析

1. 为什么要在 WSL2 里跑 OpenClaw，以及它到底解决什么问题

如果你在 Windows 11 上折腾过 OpenClaw，大概率会卡在同一个地方：Node.js 装好了，npm install -g openclaw也跑完了，但一到网关服务启动、模型接入这一步就开始报错。原因不复杂——OpenClaw 的网关依赖 systemd 管理进程，而 Windows 原生环境没有 systemd，Docker 方案又容易在文件挂载和端口映射上出岔子。WSL2 是目前兼容性最稳的折中方案，它直接调用 Linux 内核，文件 I/O 和进程调度接近原生，同时 Windows 和 Linux 文件系统互通，调试和传文件都方便。

这篇笔记聚焦的是「Node.js 环境就绪之后」的那段链路：怎么用 TaoToken 的统一 Key 和 API 通道把 OpenClaw 接上模型，怎么落地一份能直接复制的config.toml骨架，以及三步验证动作——启动无报错、Key 生效、请求返回正常。适合个人开发者在本地自测场景下跟做，环境是 Windows 11 + WSL2 + Ubuntu 24.04。

先说清楚 OpenClaw 是什么：它是一个基于 Node.js 的 AI Agent 网关程序，装好之后会在本地起一个服务，对外暴露一个端口，你通过它来调度模型、管理会话、连接设备。它本身不绑定某一家模型，而是通过 API Key 去调用上游。TaoToken 在这里扮演的角色是「统一 Key / API 通道」——你不用为每个模型单独配一套 Key 和地址，而是用同一个 Key、同一个 base URL 去访问不同模型，配置层只维护一份。

适合谁：手上有 Windows 11 机器、想本地跑 Agent 做自测、又不想被多套 Key 管理搞晕的个人开发者。如果你只是想体验一下对话，那直接用网页版就行；但如果你要长期跑编码任务、接 Agent 工作流，把配置骨架搭对，后面省事很多。

2. TaoToken 前置准备：Key、通道与文档入口

在动config.toml之前，先把 TaoToken 这边的三样东西准备好，不然后面配置填不进去。

第一样是 API Key。登录 TaoToken 控制台，在 API Keys 页面创建一个新 Key，复制出来存好。这个 Key 就是 OpenClaw 调用模型时的凭证，格式通常是一串以特定前缀开头的字符串。创建入口在这里：

API Keys 管理页：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite

第二样是 API 通道地址。TaoToken 的 API 基址是https://taotoken.net/api，注意这个地址不带任何查询参数，配置里直接写这个就行。OpenClaw 的模型请求会打到这个 base URL 上，由 TaoToken 转发到对应模型。

第三样是文档。配置字段的含义、支持的模型名、请求格式，都以文档为准，别凭记忆填：

接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

如果你还没注册，官网入口在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册后在控制台里能同时看到 Key 管理和用量统计。

这里有个容易踩的坑：很多人把 Key 直接写进config.toml然后提交到 Git，结果泄露。正确做法是 Key 走环境变量，config.toml里只引用变量名。下面第三节会给出两种写法，你按自己的习惯选。

另外提醒一句，TaoToken 是合规的 API 聚合通道，不是所谓的「中转」黑话里那种东西，配置时按正常 API 服务对待即可。

3. 可复制配置：环境变量写法与 config.toml 骨架

这一节是全文的核心，直接给可复制的片段。先确认你的 OpenClaw 已经装好，openclaw --version能输出版本号。配置文件默认位置在~/.openclaw/config.toml，如果没有就手动创建。

3.1 环境变量写法

推荐把 Key 和 base URL 放在 shell 环境变量里。编辑~/.bashrc，追加：

# TaoToken 统一 Key 与 API 通道 export TAOTOKEN_API_KEY="sk-你的实际Key" export TAOTOKEN_BASE_URL="https://taotoken.net/api"

然后source ~/.bashrc让它生效。验证一下：

echo $TAOTOKEN_API_KEY echo $TAOTOKEN_BASE_URL

能打印出内容就对了。这样做的好处是config.toml里不出现明文 Key，换 Key 时只改环境变量，不用动配置文件。

3.2 config.toml 骨架

下面这份骨架可以直接复制，字段按你的实际情况微调。注意 TOML 的字符串用双引号，布尔值是小写true/false。

# ~/.openclaw/config.toml # OpenClaw 网关配置骨架 - TaoToken 统一 Key 接入 [gateway] # 网关监听端口，默认 28789，被占用时改成 28790 等 port = 28789 # 监听地址，本地自测用 127.0.0.1 即可 host = "127.0.0.1" # 是否开机自启（配合 systemd 使用） auto_start = true [model] # 统一走 TaoToken 通道 provider = "taotoken" # 从环境变量读取，避免明文写 Key api_key = "${TAOTOKEN_API_KEY}" # API 基址，不带查询参数 base_url = "https://taotoken.net/api" # 默认模型名，按文档里支持的名称填 default_model = "claude-sonnet-4" # 请求超时（秒） timeout = 60 [model.params] # 采样温度，编码任务建议低一点 temperature = 0.3 # 单次最大输出 token max_tokens = 4096 [session] # 会话数据存放目录 data_dir = "~/.openclaw/sessions" # 单会话最大轮数，防止上下文无限增长 max_turns = 50 [log] level = "info" # 日志文件路径 file = "~/.openclaw/logs/openclaw.log"

几个字段说明一下。provider填taotoken表示走统一通道；api_key用${TAOTOKEN_API_KEY}这种形式引用环境变量，OpenClaw 启动时会去读；base_url就是前面说的https://taotoken.net/api。default_model具体填什么，以文档里的模型列表为准，别照抄我这里的示例名。

如果你不想用环境变量，也可以直接写明文，但仅限本地自测，别提交到仓库：

[model] provider = "taotoken" api_key = "sk-你的实际Key" base_url = "https://taotoken.net/api" default_model = "claude-sonnet-4"

3.3 网关服务注册

配置写好后，注册并启动网关服务。Ubuntu 24.04 默认已经开了 systemd，如果没开，参考第五节排查。

# 注册网关服务 openclaw gateway install # 启动服务 systemctl --user start openclaw-gateway.service # 设置开机自启 systemctl --user enable openclaw-gateway.service

查看状态：

openclaw gateway status

看到active (running)就说明服务起来了。如果报端口冲突，把config.toml里的port改成 28790 再重来一遍。

4. 三步验证：启动无报错、Key 生效、请求返回正常

配置写完不算完，得验证。我把它拆成三步，每步都有明确的预期结果，哪步不对就回去查对应的地方。

4.1 第一步：启动无报错

openclaw gateway status

预期输出里有active (running)，并且日志里没有error级别的记录。如果服务没起来，先看日志：

tail -n 50 ~/.openclaw/logs/openclaw.log

常见的是端口占用和配置文件语法错误。TOML 对格式敏感，少个引号都会解析失败，日志里会明确告诉你哪一行有问题。

4.2 第二步：Key 生效

这一步验证 TaoToken 的 Key 有没有被正确读取。执行一次模型列表拉取或者简单的连通性检查：

openclaw model list

如果 Key 无效或没读到，这里会返回 401 或提示未授权。确认环境变量在当前 shell 里能打印出来，并且config.toml里的api_key字段引用正确。注意一个细节：systemctl --user启动的服务，环境变量是从 systemd 的用户环境读的，不一定继承你~/.bashrc里的导出。如果遇到 Key 读不到，用下面这个方式把变量注入 systemd：

systemctl --user import-environment TAOTOKEN_API_KEY TAOTOKEN_BASE_URL systemctl --user restart openclaw-gateway.service

4.3 第三步：请求返回正常

发一条测试消息，确认整条链路通了：

openclaw agent --message "你好，做个连通性测试" --session-id test

预期结果是终端返回模型的回复内容。如果返回超时，检查base_url是不是写成了带路径的地址；如果返回 404，多半是模型名填错了，回文档核对default_model。返回正常就说明从 OpenClaw 到 TaoToken 再到上游模型的链路是通的。

三步都过了，你的本地自测环境就算搭好了。后面要换模型，只改default_model一个字段就行，Key 和 base URL 不用动，这就是统一通道的价值。

5. 本篇常见错排查：端口冲突、systemd 未启、Key 读取失败

把这篇里最容易翻车的几个点集中说一下，遇到问题按顺序排查。

端口冲突导致启动失败。报错信息里通常带address already in use或28789。先查谁占用了：

ss -tlnp | grep 28789

找到占用进程后，要么停掉它，要么改 OpenClaw 的端口。改端口就是编辑config.toml的[gateway]段，把port换成 28790，然后强制刷新服务：

openclaw gateway install --force systemctl --user restart openclaw-gateway.service

systemd 未启用。Ubuntu 24.04 的 WSL2 默认开了 systemd，但如果你是从旧版本升级上来的，可能没开。检查/etc/wsl.conf：

cat /etc/wsl.conf

如果没有[boot]段和systemd=true，用sudo nano /etc/wsl.conf加上：

[boot] systemd=true

然后在 Windows PowerShell（管理员）里执行wsl --shutdown，重新打开 WSL 终端。验证：

systemctl --user status

看到active (running)就对了。

Key 读取失败。表现是openclaw model list返回 401。三个检查点：环境变量在当前 shell 能否打印；config.toml里api_key的引用写法是否正确；systemd 用户环境有没有拿到变量。前两个好查，第三个用systemctl --user import-environment解决，前面 4.2 节写过。

配置文件语法错误。TOML 解析失败时服务起不来，日志里会指出行号。常见的是字符串没加引号、布尔值写成了True而不是true、段名拼错。改完保存，重启服务即可。

请求超时。如果base_url写成了https://taotoken.net/api/v1这种带路径的形式，可能拼出错误的请求地址。统一用https://taotoken.net/api，路径由 OpenClaw 自己拼。

6. 后续怎么用：模型对话、编码计划与文档入口

配置搭好之后，日常使用有几个方向。如果你只是想验证模型通不通、快速对话，用模型对话页面最直接：

模型对话：https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite

如果你要长期跑编码任务、接 Agent 工作流，建议看一下 Coding Plan，它针对持续性的编码场景做了额度规划：

Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite

配置过程中遇到字段含义不清楚的，回文档查，别猜：

接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

Key 管理和用量查看在控制台：

控制台：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite

最后说个实际经验：config.toml改完之后，养成先openclaw gateway status看一眼再发请求的习惯。很多「请求失败」其实是服务根本没起来，白排查半天模型配置。另外环境变量注入 systemd 那一步，第一次配的时候容易漏，记住import-environment这个命令，能省不少时间。