装机 + 故障 速查

装好它 · 让它跑起来

集合了 WorkBuddy 与 QClaw 的详细装机步骤、首次启动指引、常见错误码速查。 包含 Mac / Windows 双系统说明,以及现场最容易遇到的 5 个错误的处理方式。

📦 第一步

安装 WorkBuddy

整个过程 ≈ 3 分钟。建议使用 Wi-Fi 下载安装包。

1 下载安装包

访问官网:codebuddy.cn/work ↗

页面会根据你的系统自动推荐对应版本:

  • 🪟 Windows 10/11 64 位 — 下载 .exe 安装包(约 200 MB)
  • 🍎 macOS 11+ — 下载 .dmg 安装包(约 220 MB)

下载速度慢?现场已发的U盘里有离线安装包,直接拷贝使用。

2 运行安装包(Win / Mac)

Windows:

  1. 右键 .exe → 以管理员身份运行
  2. 遇到「Windows 已保护你的电脑」蓝色提示 → 点「更多信息」→「仍要运行」;
  3. 选择安装路径(默认即可,不要装在含中文的路径下);
  4. 点「下一步」直至完成。

Mac:

  1. 双击 .dmg 文件;
  2. 把 WorkBuddy 图标拖到 Applications 文件夹;
  3. 首次打开如提示"无法验证开发者" → 系统设置 → 隐私与安全性 → 点「仍要打开」。
3 登录账号 + 授权工作目录

启动后第一件事是登录:

  • 📱 微信扫码登录(推荐,最快);
  • 📞 手机号登录

登录后会让你授权一个工作目录。这是关键的安全设置:

推荐:授权 桌面/AI工作区 这种专门的子目录。
不要:授权"整个用户目录"或"整个 C 盘"!
4 跑通第一个任务

在对话框输入:

💬 "帮我看看刚才授权的工作目录里有哪些文件,列出来。"

如果能正确返回文件列表,说明:

  • ✅ 安装成功;
  • ✅ 登录正常;
  • ✅ 工作目录授权生效;
  • ✅ 模型调用畅通。

这就完成入门了,回去看 WorkBuddy QA →

🦞 第二步

安装 QClaw(如果你也想装)

整个过程 ≈ 3 分钟。两个产品可以同时安装、互不冲突。

1 申请邀请码(仅 Win 用户)

Mac 用户跳过此步,可直接下载安装。

Windows 用户:

  1. 访问 qclaw.qq.com ↗claw.guanjia.qq.com ↗
  2. 点「申请内测」,填写信息;
  3. 提交后通常 1-3 天通过审核(2026-03 后官方表示"邀请码管够,基本可秒过");
  4. 收到邀请码后回到下载页输入即可下载。
2 运行安装包(Win / Mac)

Windows:

  1. 右键 .exe → 以管理员身份运行;
  2. 遇到 SmartScreen 提示 → 更多信息 → 仍要运行;
  3. 下一步至完成。

Mac(关键步骤):

  1. 双击 .dmg → 拖到 Applications;
  2. 提示"无法验证开发者" → 系统设置 → 隐私与安全性 → 仍要打开;
  3. ⚠️ 务必给 QClaw 授予「完全磁盘访问权限」:系统设置 → 隐私与安全性 → 完全磁盘访问权限 → 勾选 QClaw(没这一步它读不了你电脑里的文件!)。
3 扫码绑定微信
  1. 打开 QClaw 客户端,首页会显示一个二维码;
  2. 手机微信「+」 → 扫一扫 → 扫码;
  3. 按提示确认授权;
  4. 绑定后会收到欢迎消息 — 你已经能在微信里 @QClaw 让它干活了。
4 微信里测一条命令

在微信 QClaw 助手里发:

💬 "电脑现在跑哪些程序?"

如果几秒内能返回当前进程列表,说明远程通道全程畅通,可以开始用了。

更多场景看 QClaw QA →

🚨 错误码速查

遇到错误?对照这张表

下列错误码出现频率最高,看说明 1 分钟自助解决。

错误码 含义 处理方法
14003 积分 / Token 不足 ① 进 WorkBuddy 客户端首页签到送积分;② 切换免费模型重试;③ 简化任务(拆小,少消耗)。
11133 当前模型暂不可用 ① 切换到其他模型(混元 / DeepSeek / Kimi 任一);② 等 5 分钟重试;③ 通常是高峰期网络波动。
6003 会话 / 鉴权超时 ① 退出账号重新登录;② 重启客户端;③ 检查网络(公司内网时换热点)。
40003 文件路径不可访问 ① 检查路径是否在授权目录内;② 文件名不要含特殊字符;③ 给 Mac QClaw 授予"完全磁盘访问权限"。
50001 服务端临时错误 ① 等 1 分钟重试;② 切换模型;③ 持续出现请联系 codebuddy@tencent.com。
万能 3 步法:① 停止任务;② 切换模型;③ 简化指令。90% 的卡顿、超时、报错按这个流程都能恢复。
通用问题

装机 / 启动相关 FAQ

Q 两个软件能同时装吗?会不会冲突?

能同时装,不会冲突。它们用的是不同的进程、不同的服务器接口,互不干扰。

资源占用:闲置时合计内存 ≈ 600 MB;同时运行复杂任务时 ≈ 1.2 GB。建议电脑内存 8 GB 起。

Q 公司电脑装不了,提示"被组策略限制"

这是企业 IT 把"安装新软件"权限锁了。处理方式:

  1. 找 IT 部门申请安装权限;
  2. 或换自己的笔记本电脑现场体验;
  3. 有些企业版有"绿色版" — 联系 codebuddy@tencent.com 询问。
Q 手机能不能直接装一个 App 来用?

WorkBuddy 和 QClaw 都是桌面端产品,手机上没有独立 App。

但你可以:

  • 📱 用微信遥控 QClaw / WorkBuddy;
  • 📱 在手机微信里下达指令,电脑端执行。

这其实就是它们最大的特色之一。

Q 我的电脑很老(8GB 内存以下),能装吗?

能装,但体验会受影响。建议:

  • 关闭浏览器、PS 等内存大户;
  • 不要同时开 WorkBuddy 和 QClaw;
  • 大文件处理任务建议拆小;
  • 慎用"多 Agent 并行"。
Q 现场怎么找人帮忙装?

3 种方式:

  • 🙋 举手 — 穿工作服的志愿者会过来现场帮你装;
  • 📧 邮件 — codebuddy@tencent.com,记下错误码会回复;
  • 📚 看官方文档codebuddy.cn/docs ↗
装好后下一步: 看 WorkBuddy QA →看 QClaw QA →