Token 与权限常见错误（401 / 403 / invalid token）

先判断错误类型

• 401 Unauthorized：通常是 Key 错误或过期
• 403 Forbidden：通常是账号无权限调用该模型
• invalid token：格式不对或多了空格/换行

标准排查顺序（务必按顺序）

1. 确认 Key 类型是否正确
   • 必须是模型平台 API Key
   • 不要误填云账号 AK/SK
2. 确认模型名
   • 与平台控制台一致
3. 确认当前运行环境确实读取了最新 .env
4. 重启服务并再次测试

快速自检命令

openclaw status
openclaw health
openclaw logs --tail 120

常见坑

• 把测试环境 Key 发到了生产
• 修改 .env 后忘记重启服务
• Key 前后有空格
• 模型名大小写写错

修复后验收

• 连续 3 次请求成功
• 日志中不再出现 401/403
• 机器人通道消息可正常往返