问题极可能源于本地Token失效、网络策略拦截或云账号授权链路中断。需依次验证腾讯云账号绑定与实名状态、清除本地鉴权Token与缓存凭证、检查企业防火墙/代理对腾讯云API的放行情况、校验Claw通道与腾讯云API网关连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功登录WorkBuddy客户端，但界面持续显示“云服务未连接”、“Claw通道离线”或执行AI指令时提示“腾讯云鉴权失败”，则问题极可能源于本地Token失效、网络策略拦截或云账号授权链路中断。以下是针对性排查与修复步骤：
一、验证腾讯云账号绑定状态与实名有效性
WorkBuddy依赖腾讯云OAuth2.0体系完成身份核验与权限协商，若账号未完成实名认证、被风控暂停，或绑定关系异常中断，将直接阻断后台通信。需确认当前登录账号在腾讯云平台处于可调用API的健康状态。
1、点击WorkBuddy左下角个人头像，进入【账户设置】→【云服务绑定】。
2、查看页面顶部是否显示“腾讯云账号：XXX（脱敏）已激活”；若显示“未绑定”或“Token已过期”，点击【重新验证腾讯云身份】。
3、跳转至腾讯云OAuth授权页后，确认当前账号已完成实名认证（可在cloud.tencent.com右上角头像菜单中核验）。
4、勾选“允许WorkBuddy调用云API、管理多云资源、读取轻量应用服务器实例状态”并提交。
5、完成短信或微信二次验证后，等待页面刷新并出现绿色对勾图标。
二、强制清除本地鉴权Token与缓存凭证
WorkBuddy将Access Token、Scope声明及OAuth Session持久化存储于本地磁盘与浏览器存储中。当后台权限策略更新而本地Token未同步刷新时，客户端将持续使用旧凭证发起无效请求，导致连接拒绝。
1、完全退出WorkBuddy进程：右键系统托盘图标选择“退出”，或在任务管理器（Windows）/活动监视器（macOS）中结束所有WorkBuddy.exe或WorkBuddy Helper进程。
2、Windows用户前往路径：%APPDATA%\Tencent\WorkBuddy\token\，删除access_token.json与scope_cache.json两个文件。
3、macOS用户前往路径：~/Library/Application Support/WorkBuddy/token/，执行相同删除操作。
4、若使用网页版WorkBuddy，打开Chrome或Edge浏览器，按F12进入开发者工具，切换至Application选项卡，在Storage栏目下依次清除Cookies、Cache、IndexedDB中workbuddy.qq.com域名下的全部条目。
5、关闭所有浏览器窗口，重新打开新窗口访问https://workbuddy.qq.com，扫码登录并等待自动触发Token重拉取。
启用该技能，可以在WorkBuddy对话页的右边栏添加一个日历，提供月历视图、日程增删改查、分类标签（开庭/会议/截止日期/个人/研究/其他），支持从对话中提取事件并自动同步到日历。当用户提到"日历""日程""打开日历""添加日程""我的日程""calendar""安排"或询问已记录的日程信息时使用。
三、检查企业防火墙与代理策略对腾讯云API的放行情况
部分企业网络环境部署了严格出站策略，会拦截对tencentcloudapi.com、cloud.tencent.com等域名的HTTPS请求，或强制代理导致OAuth回调地址无法正确响应，造成鉴权流程中断。
1、在命令行中执行：curl -v https://cloud.tencent.com/api/v2/auth/health，观察是否返回HTTP 200及JSON格式健康响应。
2、若超时或返回SSL handshake failed，说明网络层存在拦截；尝试临时关闭公司代理软件或切换至手机热点网络复测。
3、Windows用户检查组策略：运行gpedit.msc → 计算机配置 → 管理模板 → 网络 → 网络连接 → Windows防火墙 → 域配置文件，确认“Windows防火墙：定义入站连接”未误禁用WorkBuddy进程。
4、macOS用户检查“系统设置 → 网络 → 防火墙 → 防火墙选项”，确认WorkBuddy.app已在允许列表中且勾选“启用防火墙”。
四、校验Claw通道与腾讯云API网关连通性
Claw作为WorkBuddy与腾讯云后端通信的核心通道，其本地服务进程需与腾讯云API网关（claw-api.tencentcloudapi.com）建立稳定TLS连接。若通道心跳丢失、证书校验失败或DNS解析异常，将导致鉴权握手失败。
1、启动WorkBuddy主界面，点击右上角头像 → 【Claw设置】→【Integration Status】。
2、在“云服务连通性检测”模块中点击【运行诊断】，重点观察三项指标：DNS解析、HTTPS握手、OAuth2 Token交换。
3、若诊断结果显示“claw-api.tencentcloudapi.com解析失败”，手动执行nslookup claw-api.tencentcloudapi.com，确认返回IP是否属于腾讯云CVM段（如100.100.*.*或182.254.*.*）。
4、若诊断提示“证书验证失败”，检查系统时间是否准确（误差超过5分钟将导致TLS握手拒绝），运行date命令比对NTP标准时间。
5、点击诊断结果旁的【立即修复】按钮，系统将自动重试DNS刷新、证书信任链重建及Token强制续期。
