企业官网建设流程全解析

OpenClaw 的 Control UI 报unauthorized: gateway token missing，是最近被问得最多的一类排障。TaoToken 在这件事里只负责后半段——OpenClaw 进到 Control UI 之后，调模型要用的 Key 和 Base URL；模型 Key 到 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册后创建就行。而gateway token missing这行报错本身，跟模型 Key 一点关系都没有，它要的是openclaw dashboard --no-open打印出来的那条带 token 的链接里的凭证。

把这两件事混在一起，是绝大多数人卡半天出不来的原因：来回换了三把模型 Key，Control UI 依然不给进；或者好不容易进了 Control UI，会话发出去还是没回复，又回头怀疑 token 不对。下面按「先解决进不去、再解决调不通」的顺序拆开讲。前半段完全跟着 OpenClaw 自己的机制走，不动系统里任何东西；后半段配模型通道时，才轮到填 TaoToken 的 Key 和 Base URL。

1. Control UI 报 unauthorized: gateway token missing 卡在哪一层

1.1 三种表现，先对号入座

同一个报错，在三种环境下长相不太一样，先看清自己属于哪一种，能省掉一半无效操作。

第一种是页面直接顶着一行unauthorized: gateway token missing，Control UI 的会话列表、设置面板全都灰着，点了没反应。这种是认证层就没过，请求根本没进到 gateway 内部。

第二种是页面能正常打开，能点设置、能新建会话，但只要在设置面板里保存一次，右上角就弹回同一个报错，或者刷新之后又变回未授权。这种通常是 URL 里带了 token、但保存时被浏览器丢掉了，或者你手动改了地址栏之后 token 参数被截断。

第三种是 Control UI 完全正常，会话也能发出去，只是模型回一段很短的错误。这种其实已经不是gateway token missing了，属于模型通道没配好，放到后面第 5 节处理。

三种里前两种是同一类问题，解决动作都是重新拿一条带 token 的 dashboard 链接；第三种跟 gateway token 没关系，别再折腾那一栏。

1.2 gateway token 和模型 API Key 是两把完全不同的钥匙

gateway token 是本地 OpenClaw 进程给自己签的一张进入凭证。它跟这次启动的进程绑定，跟端口绑定，多数情况下还有时效——进程重启、端口复用之后旧 token 就作废。它的作用是让浏览器这一端证明「我是这个 gateway 实例的合法访问者」，不涉及任何外部服务。

模型 API Key 是另一回事。它是你调外部模型通道时出示的凭据，跨机器、跨进程都能用，跟 OpenClaw 的启动方式无关。TaoToken 提供的就是这一类：一把 Key 加一个统一的 Base URL，OpenClaw 以及其他工具都填同一套。

把两者搞混之后最常见的操作是：看到unauthorized就去翻模型设置，把 API Key 复制粘贴进 gateway 认证那一栏。结果是两栏都错，Control UI 进不去，模型也调不通。判断方法很简单——报错里带gateway字样的，去处理 dashboard token；报错里带401、model、provider字样的，去处理模型通道。

2. 用 openclaw dashboard --no-open 拿回那条带 token 的链接

2.1 为什么要加 --no-open

默认执行openclaw dashboard时，命令会尝试自动拉起系统默认浏览器，把带 token 的地址直接打开。在本地桌面环境这很舒服，但在服务器、容器、WSL、远程开发机、跳板机这些地方，这一步经常是静默失败的：命令跑完了，终端只留了一行提示，浏览器要么没弹，要么弹的是另一台机器上的浏览器，你根本看不到那条链接。

加--no-open就是让它别自作主张，把完整 URL 老老实实打印到终端上，由你自己决定怎么用。命令本身很短：

openclaw dashboard --no-open

执行之后，终端会输出一条完整地址，形态大致是http://127.0.0.1:端口/?token=一串字符。具体端口和参数名以你终端的实际输出为准，不同版本可能略有差异，别照着别人的截图抄。

拿到这条地址之后有两条路：本地能访问就直接粘进浏览器；远程机器上跑的，可以用 SSH 端口转发把那个端口映射到本地，再在本地浏览器打开。不管走哪条，token 都必须原样保留在地址里。

2.2 把 token 从 URL 里摘出来粘进 Control UI Settings

