WorkBuddy高频问题Q&A：登录、授权、执行报错一网打尽【汇总】

WorkBuddy登录失败、授权白名单不生效、执行任务时突然报错“too many requests”或“该机器人去火星了”……很多用户第一反应是“网络卡了”或者“密码输错了”。但说实话，这些场景95%以上都不是网络或密码的问题。真正的根因，往往是权限链断裂、凭证未刷新，或者本地缓存污染——简单说，就是认证流程在某个环节中途断了。

先说一个核心判断：要彻底解决这类问题，不能靠“重启试试”，而需要按一条清晰的排查链路，从源头到终点逐一确认。下面就把这条链路拆开来说。

确认账号是否在白名单内

公开测试阶段，白名单准入机制仍然是强制执行的。即使你没收到邀请、也没有收到官方通知，也能扫码成功——但你大概率会卡在OAuth2重定向页，页面一片空白，没有任何报错信息，只有图标在不停转圈。

打开浏览器，访问

，如果页面底部显示“当前仅限白名单用户访问”，那基本就可以确认：你不在受邀名单里。

检查一下是否收到腾讯最新发送的邀请邮件，或企微、微信端的服务通知。关键词必须是“WorkBuddy 测试资格已开通”——转发、截图、代注册都不算数，只有原始邀请通道才有效。

更关键的是，不要反复点击登录按钮。连续失败3次以上，可能触发IP级限流，然后你就会看到“too many requests”这个错误，并且持续5分钟。所以，哪怕卡住了，也先冷静一下。

检查IAM子账号模板级权限

企业腾讯云账号下，子账号登录失败的情况特别常见，90%都卡在IAM鉴权这个环节。简单说就是：子账号有登录权限，但没被分配包含WorkBuddy策略的模板。

排查方法很简单，两种方式任选其一：

第一种：登录腾讯云企业管理控制台，进入「用户管理」，找到你的子账号，查看「分配的角色」。必须存在来自「企业管理服务」的角色（比如“模板管理员”），如果只有“子账户管理员”角色，是过不了鉴权的。

第二种：点击角色名进入详情页，确认所绑定的IAM模板处于「启用」状态。然后检查策略JSON里是否包含对

域名API的调用许可。如果缺少，手动附加策略，或者直接联系主账号管理员来更新。

QQ机器人凭证过期处理

QQ频道开放平台每30天会轮换一次Token。旧凭证失效后，WorkBuddy无法完成IDENTIFY流程，日志里会高频出现4006或4009这样的错误码。

处理流程分三步：

第一步：登录QQ频道开放平台开发者中心，打开对应机器人设置页，点击「重新生成 Token」。

第二步：复制新的AppID、Token、AppSecret。

——这个细节非常容易忽略，但往往就是它导致配置失败。然后粘贴进WorkBuddy的config.yaml或环境变量配置项。

第三步：保存后必须重启WorkBuddy进程，否则新凭证不会加载。启动时追加参数

，强制跳过resume流程，避免session过期卡死。

网页端扫码无响应修复

扫码登录这件事，依赖OAuth2重定向加上IndexedDB临时会话存储。两个环节中任何一个出问题，都会导致二维码加载空白、点击无反应，或者跳回首页。

先确认地址栏是https://workbuddy.qq.com，并且显示绿色锁标。如果提示“不安全”，说明HTTPS证书异常，直接退出重试。

按F12打开开发者工具，切换到Application选项卡，点击Clear storage，勾选Cookies、Cache、IndexedDB，然后点击Clear site data。这一步能清理掉绝大多数临时问题。

如果还不行，就要去本地数据目录手动清理了：Windows用户到 %APPDATA%TencentWorkBuddycache，macOS用户到 ~/Library/Application Support/WorkBuddy/cache/，直接删除整个cache文件夹。再重试。

执行任务报“too many requests”

这个报错不是网络问题，而是服务端主动触发的请求频率熔断机制。WorkBuddy内部设定了硬性窗口限流阈值。有意思的是，高频短指令比单条长指令更容易触发这个限制。

解决方案有三个要点：

第一，立即暂停所有输入，等待60秒后再操作。期间不要刷新页面，也不要重复点击“发送”。

第二，把多个独立动作合并成一条自然语言指令。举个例子：与其分三步说“新建文件夹”“重命名”“移动图片”，不如一次性写成“在桌面新建名为‘WorkBuddy截图’的文件夹，并把桌面上所有PNG格式图片移入其中”。

第三，如果已启用远程控制，登录企业微信检查是否在多端重复发送了相同指令——同一指令在PC端和手机端各发一次，就等于超频了。

执行任务报“该机器人去火星了”

这个提示特别生动，但它背后的真实含义是：OpenClaw沙箱通信失败。本质上是远程控制链路中断，95%的情况是由QQ/企微机器人配置异常或白名单缺失导致的。

修复路径同样清晰：

打开WorkBuddy客户端右上角个人中心，进入Claw设置，核对所选通讯工具的AppID与AppSecret是否与OpenClaw后台完全一致。要特别注意大小写以及末尾空格。

然后登录OpenClaw控制台，进入沙箱管理页面，确认当前测试QQ号已添加至白名单列表。如果没加，手动录入并保存。

最后一步，在服务器终端执行这条命令：

。它会自动校验并修复基础配置项，包括证书路径、端口占用、沙箱心跳超时等问题。