企业官网建设流程全解析

1. openclaw gateway 启动失败与端口占用排查：从首次运行到 restart 的完整路径

openclaw 是一个把本地工具链、模型通道和自动化任务串起来的网关型工具，gateway 是它的核心进程，负责监听端口、转发请求、管理会话。很多人第一次跑openclaw gateway --port 18789时觉得应该一把过，结果要么端口被占，要么 restart 之后进程没起来，要么 endpoint 还指向默认地址导致请求 401。这篇笔记就围绕 openclaw gateway 的启动、restart、端口排查，以及把 endpoint 改到 TaoToken 统一通道这条主线，把每一步都拆成可复制的操作。

适合谁看：刚接触 openclaw、准备把它接到统一 API 通道的开发者；已经能启动但 restart 后行为异常的人；以及想搞清楚 gateway 端口到底被谁占用、怎么快速定位的人。我试过在 macOS 和 Linux 上各跑一遍，下面命令两边通用，Windows 用 PowerShell 对应替换即可。

核心检索词先摆出来：openclaw gateway 启动、openclaw gateway restart、gateway 端口占用排查、openclaw endpoint 配置。这四个词贯穿全文，你照着做就能把 gateway 跑起来并接到 TaoToken。

先说结论性的路径：确认 openclaw 安装 → 检查端口占用 → 写 gateway 配置 → 启动 → 改 endpoint 到 TaoToken → 验证请求 → restart 排查。每一步都有对应的命令和预期输出，遇到报错直接跳到第 5 节对照。

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

在动 gateway 配置之前，先把 TaoToken 的通道准备好，否则 endpoint 改了也没法验证。TaoToken 提供统一的 API 入口，你只需要一个 Key 就能在多个模型之间切换，不用为每个模型单独维护一套鉴权。

第一步，打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 注册并登录。登录后进入控制台，地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 。在控制台里找到 API Keys 页面，路径是 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite ，点新建 Key，复制出来。这个 Key 就是后面配置里的TAOTOKEN_API_KEY。

第二步，确认 API Base URL。TaoToken 的 API 根地址是 https://taotoken.net/api ，注意这个地址不带任何查询参数，配置里直接写它。模型 ID 方面，你可以在模型对话页面 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 里先试跑一下，确认哪个模型可用，再把对应的 Model ID 填进 openclaw 配置。常见的比如claude-sonnet-4-5、gpt-4o这类，具体以你控制台里看到的为准。

第三步，如果你打算长期跑编码或 Agent 任务，可以看下 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 ，里面有各语言的调用示例，配置遇到不确定的参数可以对照。

这里要强调三件套的概念：Base URL、Key、Model ID。无论你后面用 openclaw、Cline MCP 还是 Codex 的 auth.json，这三个值都是必须对齐的。Base URL 固定为https://taotoken.net/api，Key 从 api-keys 页面拿，Model ID 从模型对话或文档里确认。三件套对齐了，401 和 model not found 这类错误基本就消失了。

注意：Key 只显示一次，复制后存到安全的地方。不要把它写进会提交到 Git 的明文配置文件里，建议用环境变量注入。

3. 可复制的 gateway 配置片段与端口检查命令

这一节是全文最核心的操作部分。openclaw 的 gateway 配置通常放在项目根目录或用户配置目录下，文件名可能是openclaw.config.json、gateway.toml或settings.json，具体取决于你的安装方式。下面给出一份可直接复制的 JSON 配置片段，路径按你实际安装位置调整。

{ "gateway": { "host": "127.0.0.1", "port": 18789, "endpoint": "https://taotoken.net/api", "apiKey": "${TAOTOKEN_API_KEY}", "model": "claude-sonnet-4-5", "timeout": 60000, "retry": { "enabled": true, "maxAttempts": 3, "backoffMs": 500 } }, "logging": { "level": "info", "file": "./logs/gateway.log" } }

如果你用的是 TOML 格式，等价写法如下：

[gateway] host = "127.0.0.1" port = 18789 endpoint = "https://taotoken.net/api" api_key = "${TAOTOKEN_API_KEY}" model = "claude-sonnet-4-5" timeout = 60000 [gateway.retry] enabled = true max_attempts = 3 backoff_ms = 500

配置里几个关键点：endpoint指向 TaoToken 的 API 根地址，不要带/v1之类的后缀，openclaw 会自己拼接；apiKey用环境变量引用，避免明文；port默认 18789，如果你机器上这个端口被占，改成 18790 或别的空闲端口。

端口检查命令分平台。Linux/macOS 下：

lsof -i :18789

如果输出里有进程占用，记下 PID，用kill -9 <PID>结束，或者直接换端口。Windows PowerShell 下：

netstat -ano | findstr :18789

拿到 PID 后用taskkill /PID <PID> /F结束。另一个通用方法是ss -tlnp | grep 18789，在 Linux 上比 lsof 更快。

启动 gateway 的命令：

openclaw gateway --port 18789

如果你想让它后台跑，加--daemon或配合nohup：

nohup openclaw gateway --port 18789 > ./logs/gateway.out 2>&1 &

restart 命令：

openclaw gateway restart

restart 的本质是先停旧进程再起新进程。如果旧进程没被正确杀掉，新进程会因为端口占用起不来，这就是很多人 restart 卡住的根因。所以 restart 之前，建议先手动确认端口空闲。