有些版本打开那条链接后会直接进到已登录状态，不用你手动粘。但如果你看到的是一个要求填 token 的页面，或者页面进去了设置面板仍显示未授权，就要手动处理：

1. 复制终端打印的整条 URL，先别做任何删改。
2. 在浏览器地址栏粘贴并打开。
3. 如果页面要求填 token，从地址里token=后面开始，一直取到下一个&之前（没有&就取到结尾），这一段就是 token。
4. 打开 Control UI 的Settings，找到 gateway 认证相关的那一栏，把 token 粘进去，保存。
5. 保存后刷新一次页面，看会话列表是否恢复正常。

这一步有个很隐蔽的坑：用聊天软件或笔记软件转发那条 URL 时，长字符串容易被自动折行、加空格，或者被识别成链接后截断。粘进去之后如果保存失败，先检查 token 首尾有没有多余空格，中间有没有被塞进换行。

提示：token 是一串随机字符，不要为了「看起来整齐」手动分段或加连字符。原样复制粘贴是唯一正确的做法。

2.3 这一步就打不开时的三个检查点

端口被占。如果命令报端口冲突，先看是不是上一次的 OpenClaw 进程还没退干净。同一个端口上跑着两个实例时，后启动的那个可能换了端口，而你手里的链接还是旧的。

绑定地址不对。输出里如果是127.0.0.1，那只有本机能访问。远程开发机上跑的时候要确认它监听的是哪个网卡地址，或者干脆用 SSH 转发，别去改绑定地址硬暴露。

token 已经过期。链接拿到手放了很久才用，或者中途重启过进程，token 大概率失效了。重新执行一次openclaw dashboard --no-open，用新打印的那条链接，旧的就丢掉。

这三条都排掉，Control UI 基本就能进了。进去之后你会发现，会话还是发不出有内容的回复——那是下一段的事。

3. 进 Control UI 配模型供应商：Base URL 填 https://taotoken.net/api

3.1 先去官网注册并创建一把 API Key

Control UI 里能进去了，接下来给它配一条真正能调通的模型通道。这一步需要一把 API Key，去 TaoToken 注册登录，进控制台创建一个，复制出来备用。创建页面就在控制台的 API Keys 区域，Key 只在创建时完整显示一次，复制不到就删掉重建一把，别反复试。

拿到之后先在本地存好，后面表单里的 Key 字段就填它。注意区分：这把 Key 是给模型通道用的，不是拿来解gateway token missing的，粘错地方会继续报未授权。

3.2 模型供应商表单四个字段怎么填

Control UI 里添加模型供应商，通常就是下面这四个字段。字段名各版本叫法可能不同，对着含义填就行：

Base URL 这一栏是最容易填错的。正确写法是https://taotoken.net/api，末尾不带/v1，也不带任何查询参数。有人习惯性在末尾补/v1，结果请求打到不存在的路径上，回包是 404 或者路径错误提示，看起来像 Key 无效，其实是地址多了一截。

另外，工具里填的 Base URL 和浏览器里打开的官网不是同一个地址，别把落地页地址填进配置里。落地页只用来注册、创建 Key、看模型列表和用量。

3.3 模型 ID 别自己手写日期后缀

Model ID 这一栏，以 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 模型广场当时列表为准。模型列表会更新，手动拼一个带日期后缀的名字，很容易拼出一个并不存在的 ID，报错信息又往往只说「模型不可用」，排查方向就被带偏了。

建议的做法是：在模型广场里找到要用的那个模型，直接复制它的 ID，原样粘进表单，不做任何修改。切换模型时也只改这一栏，其他三栏不用动。

4. 发一条最小请求，确认模型通道真的通了

4.1 在 Control UI 里测最省事

配置保存之后，别急着装插件、挂工具，先发一条最小请求。新建一个会话，输入一句最简单的话，比如「你好」，发送。

能收到正常回复，说明三件事同时成立：Control UI 认证过了、模型通道地址填对了、Key 有效。这时候再去做复杂的事情才有意义。

如果收到的是一段错误信息，先看错在哪一层。页面顶部弹未授权，那是第 2 节的问题，回去重新拿 token；回复里是 401、403 之类的状态码，那是 Key 的问题；回复里提示路径不存在，那是 Base URL 多写了东西。分清层级再动手，别一看到红色就全部重配一遍。

