401错误表明身份验证被拒，主因是api密钥、base url和服务权限三者不匹配或设备未显式授权。需逐一验证密钥格式与url精确性、完成设备双向信任授权、确认模型开通及配额可用、刷新本地token凭证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QoderWake过程中收到报错代码401，这表明系统拒绝当前请求的身份验证，核心问题并非Token本身已“失效”，而是API密钥、Base URL、服务权限三者之间存在不匹配，或设备未完成显式授权。以下是针对该问题的多种解决路径：
一、验证API密钥与Base URL的精确匹配
QoderWake要求API密钥必须为专用类型（如sk-qw-xxxxx），且Base URL必须严格对应所选服务的OpenAI兼容接口地址；二者大小写、协议、路径层级及末尾斜杠均需完全一致，任何偏差都将触发401响应。
1、登录QoderWake管理控制台，进入【API管理】→【API密钥】页面，确认已启用具备qoderwake权限的密钥（格式为sk-qw-xxxxxxxx）。
2、在【服务配置】中选择目标后端模型（如qw-llm-v2），点击【接口详情】，从【OpenAI兼容地址】区块复制完整Base URL（形如https://api.qoder.com/v1），注意末尾不可包含斜杠。
3、检查客户端配置文件（如config.yaml或环境变量）中填写的API_KEY与BASE_URL字段，逐字符比对控制台值，特别排查全角空格、中文标点、大小写混用等隐性错误。
二、完成设备级双向信任授权
QoderWake采用设备身份链验证机制，401错误常源于ClawdBot设备处于待审批状态，而非密钥无效；系统在未获控制台显式批准前，会主动拒绝所有请求以保障沙盒安全边界。
1、在终端执行clawdbot devices list命令，确认输出中Status列为pending且Device ID为标准UUID格式（32位十六进制+4位分隔符）。
2、访问QoderWake控制台【设备管理】页，筛选状态为“待审核”的设备条目，核对Device ID与终端输出是否一致。
3、点击该设备右侧的Approve按钮完成授权；授权成功后约25–35秒内，终端再次执行clawdbot devices list将显示Status更新为approved。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、校验模型开通状态与额度可用性
即使密钥与地址正确，若目标模型未在控制台手动开通，或账户触发配额冻结机制，系统仍会在权限校验前置阶段返回401，而非404或429，因其判定为“无权访问该资源”而非“资源不存在”或“请求过频”。
1、进入控制台【模型服务】页面，查找所配置模型（如qw-code-pro-2026）的状态是否为已开通；若显示“未开通”，点击右侧开关启用。
2、导航至【配额中心】→【当前周期使用量】，确认剩余调用次数 > 0且无“Quota frozen”或“Ratelimit enforced”提示。
3、若额度耗尽，临时切换至同租户下其他已开通模型（如从qw-code-pro-2026切换至qw-basic-2026），执行相同请求验证是否仍报401，以此排除配额因素。
四、刷新并轮换运行时Token凭证
QoderWake客户端本地缓存的短期Token可能因超时、被主动吊销或上下文污染而失效；此时需强制触发Token刷新流程，获取新签发的有效凭证，并同步更新至内存与持久化存储。
1、在QoderWake客户端界面，点击右上角用户头像 → 进入【安全设置】→【凭证管理】。
2、点击刷新访问令牌按钮，系统将自动调用/auth/token/refresh端点，携带当前refresh_token发起续期请求。
3、刷新成功后，界面显示新Token有效期（如expires_in: 3600s），同时自动覆盖localStorage中旧token及内存中的Bearer Header值。
4、重启客户端进程，确保所有Connector实例加载新Token上下文；若仍失败，可手动清除~/.qoderwake/cache/auth/目录下全部文件后重试。
