常见故障边界
OpenClaw Gateway 问题可能来自本地服务、端口占用、聊天平台通道或模型网关。UUcode 负责模型 API 和 Token 中转，便于把模型层与本地服务层分开排查。
OpenClaw Gateway Runbook
OpenClaw Gateway 启动失败时，用 UUcode Runbook 快速定位
UUcode 文档建议 OpenClaw GateWay 启动失败时先尝试 openclaw gateway restart，再检查端口占用和配置脚本。将模型入口统一到 UUcode 后，也能更快确认 API Key 与请求状态。
- Gateway restart
- 端口占用检查
- openclaw.json
配置文件也要同步检查
OpenClaw 文档说明常见路径包括 Windows 的 .openclaw\openclaw.json、macOS 的 ~/.openclaw/openclaw.json。确认 baseUrl 为 https://token.uucode.top，apiKey 已正确填写。
适合团队沉淀 SOP
把 restart、端口检查、配置备份、模型默认值和 UUcode 控制台请求记录写成 Runbook，可以降低 Agent 网关运维成本。
01
重启 Gateway
先执行 openclaw gateway restart，观察是否恢复。
02
检查端口与配置
若仍失败，检查端口占用，并打开 openclaw.json 核对 baseUrl、apiKey、模型 ID 与 provider 设置。
03
对照 UUcode 请求记录
如果 Gateway 已启动但模型无响应，在 UUcode 控制台检查是否有请求和鉴权错误。
常见问题
OpenClaw 报 401 应该看哪里？
先检查 apiKey 是否正确、baseUrl 是否为文档要求的网关地址，以及 Key 是否仍有效。
修改 openclaw.json 前要备份吗？
建议备份。UUcode 文档中的提示词也强调先熟悉并备份配置，再只修改模型相关项。