4.2 命令行对照：一条命令验证 Key 本身

有时候分不清是 OpenClaw 的配置问题还是 Key 本身有问题，可以用命令行单独验一次，把变量隔离出来：

npm install -g @taotoken/taotoken taotoken cc -k YOUR_API_KEY -u https://taotoken.net/api -m YOUR_MODEL_ID

这条命令如果返回正常结果，说明 Key、Base URL、模型 ID 三样都是好的，问题出在 OpenClaw 的供应商表单上，回去逐字段对照第 3 节的表格。如果这条也报错，那就是 Key 或模型 ID 本身的问题，去控制台核对一下再回来。

两条路都走一遍，基本不会再有「不知道哪里错了」的状态。

4.3 通了之后回控制台对一下这次调用

第一次调通之后，建议去 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 看一眼用量记录，确认刚才那次请求确实记在了这把 Key 上。这一步有两个好处：一是验证 Key 没填错（填错会记到别的 Key 上），二是顺便熟悉一下控制台的用量页面，以后排查「请求发出去了但没结果」时有据可查。

5. 仍旧报 gateway token missing 时的排查顺序

5.1 先分清是认证没过还是模型挂了

判断方法看报错出现的位置。报错顶在页面最上方、会话列表不可用、设置面板打不开——这是认证层没过，属于 gateway token 的问题。报错出现在具体会话的消息气泡里、或者以结构化 JSON 返回——这是模型通道的问题，跟 gateway token 无关。

分清楚之后，前者只有一个动作：重新执行openclaw dashboard --no-open，用新链接里的 token 覆盖旧的。后者去看 Key、Base URL、模型 ID 三个字段。

很多人在这里绕圈，是因为把两种报错都当成同一件事，于是反复重装、反复重启，问题一直没被定位。

5.2 token 粘错位置、多实例、浏览器缓存

三个最常见的原因，按概率排：

粘错栏位。把模型 API Key 粘进了 gateway 认证那一栏。两个输入框挨得近的时候很容易看串行，粘完把模型 Key 那一栏也顺手检查一遍。

多实例端口复用。同时开了两个 OpenClaw 实例，端口不同，各自的 token 不通用。你打开的页面可能来自 A 实例，手里的链接却是 B 实例打的。确认一下页面地址里的端口跟链接里的端口一致。

浏览器缓存了旧 token。之前失败过几次之后，浏览器可能一直在用缓存里的旧凭证。开一个无痕窗口重新粘一遍，或者硬刷新一次页面，能排除掉这一类。

5.3 模型侧的两类回包：401 和地址多一截

如果报错确实来自模型通道，重点看两种。

一种是 401 或未授权。多数情况是 Key 复制时带了空格，或者复制到的是不完整的一段。删掉重建一把最省事，别去猜哪几个字符错了。

另一种是路径不存在或者 404。这种几乎都是 Base URL 写错了：末尾多了/v1，或者把官网落地页地址填了进去。正确写法只有一种，https://taotoken.net/api，其余变体都会出问题。

把这两类对照一遍，模型通道基本就稳定了。

6. 两把凭证分开管，之后换模型不用再动 Control UI

6.1 什么时候需要重新跑一次 dashboard 命令

gateway token 跟进程和端口绑定，所以下面这几种情况都要重新拿一次：重启了 OpenClaw、换过监听端口、换了访问的机器、链接放了很久没用。这不是故障，是它本来的工作方式。碰到就重新执行一次openclaw dashboard --no-open，用新链接进 Control UI，不需要动模型那边的任何配置。

6.2 换模型时只改一个字段

模型通道配好之后，想换一个模型，只需要改供应商表单里的 Model ID 那一栏，其他三栏保持原样。Base URL 永远是https://taotoken.net/api，不带/v1；Key 也还是控制台里那把，除非你主动轮换了它。

这样分开管之后，两件事就再也不会互相干扰：进不去 Control UI 时只看 dashboard token，模型不回话时只看通道三要素。

配置保存并调通之后，可以先用同一把 Key 在 模型对话 里发一条测试消息，确认模型和地址都没填串行；如果 OpenClaw 是长期挂着的编码场景，去 Coding Plan 看套餐够不够用；Key 本身则在 控制台 API Keys 里创建和轮换。三条链接对应三件不同的事，别互相替代。