先分清启动问题和鉴权问题
Gateway 启动失败通常和本地服务、端口或配置脚本有关；401 Unauthorized 则更常见于 apiKey 或 baseURL 不正确。排障时应分别检查。
OpenClaw Gateway Troubleshooting
排查 OpenClaw Gateway 启动失败并确认 UUcode 配置
doc.uucode.top 疑难问题指南提到 OpenClaw GateWay 启动失败可尝试 openclaw gateway restart，并检查端口占用或重新运行配置脚本。本页把这些排障词与 UUcode 网关配置连接。
- 端口占用检查
- gateway restart
- apiKey/baseUrl 校验
UUcode 配置项不可混淆
在 openclaw.json 中，provider 的 baseUrl、apiKey 和模型别名必须与 UUcode 控制台和文档一致，否则 Agent 能启动但模型调用会失败。
让团队有统一排障流程
记录 openclaw gateway restart、端口检查、重新 onboard、查看 UUcode 请求记录，可以减少重复询问和本地环境差异。
01
重启 Gateway
先执行 openclaw gateway restart，观察是否只是进程状态异常。
02
检查端口与配置
确认所需端口未被占用，并检查 openclaw.json 中 baseUrl、apiKey、models 配置。
03
回到 UUcode 记录
如果请求已经到达 UUcode，查看控制台调用记录；如果没有到达，继续排查本地 Gateway。
常见问题
OpenClaw 401 一定是 UUcode 故障吗？
不一定。多数情况下需要先检查 apiKey 是否正确、baseURL 是否与教程一致，以及 Token 是否仍有效。
端口占用如何影响模型调用？
如果本地 Gateway 无法启动，消息或 Agent 请求可能根本不会转发到 UUcode，因此控制台也看不到调用记录。