企业官网建设流程全解析

当 OpenClaw onboard 让你 Skip for now：Windows/WSL2 用户最容易踩的模型通道坑

如果你正在 Windows 或 WSL2 里按教程部署 OpenClaw，大概率会在openclaw onboard的Model/auth provider这一步看到官方示例写着 “Skip for now”。很多人照做之后，openclaw gateway start确实能跑起来，openclaw gateway status也显示 Running，浏览器打开http://127.0.0.1:18789/界面正常——但真正发一条消息让它干活时，才发现 OpenClaw 根本没有可用的模型通道，回复要么超时要么直接报错。

这篇不重复讲 Node.js 环境、PowerShell 权限、WSL 安装这些步骤，而是专门解决“onboard 跳过了模型 API 之后怎么补回来”这个问题。核心思路是：在 onboard 的 Model/auth provider 环节不要跳过，改为填入 TaoToken 提供的 Base URL 和 Key。TaoToken 官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end ，注册后创建 Key，Base URL 用 https://taotoken.net/api 即可。TaoToken 只负责提供模型通道的 Key 和 Base URL，不替 OpenClaw 处理飞书插件、systemd 或 gateway 进程管理，这些仍然由 OpenClaw 自己负责。

下面按“问题场景 → 前置准备 → 可复制配置 → 验证 → 排错 → 下一步”的顺序展开，Windows 原生和 WSL2 两条路径都适用。

一、原问题与场景：Skip for now 之后到底缺了什么

先把问题定位清楚。OpenClaw 的 onboard 向导里，Model/auth provider这一步的作用是告诉 OpenClaw：当你发一条消息时，它应该把请求发到哪个模型服务、用哪个 Key 鉴权。官方示例让你选 “Skip for now”，本意是“先不配模型，等核心服务跑通再回来配”。但很多教程到这里就结束了，读者以为 gateway Running 就等于装好了。

实际结果是：

• openclaw gateway start成功，因为 gateway 本身不依赖模型通道就能启动；
• openclaw gateway status显示 Running，因为进程活着；
• 打开http://127.0.0.1:18789/能看到控制台，因为 Web 服务独立于模型；
• 但你在控制台或飞书里发一条消息，OpenClaw 需要调用模型时，发现没有配置 provider，于是请求失败或一直挂起。

这就是“gateway 能 start，但 OpenClaw 真正干活时没有模型通道”的典型表现。尤其在 Windows 原生 PowerShell 方案里，很多人装完就以为完事了；WSL2 方案里因为 systemd 配好了、服务自启了，更容易误以为一切正常。

所以正确的做法不是“跳过”，而是在 onboard 到 Model/auth provider 时，选择自定义/兼容通道（不同版本文案可能是 Custom、OpenAI-compatible、Other 之类），然后填入：

• Base URL：https://taotoken.net/api
• API Key：你在 TaoToken 创建的 Key

如果你已经跳过了 onboard，也不用重装，重新运行openclaw onboard --install-daemon回填即可。下面先讲前置准备。

二、TaoToken 前置：注册、创建 Key、确认 Base URL

在改 onboard 配置之前，先把模型通道的凭证准备好。这一步和 OpenClaw 本身无关，只是拿到 Key 和 Base URL。

1. 打开 TaoToken 官网：https://taotoken.net/?utm_source=taotoken_aicg_blog_end
2. 注册并登录账号。
3. 进入控制台，找到 API Keys 页面，创建一个新的 Key。创建后立即复制保存，页面通常只显示一次。
4. 确认 Base URL 为：https://taotoken.net/api

这里要强调一点：TaoToken 提供的是模型通道的 Key 和 Base URL，它不负责 OpenClaw 的飞书插件安装、systemd 配置、gateway 进程守护。也就是说，你仍然需要按 OpenClaw 官方流程把 gateway 跑起来，TaoToken 只解决“模型请求发到哪里、用什么鉴权”这一层。

如果你还没有 Key，可以先访问 API Keys 页面创建：https://taotoken.net/console/api-keys 。创建完成后回到 OpenClaw 的 onboard 或配置文件里填入。

另外，如果你打算长期在 OpenClaw 里跑编码类 Agent 任务，可以了解一下 Coding Plan，它更适合高频、长期的模型调用场景：https://taotoken.net/coding-plan 。本篇主要解决接入配置，不展开套餐对比。

三、可复制配置：在 onboard 里选自定义通道并填入 Base URL/Key

这一节分两种情况：还没跑 onboard 的，和已经跑过 onboard 想回填的。

3.1 还没跑 onboard：在 Model/auth provider 选自定义

Windows 原生 PowerShell 或 WSL2 Ubuntu 终端里，执行：

openclaw onboard --flow quickstart

或者 WSL2 方案里带 daemon 的：

openclaw onboard --install-daemon

走到Model/auth provider这一步时，不要选 “Skip for now”。选择自定义/兼容通道，常见文案是：

• Custom
• OpenAI-compatible
• Other
• 自定义 Provider

不同 OpenClaw 版本文案略有差异，认准“可以手动填 Base URL 和 API Key”的那个选项。

然后按提示填入：

Base URL: https://taotoken.net/api API Key: YOUR_API_KEY Model: 按你需要的模型 ID 填写

