外观

微信扫码加入WorkBuddy交流群
外观

按报错代码或报错信息查找解决方案。本页已对齐腾讯云官方 WorkBuddy 常见问题文档(最近更新 2026-10-29)。看不清错误原文时,先在客户端左下角头像 → 帮助与反馈 → 意见反馈提交日志(勾选「上传日志」),再对照下表排查。
不要一上来清缓存、重装或连续点重试。先判断问题属于"服务、网络、账号、模型、任务、文件还是集成",再做一项可逆操作验证。
腾讯云 FAQ 对 WorkBuddy 明确列出的错误码分为模型状态、网络环境和频率限制三组。错误码只是定位入口,不等于已经确认根因。
| 错误码 | 官方归类 | 优先处理 | 升级条件 |
|---|---|---|---|
| 14003 / 11133 / 1001 | 模型侧状态 | 切换一个可用模型,缩短任务后重试一次 | 多个模型持续失败,提交时间、模型与完整报错 |
| 3002 / 3003 | 网络环境 | 换网络验证;公司网络交由 IT 核对代理/防火墙 | 多网络、多设备均失败 |
| 400 / 401 / 504 | 网络环境 | 按网络问题排查;记录报错出现在哪个页面/任务 | 标准网络仍失败并可稳定复现 |
| 6003 | 请求频率受限 | 暂停连续请求,临时切换模型,稍后再试 | 低频操作仍持续出现 |
现象:客户端与网页版均无法访问,登录界面持续加载失败,提示"503 Service Unavailable"或"服务不可用"。
原因:服务、网关或上游暂不可用,需结合影响范围与官方状态确认。
解决:
现象:登录失败、任务中断,提示"502"或"500"或"InternalError"。
原因:后端网关或服务内部错误,通常为瞬时故障。
解决:
现象:客户端弹出"Local Agent Error: too many requests",或 API 返回 HTTP 429 + FailedOperation.RequestLimitExceeded。
原因:单位时间内请求过多。可能是 WorkBuddy 的 6003 频率限制,也可能是第三方模型/API 的 429。常见于自动化任务、Skill 链式调用、第三方机器人接入等场景。
解决:
解决:确认系统已设置默认浏览器;关闭拦截登录跳转的扩展后,用 Chrome 或 Edge 标准窗口重试。不要用无痕窗口作为长期解决方案;企业网络用户由 IT 核对代理、OAuth 回跳和安全策略。
解决:这是网络连接超时。先用手机热点做隔离测试;如果只在企业网络失败,由 IT 核对代理、防火墙、DNS、TLS 检查和 copilot.tencent.com:443 的连通性。不要公开 Request ID、Trace ID 或内部网络截图。
现象:登录后页面空白或不停跳转,浏览器地址栏出现 303 重定向。
原因:登录态丢失或浏览器拦截了第三方 Cookie。
解决:
现象:客户端出现 401 报错。
原因:WorkBuddy 官方 FAQ 将客户端 401 归入网络环境问题,不是腾讯云 SecretId/SecretKey 错误。只有报错明确来自你配置的第三方 API、MCP 或连接器时,才检查该服务的 API Key、Token、URL 和权限。
解决:
现象:登录成功但侧边栏没有企业知识库、Skill、智能体。
原因:当前登录的是个人身份而非企业身份,或成员未被分配席位。
解决:
原因:手机信号弱、被拦截为垃圾短信、账号绑定状态异常。
解决:
解决:先重启电脑,退出仍在访问旧版应用文件的进程,再从官方入口重新下载并拖入【应用程序】。覆盖安装前确认重要工作目录已有备份;不要使用来历不明的脚本绕过签名校验。
通常应用重装与用户工作目录分离,但卸载工具可能同时清理偏好设置或应用数据。操作前备份工作空间、重要产物和必要配置;只使用官方安装包,不手工删除不清楚用途的数据目录。
解决:先确认当前用户对 WorkBuddy 自身数据目录和选定工作空间具有读写权限。仅调整具体目录的权限,不修改整个 /Users 目录,也不要使用宽泛的递归授权。仍失败时记录实际报错和目录权限,随日志提交反馈。
现象:双击安装包提示"无法打开'WorkBuddy',因为无法验证开发者"。
解决:前往"系统设置 → 隐私与安全性",滚动到底部点击"仍要打开"。不要用不明脚本移除系统安全属性。
现象:双击安装包无反应,或提示"被组策略阻止"。
解决:不要绕过组策略;由 IT 校验官方安装包,并按企业制度加入应用与官方网络地址白名单。
原因:WorkBuddy 常被安全软件误拦截。
解决:临时退出火绒、360 安全卫士、电脑管家或 Windows 安全中心后重试即可;企业设备由 IT 按制度加入白名单,不建议长期关闭安全软件。
现象:Windows 11 ARM64 架构设备安装失败。
原因:当前版本暂不支持 ARM64 架构的 Windows 11。
解决:改用受支持的设备环境,或等待后续版本支持。
现象:客户端无法写入用户数据目录,登录或初始化失败。
解决:确认当前用户对应用数据目录具有读写权限(macOS 为 ~/Library/Application Support/CodeBuddyExtension,Windows 为 %APPDATA%\CodeBuddyExtension;可用 whoami 确认当前用户名)。仅调整该目录权限,不要修改整个用户目录:
sudo chown -R $(whoami) ~/Library/Application\ Support/CodeBuddyExtensiontakeown /F "$env:APPDATA\CodeBuddyExtension" /R /D Y 与 icacls "$env:APPDATA\CodeBuddyExtension" /grant "$($user):(OI)(CI)F" /T(其中 $user 为当前用户名)完成后退出 WorkBuddy 并重新打开、重新登录。仍失败时记录实际报错随日志提交反馈。
现象:打开客户端只有白屏,无任何 UI。
原因:本地缓存或渲染异常,但官方 FAQ 未给出删除整个缓存目录的通用步骤。
解决:
解决:
原因:WorkBuddy 更新或重装时,安装目录会清空并重新写入文件。
解决:
不要在安装目录保存唯一副本。
解决:Windows 默认常见于 C:/Users/用户名/WorkBuddy;macOS 常见于 /Users/用户名/WorkBuddy。通过打开文件夹选择原日期目录或自定义目录,并把重要产物另存。不要反复新建同名目录覆盖原路径。
现象:仅公司网络失败,手机热点正常。
解决:
本地工作目录、客户端配置与会话是否同步取决于当前功能和执行环境,不要把一台设备的本地路径视为另一台设备自动可用。跨设备前先在目标设备检查任务记录、云端文件和已授权连接器;重要产物另行归档。
桌面客户端文档按 Windows 与 macOS 本地安装说明。若需要服务器、容器或无人值守部署,先查当前官方产品页和企业支持范围,不要直接把桌面安装包用于生产服务器。官方 FAQ 口径:服务器端能力仍在完善中,正式支持以官方后续版本为准。
原因:助理专门适用于远程任务,默认文件夹为固定设计,不支持修改。
解决:先确认目标平台、机器人类型与群聊权限要求,再按平台指引把机器人拉入目标群并验证消息往返。
微信小程序支持范围以当前输入栏显示为准,可用入口可能包括语音、图片和文件;其他远程消息平台不一定具备相同能力。没有相应按钮时,不应假设该平台支持上传。
现象:任务一直执行没有结果。
解决:
解决:
解决:先排除网络;减少复合任务和超大文件;只启用必要 Skill/连接器;分批执行。
模型推理通常由云端完成,本地仍会消耗内存、磁盘、网络和任务所需的本地工具资源。处理大文件、音视频、代码构建或多个任务时,CPU 和磁盘占用也可能明显增加;以系统监视器中的实际进程数据为准。
并行任务会竞争网络、内存、磁盘和本地工具;多个任务操作同一目录或文件时还可能互相覆盖。大文件和高资源任务控制并发,涉及同一产物时串行执行,并使用独立工作空间。
原因:移动端无法自动获得电脑任意路径。
解决:在电脑侧把文件放入指定工作空间,并在任务中写清路径。
现象:内置模型正常,自定义模型失败。
解决:
解决:
现象:任务执行完成但工作目录没有文件。
解决:
现象:上传 .pdf / .docx 时提示"索引失败"或一直转圈。
原因:文件格式、大小或编码不符合限制。
解决:
解决:调整检索参数:
用三类问题测试:已知答案、资料冲突、无法回答的问题。要求回答附来源;未命中时明确说"资料中未找到",不要让模型用常识补齐企业事实。
解决:切换支持该文件类型的模型;明确分步读取要求;安装并验证所需 Skill。
进入【Skills】确认对应 Skill 已安装并启用。部分 Skill 会按任务自动选择,不一定需要手动点名;仍未调用时,新建一个干净任务,明确输入、动作和期望工具,并用脱敏样本验证。更新或重装前记录 Skill 来源和版本。
先按连接器通用顺序检查服务地址、认证、权限和网络,再单独验证 MCP 是否能列出工具。第三方服务限制或授权范围变化时,以其当前官方说明为准;不要为绕过限制把访问令牌写入聊天或公开配置。
打开 WorkBuddy,点击顶部帮助 > 打开日志文件夹,找到对应的日志(.zip)包,macOS 与 Windows 操作相同。按故障发生时间定位对应日志。提交前按企业制度确认授权并检查敏感信息;不要在公开群聊发送完整日志。日志仅用于排查问题,可能包含对话记录、设备信息等数据,详情查阅官方隐私保护声明。
在新建任务的工作目录入口选择文件夹。任务是一次独立对话和执行记录,工作空间是任务可访问的文件目录;默认任务可能创建独立目录,指定工作空间适合围绕已有项目文件工作。名称和路径是否可修改以当前客户端界面为准,变更前先备份并确认自动化是否依赖旧路径。
解决:明确要求 Word/Excel/PDF/Markdown 及文件名;先生成一份小样并打开验证。
解决:立即停止任务;查看目标目录、回收站、任务产物和变更;保留脚本与截图。先恢复副本,再查日志。
原因:默认权限正在保护外部路径。
解决:优先把任务副本放入工作空间;确需外部写入时逐项确认,不要为了省步骤长期启用完全访问。
原因:桌面客户端离线、时间规则配置错误、工作目录被移动。
解决:
现象:自动化执行日志显示 InternalError 或 InternalError.System。
解决:
无人值守任务不要直接执行付款、删除唯一文件、批量改名、外部群发或高风险系统操作。先低频试运行,保留日志和人工确认点;完全访问不能代替业务授权与备份。
解决:WorkBuddy 需满足官方版本要求;确认桌面端运行、助手开启、连接方式与凭据正确,再检查网络。
解决:确认服务已开启;Webhook 完整复制;Token/AESKey 与平台一致;长期连接检查 Bot ID/Secret 且无空格,过期则在平台重建。
解决:先核对 Webhook 地址是否完整、是否与当前配置要求一致;仍无法通过时,保留报错截图并提交排查。
解决:优先切换模型测试;若问题持续存在,记录错误码、发生时间与网络环境后再排查。
解决:重复输入同一 Webhook 地址后,可能出现"无法检查链接"的提示。重新创建或重新填写一次配置,避免重复输入同一地址;仍失败时保留提示信息后反馈。
解决:鸿蒙 6 的微信扫码当前存在不兼容情况,鸿蒙 4 可以正常连接。临时方案:先用安卓手机完成首次扫码连接,再切换回鸿蒙微信继续使用;后续以官方更新为准。
现象:WorkBuddy 端显示已注册或已配置完成,但机器人不回复、偶发断开,或首次可用后再次打开即失联。
原因:可能是模型异常、网络不稳定或平台连接超时。
解决:
解决:远程入口受设备与路径限制;在电脑端指定本地工作空间与文件路径。
解决:在官方设置入口重新授权;确认回调未被代理/扩展拦截;只授予完成任务所需范围。
解决:在第三方平台核对状态、权限、有效期和配额;轮换密钥后立即撤销旧密钥。
解决:确认服务端可达、工具仍发布、当前模型/账号有权限;先单独测试该工具,再回到自动化。
解决:检查第三方授权范围与目标资源权限;不要通过完全访问绕过第三方权限。
解决:先在桌面端确认助理已创建、工作目录正确且客户端在线,再按对应平台重新生成二维码或重新授权。QQ 的 WebSocket、URL 回调和应用凭据必须与开放平台配置一致;企业微信需核对 Bot ID、Secret、Token、AESKey、Webhook 和回调地址。微信客服号二维码过期时重新点击【配置】生成。所有凭据只保存在平台或客户端配置页,反馈截图先遮盖。
解决:先发送无敏感数据的只读任务,确认桌面端在线且远程端与桌面端账号一致;检查助理固定工作目录、任务历史、产物和错误日志。涉及删除、覆盖、外发或支付时回到桌面端人工确认,不要在移动端连续重试。
解决:不依赖电脑本地文件时选择【云上】;需要读取电脑工作目录时选择【电脑】,并保持桌面客户端开机、联网且未休眠。电脑模式看不到文件时,在桌面端把副本放入指定工作空间并写明路径。
不要依据“最后登录设备”等未经确认的规则判断。先在目标电脑核对账号、助理绑定、在线状态和工作目录,再使用无敏感数据的只读任务验证实际接收设备;未明确支持设备选择时,避免同时让多台电脑保持同一远程入口在线。
先检查该自动化当前是否启用了受支持的通知渠道,并查看运行记录确认任务实际完成。不同远程平台的主动推送能力可能不同;没有对应开关时,不应假设会推送。需要通知时可使用已授权并验证过的邮件、连接器或小程序入口。
在左下角头像菜单中选择浅色或深色主题,并在【语言】中切换客户端语言。修改后界面未刷新时重启客户端;该操作不会更改任务文件。
桌面应用可能通过自定义 URL 协议处理唤醒或打开请求。接入前以当前官方开发说明确认协议名、支持参数和安全校验;只允许可信来源调用,避免把本地文件路径、令牌或未转义参数直接拼入公开链接。
前往官方价格方案页面查看 WorkBuddy 套餐定价并下单购买;企业售前咨询与商务对接渠道也在该页面获取。
登录官网,点击右上角头像账户,前往个人主页 > 用量管理领取。
前往官网登录账号,从头像处进入个人主页 > 账号管理注销账号。
WorkBuddy 构建了企业级三层纵深防御安全体系:
| 层级 | 防御内容 |
|---|---|
| 技术防御层 | Bash 命令沙箱(AI 操作与真实系统隔离);文件系统隔离(仅访问预先授权的工作空间目录,无法访问系统敏感文件);防沙箱逃逸(阻止对配置文件的写入);启动时仅拥有只读权限,编辑文件、运行命令需显式用户批准;allow(允许)/ask(询问)/deny(拒绝)分层权限规则 |
| 管理管控层 | SSO 单点登录与组织架构自动同步;Credit 额度按部门/角色差异化控制;IP 白名单限制特定 IP 段登录;精细化工具调用权限(文件、命令、网络的访问能力) |
| 合规审计层 | Skill 安全审计与安全团队联动分级判险;skill-scanner 本地安全检查;服务端仅处理数据片段,企业数据默认不用于模型训练;符合网安法/数安法/个保法的用户协议与隐私协议 |
通信与部署安全:
合规资质:WorkBuddy 作为腾讯云产品继承其安全合规体系,拥有 400+ 国内外权威认证,包括 ISO27001(UKAS/CNAS)、ISO27018、ISO27701、CSA STAR(金牌)、网络安全等级保护三级/四级、PCI-DSS、SOC 审计报告、可信云数据安全认证。
本节按官方 FAQ 口径整理,具体条款以官方隐私保护声明与相关协议为准。
以上方案无法解决问题时,通过以下渠道反馈:
提交时务必包含:
日志可能包含会话与设备信息。提交前按企业制度确认授权;截图中遮盖手机号、密钥、Cookie、内部网址、客户信息和文件正文。不要在聊天群公开发送 SecretKey、Token、Webhook 密钥或完整日志。