http响应码40001错误表明oauth2中access_token获取失败，需依次检查授权码有效性、客户端凭证匹配性及token响应解析逻辑。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy接入OAuth2流程中收到HTTP响应码40001错误，该错误明确指向凭证无效，常见于access_token获取阶段——即授权码（code）成功换取token时，服务端拒绝签发或返回空/伪造token。以下是解决此问题的具体步骤：
一、验证授权码交换请求的完整性与时效性
WorkBuddy必须使用原始授权码（code）向第三方认证服务器发起POST请求，且该code仅能使用一次、有效期通常为10分钟；若请求构造缺失必要参数、被代理截断、或重放过期code，将直接触发40001。
1、在WorkBuddy「技能管理」→目标技能【详情】页中，点击「查看OAuth调试日志」，定位最近一次token交换请求的完整cURL命令。
2、确认请求URL中包含code、client_id、client_secret、redirect_uri、grant_type=authorization_code五项参数，缺一不可。
3、检查日志中code值是否与上一步OAuth登录页跳转后回调URL中的code完全一致，特别注意URL编码字符（如%2F）是否被意外解码或截断。
4、若日志显示“code expired”或“invalid code”，说明授权流程中断超时，请关闭所有相关页面后重新触发完整授权流程。
二、校验客户端凭证与Token端点匹配性
40001错误常由client_id与client_secret不匹配当前token端点所属应用导致。飞书、企业微信、钉钉等平台对不同环境（开发/生产）、不同应用类型（自建/代开发）分配独立的凭证体系，混用将被无条件拒绝。
1、登录对应开放平台后台，在「应用凭证」或「密钥管理」模块中，确认当前使用的client_id和client_secret属于同一应用实例，且状态为“已启用”。
2、核对token端点URL是否与平台文档严格一致：例如飞书为https://open.feishu.cn/open-apis/authen/v1/access_token，企业微信为https://qyapi.weixin.qq.com/cgi-bin/gettoken，不可将测试环境URL用于生产配置，亦不可将网页应用密钥用于桌面客户端场景。
3、在WorkBuddy「OAuth凭证管理」中，点击「刷新客户端密钥」按钮，强制同步最新凭证至本地缓存。
4、若使用私有部署认证服务（如Keycloak），需确认其issuer声明、jwks_uri及token端点路径已在WorkBuddy配置中显式指定，未依赖自动发现。
三、修正AccessToken响应解析逻辑与存储机制
WorkBuddy在接收token响应后需正确解析JSON体中的access_token字段，并剔除非法字符（如BOM头、不可见Unicode空格）；若解析失败或误取其他字段（如id_token），后续API调用将携带空值或错误值，引发40001。
1、在调试日志中搜索"token response body"，提取原始响应内容，确认其为标准JSON格式且含access_token、expires_in、refresh_token三项必有字段。
2、检查响应Content-Type是否为application/json；若为text/html或text/plain，说明请求被反向代理重定向或认证服务器返回了HTML错误页，此时需检查网络中间件是否劫持了HTTPS响应。
3、打开WorkBuddy数据目录下的oauth_tokens/子目录，用文本编辑器打开最新生成的token文件，确认其中access_token值为非空字符串，长度不少于32位，且不含换行符或引号包裹。
4、若token文件内容为空或为null，进入「Claw 设置」→「技能管理」→【重置OAuth状态】，清除所有临时凭证并强制重建流程。