把YOUR_API_KEY替换成你在 TaoToken 创建的真实 Key。Model ID 填你在 TaoToken 侧确认可用的模型标识。

3.2 已经跑过 onboard：重新运行回填

如果你已经选了 Skip for now，不需要卸载重装。直接重新运行：

openclaw onboard --install-daemon

再次走到 Model/auth provider 时，这次选自定义通道并填入上面的 Base URL 和 Key。向导会更新配置。

3.3 配置文件方式（可选）

部分 OpenClaw 版本会把 provider 配置写到本地配置文件里。如果你熟悉配置文件，也可以在 onboard 之外手动检查。但建议优先用 onboard 回填，避免字段名写错。配置完成后，继续启动 gateway：

openclaw gateway start openclaw gateway status

看到 Running 后，打开http://127.0.0.1:18789/进行验证。注意：gateway Running 只代表进程正常，不代表模型通道可用，真正的验证在下一步。

四、验证请求与成功结果：发一条消息确认能消耗 Token

配置完模型通道后，必须做一次端到端验证，否则你无法确认 OpenClaw 是否真的能调用模型。

1. 确认 gateway 在跑：

openclaw gateway status

输出应为 Running。

2. 打开浏览器访问：

http://127.0.0.1:18789/

3. 在控制台对话框里发一条简单消息，比如“你好，请回复一句话”。

4. 观察结果：

• 如果 OpenClaw 正常回复，说明模型通道已打通；
• 同时去 TaoToken 控制台查看用量，确认有 Token 消耗记录；
• 如果回复超时或报鉴权错误，回到第五节排查。

成功标志有三个：控制台能收到回复、TaoToken 侧有调用记录、gateway 日志里没有 provider 相关报错。

如果你在飞书里也配了插件，可以在飞书里发一条消息做同样的验证。但注意，飞书插件和模型通道是两件事：飞书插件负责消息进出，模型通道负责生成回复。两者都配好，才能在飞书里完整体验。

五、本篇常见错排查

这一节只列和“模型通道/onboard 配置”相关的错误，不重复讲 WSL 安装和 PowerShell 权限。

错误 1：gateway Running 但发消息无响应

原因：onboard 时选了 Skip for now，没有配置 provider。 解决：重新运行openclaw onboard --install-daemon，在 Model/auth provider 选自定义通道，填入https://taotoken.net/api和你的 Key。

错误 2：报鉴权失败/401/Unauthorized

原因：Key 填错、Key 已删除、或 Base URL 写成了别的地址。 解决：回到 TaoToken 控制台确认 Key 有效，重新复制；确认 Base URL 是https://taotoken.net/api，不要多加路径或斜杠。

错误 3：请求超时/连接失败

原因：Base URL 填错，或本地网络无法访问该地址。 解决：确认 Base URL 拼写正确；在终端里测试网络连通性；如果你在 WSL2 里，确认 WSL 的网络能正常出站。

错误 4：onboard 里找不到自定义/兼容通道选项

原因：OpenClaw 版本不同，文案不一样。 解决：找带“手动填 Base URL”的选项，常见为 Custom、OpenAI-compatible、Other。如果确实没有，可以先用 onboard 跳过，再通过配置文件方式补，或升级 OpenClaw 版本。

错误 5：改了配置但没生效

原因：gateway 没有重启，仍用旧配置。 解决：openclaw gateway stop后再openclaw gateway start，或按你的部署方式重启服务。WSL2 下如果用了 systemd，确认服务已重新加载。

错误 6：飞书里能用但控制台不能用，或反过来

原因：飞书插件和模型通道是两套配置，可能只配了一边。 解决：分别确认飞书插件绑定和模型 provider 配置。模型通道问题看本节前几条；飞书插件问题参考 OpenClaw 插件文档。

排错时建议先看 gateway 日志，再对照 TaoToken 控制台的调用记录，能快速判断是“请求没发出去”还是“发出去了但被拒绝”。

六、配好模型通道之后：继续把 OpenClaw 跑成长期可用的 Agent

模型通道打通只是第一步。接下来你可以：

• 在控制台里继续测试不同模型 ID，找到适合你任务的组合；
• 配置飞书插件，把 OpenClaw 接入 IM；
• 在 WSL2 里确认 systemd 自启，让 gateway 长期稳定运行；
• 根据使用频率，考虑更适合长期编码/Agent 场景的 Coding Plan。

如果你在接入过程中需要确认 Key、Base URL 或查看调用文档，可以从这里进入：

• 创建和管理 Key：https://taotoken.net/console/api-keys
• 接入文档：https://taotoken.net/doc
• 模型对话验证：https://taotoken.net/models
• 长期编码/Agent 场景：https://taotoken.net/coding-plan

回到本篇的核心：OpenClaw onboard 遇到 Model/auth provider 时，不要习惯性选 Skip for now。先把 TaoToken 的 Key 和 Base URL 准备好，在 onboard 里选自定义/兼容通道填进去，再启动 gateway、发消息验证。这样你才不会出现“gateway Running 但 OpenClaw 不干活”的尴尬。已经跳过的，重新跑一次openclaw onboard --install-daemon回填即可。