FAQ
Token 与权限常见错误（401 / 403 / invalid token）
按顺序定位：凭证类型、模型权限、环境变量加载
继续查看
安装、排障和深入阅读最常用的入口都在这里。
先判断错误类型
401 Unauthorized：通常是 Key 错误或过期403 Forbidden：通常是账号无权限调用该模型invalid token：格式不对或多了空格/换行
标准排查顺序（务必按顺序）
- 确认 Key 类型是否正确
- 必须是模型平台 API Key
- 不要误填云账号 AK/SK
- 确认模型名
- 与平台控制台一致
- 确认当前运行环境确实读取了最新
.env - 重启服务并再次测试
快速自检命令
openclaw status
openclaw health
openclaw logs --tail 120
常见坑
- 把测试环境 Key 发到了生产
- 修改
.env后忘记重启服务 - Key 前后有空格
- 模型名大小写写错
修复后验收
- 连续 3 次请求成功
- 日志中不再出现 401/403
- 机器人通道消息可正常往返