提示：把TAOTOKEN_API_KEY写进 shell 的 profile 文件，比如~/.zshrc或~/.bashrc，然后source一下，这样 openclaw 启动时能直接读到。

4. 验证请求与成功结果：确认 endpoint 真的切到了 TaoToken

配置写完、gateway 启动后，别急着跑业务，先做一次最小验证。openclaw 一般提供一个 health 或 ping 接口，你可以用 curl 直接打：

curl -s http://127.0.0.1:18789/health

预期返回类似{"status":"ok","endpoint":"https://taotoken.net/api"}。如果 endpoint 字段显示的还是默认地址，说明配置没生效，检查配置文件路径和加载顺序。

接着验证模型调用。用 curl 走 gateway 转发：

curl -s http://127.0.0.1:18789/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-5", "messages": [{"role": "user", "content": "ping"}] }'

如果返回里有正常的choices字段和内容，说明 gateway 已经把请求转发到 TaoToken 并拿到了响应。这一步成功，意味着三件套（Base URL、Key、Model ID）全部对齐。

你也可以直接在模型对话页面 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 里发一条消息，确认 Key 本身可用。如果那边正常、gateway 这边报错，问题就在 openclaw 配置或端口转发上，不在 Key。

验证通过后，再看 gateway 日志：

tail -f ./logs/gateway.log

正常日志里会有请求进入、转发、响应返回的时间戳。如果看到connection refused或timeout，说明 gateway 到 TaoToken 的网络链路有问题，检查本机是否能访问https://taotoken.net/api。

实测下来，最容易出问题的是 endpoint 末尾多了斜杠或者少了/api。正确写法是https://taotoken.net/api，不要写成https://taotoken.net/api/或https://taotoken.net。openclaw 拼接路径时对末尾斜杠敏感，多一个斜杠可能导致 404。

5. 本篇常见错误排查：401、local proxy failed、reading choices、OAuth

这一节把 openclaw gateway 启动和 restart 过程中最常见的几类报错列出来，对照处理。

401 Unauthorized：Key 没读到或写错。检查环境变量TAOTOKEN_API_KEY是否在当前 shell 里生效，echo $TAOTOKEN_API_KEY看有没有值。如果配置文件里直接写了 Key，确认没有多余空格或换行。还有一种情况是 Key 被撤销了，去 api-keys 页面重新生成一个。

local proxy failed / connection refused：gateway 进程没起来，或者端口不对。先lsof -i :18789确认有没有进程监听。如果没有，说明启动失败，看日志里的报错。常见原因是配置文件语法错误，JSON 多了逗号或 TOML 少了引号，用python -m json.tool openclaw.config.json校验一下。

reading choices 报错 / choices 字段为空：请求发出去了，但返回结构不对。多半是 Model ID 写错，或者 endpoint 指向了不兼容的地址。确认model字段和 TaoToken 文档里的一致，endpoint 是https://taotoken.net/api。如果返回体里有error字段，把完整错误贴出来对照文档。

OAuth 相关报错：如果你之前配过 OAuth 流程，openclaw 可能还在走旧的鉴权路径。检查配置里有没有残留的oauth字段，删掉，改用apiKey。Codex 的auth.json如果存在，确认里面的base_url和api_key也指向 TaoToken，三件套保持一致。

restart 后端口仍被占：旧进程没杀干净。openclaw gateway restart有时只发信号不等待，旧进程还在释放端口。手动kill -9旧 PID，等两秒再启动。或者写个脚本，restart 前先lsof -ti :18789 | xargs kill -9。

Cline MCP 配置不生效：如果你在 Cline 里通过 MCP 接 openclaw，确认 MCP 配置里的 command 和 args 指向正确的 openclaw 可执行文件，环境变量也传进去了。MCP 启动的子进程不一定继承你的 shell 环境，Key 要在 MCP 配置里显式传。

注意：排查时优先看日志，日志里通常有完整的错误堆栈。不要凭猜测改配置，改一处验证一处。

6. 把 endpoint 固定到 TaoToken：长期使用的配置建议

gateway 跑通之后，建议把配置固化下来，避免每次重启都手动改。把TAOTOKEN_API_KEY写进~/.zshrc或~/.bashrc：

export TAOTOKEN_API_KEY="你的Key"

然后source ~/.zshrc。这样 openclaw 在任何目录启动都能读到。

如果你用 systemd 管理 gateway，写一个 service 文件：

[Unit] Description=openclaw gateway After=network.target [Service] Environment=TAOTOKEN_API_KEY=你的Key ExecStart=/usr/local/bin/openclaw gateway --port 18789 Restart=on-failure RestartSec=3 [Install] WantedBy=multi-user.target

这样systemctl restart openclaw-gateway就能可靠重启，端口占用问题也由 systemd 管理。

长期跑编码或 Agent 任务的话，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 里有各场景的配置示例，遇到新工具接入可以对照。

最后提醒一句：endpoint 改到 TaoToken 后，所有走 gateway 的请求都会经过统一通道，Key 的管理和模型切换都在控制台完成。如果哪天请求变慢，先看模型对话页面确认通道本身是否正常，再排查 gateway 本地转发。端口 18789 被占是最高频的问题，记住lsof -i :18789这条命令，能省掉大半排查时间。