安装：Windows 与 Mac 主流程，5 分钟搞定
这一页带你完成 WorkBuddy 安装 的主流程：去官网下载安装包 → Windows / Mac 安装 → 微信扫码登录 → 确认能检查更新。安装操作本身约 5 分钟能走完；安装包体积在 356–429 MB 之间，下载时间看你的网速。
WorkBuddy 是桌面客户端，不是浏览器里的网页工具——所以「装上它」是用它的第一步。上一课你已经分清了 WorkBuddy、CodeBuddy、QClaw、OpenClaw 四个名字，这一课只装正版的 WorkBuddy 本体：官网 workbuddy.cn 的安装包。
两条路线先说清，别在错了的页面上耗时间：
- 统信 UOS / 银河麒麟用户：你的安装方式是系统自带的应用商店，直接去 1.2b 备用安装方式
- 国际版用户（workbuddy.ai）：下载入口与账号体系都不同，看 5.5 国际版
学完你能做什么
- 在 Windows 10 及以上（x64）或 macOS 12 及以上的电脑上，从官网下载并装好 WorkBuddy
- Mac 用户能选对 ARM64 / X64 安装包，并把 WorkBuddy 拖进「应用程序」文件夹（官方警告：不拖进去就无法自动更新）
- 用微信扫码完成登录，并说得出个人登录与企业登录两个入口分别给谁用
- 装好后手动检查更新、按需切换界面语言
- 知道哪些设备装不上（Win7/8/8.1、Windows 11 ARM64），以及装不上时去哪一页排查
你现在的困境
- 搜「WorkBuddy 下载」跳出来一堆第三方下载站，不知道哪个才是官方安装包，怕下到旧版或改包
- 我是 Mac，芯片分 M 系列和 Intel，安装包还分 ARM64 和 X64——下错了怕白等 400 MB
- 装到一半开始拿不准：Windows 向导问一堆选项要不要改？Mac 拖完那个 .dmg 能删吗？登录又跳到浏览器，万一卡住哪一步算成功？
什么时候用这一招
当你需要：
- 在自己的 Windows 或 Mac 电脑上装好 WorkBuddy 桌面客户端，开始干活
- 确认设备满足官方系统要求，选对芯片对应的安装包
- 第一次登录：微信扫码，选对个人 / 企业入口
而且不想：
- 为了一个 AI 办公工具去部署服务器、配 API Key
- 从来路不明的下载站装软件
- 装完发现无法自动更新、或登录卡死反复重试
🎒 开始前的准备
- 读完了 1.1 WorkBuddy 是什么，确认要装的是腾讯的 AI 办公工作台 WorkBuddy（官网 workbuddy.cn），别和 QClaw 装混
- 一台满足要求的电脑（第 1 步会逐条核对）：Windows 10 及以上（x64）或 macOS 12 (Monterey) 及以上
- 一个能扫码的微信（登录以微信扫码为主，也支持手机号 / 邮箱 / SSO）
- 网络和磁盘空间：安装包 356–429 MB；官方诊断工具把磁盘剩余低于 3 GB 视为告警、低于 1 GB 视为失败，建议留足
- 8 分钟阅读时间，外加安装包的下载时间
核心思路
WorkBuddy 安装的主流程就四步：下载 → 安装 → 登录 → 检查更新。 官网「立即下载」会按你的设备给对应安装包，你真正要做的只有三个关键选择——选对安装包、装对位置、登录选对入口：
| 关键选择 | 怎么选 | 选错的后果（官方口径） |
|---|---|---|
| 安装包 | Windows 统一 x64；Mac 按芯片分 ARM64 / X64 | ARM64 包无法在 Intel Mac 上运行 |
| 安装位置（仅 Mac） | 拖入「应用程序」文件夹后再启动 | 从 .dmg 直接运行会跑在只读磁盘映像上，后续无法自动更新 |
| 登录入口 | 个人用户走个人登录，购买企业版的走企业登录 | 官方为个人用户与企业版用户分设了两个入口 |
不同设备的下载渠道也不一样，先对号入座：
| 你的设备 | 下载渠道 | 去哪一页 |
|---|---|---|
| Windows 10+（x64）/ macOS 12+ | 官网「立即下载」 | 本页 |
| 统信 UOS / 银河麒麟 V10 | 系统应用商店 | 1.2b 备用安装方式 |
| 需要 WorkBuddy 历史版本 | 官方历史版本归档页（直链） | 1.2b 备用安装方式 |
WorkBuddy 登录为什么在浏览器里做？官方的设计是：点客户端的登录按钮后，浏览器自动打开 workbuddy.cn 的登录页，你在当前页面勾选《用户服务协议》与《隐私政策》、微信扫码，登录全程在当前页面完成，无需跳转；页面显示登录成功后回到客户端就可以了。
跟我做
第 1 步：核对系统要求，确认设备能装
为什么：两份官方安装指南都写了同一句提示——「不满足上述要求的系统将无法启动 WorkBuddy」。先花 30 秒核对，免得下载完几百 MB 却装不上。
逐条对照官方环境要求：
| 系统 | 官方要求 | 备注 |
|---|---|---|
| Windows | Windows 10 及以上，支持 x64 | 不支持 Windows 7 / 8 / 8.1 |
| macOS | macOS 12 (Monterey) 及以上 | 查版本：点屏幕左上角苹果图标 → 关于本机 |
Windows 的 ARM64 设备要单独注意：官方 FAQ 明确写「当前版本暂不支持 ARM 64 架构的 Windows 11」，建议改用受支持的设备环境或等待后续版本支持；安装指南那边的口径是「ARM64 设备的支持情况以当前版本说明为准」。
两处对照，按「暂不支持」处理更稳妥——装不上别硬试。
你应该看到：你的系统在要求范围之内。任何一条不满足，先不下载，换受支持的设备；排查思路在 1.3 装不上怎么办。
- 我对照上表确认过了，自己的系统满足要求（Mac 用户顺手查了系统版本）
第 2 步：去 WorkBuddy 官网下载安装包
为什么：官网「立即下载」会按设备提供对应安装包，从官方渠道拿，版本和文件都不会出岔子。
操作：
- 打开 WorkBuddy 官网，点击「立即下载」，选择 Windows 或 Mac。
- 等待下载完成。官方《开启你的第一个任务》页对入口的描述是「鼠标悬停『下载 WorkBuddy』，选择适配当前设备的版本」——文案略有差异，指的都是官网的下载入口。
- Mac 用户：如果浏览器弹出确认框，选择允许下载。
Mac 安装包别选错版本，官方给了明确规则：
| 你的芯片 | 选择 | 说明 |
|---|---|---|
| M 系列（Apple 芯片） | Mac ARM64 | M 系列芯片对应的版本 |
| Intel 芯片 | Mac X64 | ARM64 包无法在 Intel Mac 上运行 |
| 官网没识别出设备 | 默认给 X64 | X64 包可通过 Rosetta 在 M 系列上运行，兼容性更广 |
下载体积参考（v5.9.3 官方口径）：Windows x64 约 429.3 MB，macOS Apple 芯片约 356.1 MB，macOS Intel 约 384.5 MB。下载慢是体积问题，别中途关掉。
你应该看到：下载文件夹里出现 WorkBuddy 安装包——Windows 是 .exe，Mac 是 .dmg。
- 安装包下载完成，体积在几百 MB 量级
详细步骤可对照官方文档：Windows 系统安装指南、Mac 系统安装指南。
第 3 步：Windows 用户：走完 WorkBuddy 安装向导
为什么：Windows 是标准向导式安装，官方指南给了完整步骤清单，跟随默认选项就能装好，只有两处建议你留意。
跟着向导走（官方 Windows 安装指南的步骤）：
- 双击下载好的安装包，启动安装程序
- 勾选「我同意此协议」，点击下一步
- 选择安装路径（用默认路径可直接点击下一步），点击下一步
- 确认开始菜单文件夹，点击下一步
- 建议勾选「创建桌面快捷方式」，点击下一步
- 确认配置无误，点击安装
- 安装完成后，点击完成，退出安装向导
💡 向导里若出现「选择安装用户」
官方《开启你的第一个任务》页提到向导中有「选择安装用户」一步，建议选「仅为我安装」。官方两篇文档对向导步骤的描述略有差异（安装指南未列这一步），遇到就按官方建议选，其余跟默认走。
你应该看到：向导走完，开始菜单里出现 WorkBuddy；勾选了桌面快捷方式的话，桌面上也有一个。
（Mac 用户：跳到第 4 步。）
第 4 步：Mac 用户：拖进「应用程序」再启动
为什么：官方在 Mac 指南里加了醒目警告——如果双击 .dmg 后直接从磁盘映像里运行，WorkBuddy 会运行在只读的磁盘映像上，后续将无法自动更新。所以「拖进应用程序文件夹」不是可选项，是必做项。
操作（官方 Mac 安装指南的步骤）：
- 双击已下载的
.dmg磁盘映像文件，打开安装窗口 - 把 WorkBuddy 图标拖入 Applications（应用程序）文件夹
- 等待拷贝完成
- 推出已挂载的 WorkBuddy 磁盘映像；下载目录里的
.dmg安装包不再需要，可以删除
之后打开 WorkBuddy 的方式：启动台，或 Command + 空格 搜索。
你应该看到：「应用程序」文件夹里有 WorkBuddy，双击能正常启动。
（Windows 用户：第 3 步已装好，直接去第 5 步。）
第 5 步：微信扫码登录，选对个人 / 企业入口
为什么：登录是启动后的第一件事，官方把登录放在浏览器页面完成，扫码成功回客户端就能用。
操作：
- 启动 WorkBuddy，点击登录按钮
- 浏览器自动打开官网（workbuddy.cn）的登录页面
- 在登录弹窗中勾选《用户服务协议》与《隐私政策》
- 使用微信扫码完成登录；也支持手机号、邮箱、SSO 等方式
- 页面显示登录成功后，返回客户端
登录入口这样选：官方《开启你的第一个任务》页的原话是「个人用户选择个人登录方式，购买企业版的用户选择企业登录方式」。个人用户（含免费体验版）走个人登录即可。
💡 下载安装不收费
WorkBuddy 装完就能用：未订阅即为体验版，每月 500 基础积分（免费）。积分规则与套餐见 2.6 积分与价格。
你应该看到：客户端进入主界面，不再是登录页。
- 微信扫码成功，客户端显示了主界面
如果点击登录后浏览器打不开、登录失败或客户端无响应：别无限重试。官方 FAQ 列了三类常见原因（默认浏览器未设置、账号文件夹权限不足、安全软件拦截），逐条排查方法在 1.3 装不上怎么办。
第 6 步：收尾：检查更新与界面语言
为什么：刚装好不一定是最新版；顺手确认更新通道正常，也等于验证 Mac 装对了位置。
操作：
- 点击左下角头像 → 检查更新。官方说明：若已是最新版本则无需操作；若存在新版本，系统将自动下载并完成升级。
- 需要切换界面语言的话：点击左下角头像 → 设置 → 通用 → 语言。
Mac 用户多看一眼：如果检查更新失败，或启动时出现无法自动更新的提示，说明 WorkBuddy 还在从安装包（磁盘映像）直接运行。官方给的处理方式——点提示中的「移动到应用程序」按钮一键移动，或打开文件夹把 WorkBuddy 手动拖入「应用程序」文件夹，然后从「应用程序」重新启动。
你应该看到：「已是最新版本」的提示，或自动升级完成。到这一步，WorkBuddy 安装全部结束。
检查点 ✅
- WorkBuddy 已装上：Windows 在开始菜单 / 桌面能看到它；Mac 在「应用程序」文件夹里
- 微信扫码登录成功，客户端显示主界面；个人 / 企业入口按官方指引选对了
- Mac 用户：WorkBuddy 是从「应用程序」启动的，「检查更新」能正常运行
- 左下角头像 → 检查更新，显示「已是最新版本」或完成了自动升级
- 我知道下次装不上、登不上时，去 1.3 装不上怎么办 对照排查
踩坑提醒
❌ Windows 7 / 8 / 8.1，或 Windows 11 ARM64 设备：下载完装不上
现象：安装包下了 400 多 MB，安装或启动失败。
为什么错：官方 Windows 安装指南明确不支持 Windows 7 / 8 / 8.1；ARM64 架构的 Windows 11 在官方 FAQ 里是「当前版本暂不支持」，建议改用受支持的设备环境，或等待后续版本支持。
正确做法：换 Windows 10 及以上（x64）或 macOS 12 及以上的设备再装。ARM64 Windows 用户以官方 FAQ 的保守口径为准，等版本更新，别信来路不明的改包。
❌ Mac 直接从 .dmg 里双击运行，之后无法自动更新
现象：检查更新失败，或启动时提示无法自动更新。
为什么错：官方 Mac 安装指南警告——直接从磁盘映像运行，WorkBuddy 会运行在只读的磁盘映像上，后续将无法自动更新。
正确做法：先拖入「应用程序」文件夹再启动。已经中招也不用重装：点提示中的「移动到应用程序」按钮一键移动，或手动把 WorkBuddy 拖入「应用程序」，然后从「应用程序」重新启动即可。
❌ Mac 芯片选错安装包：Intel 机器装了 ARM64 包
现象：下载的 WorkBuddy-darwin-arm64-*.dmg 在 Intel Mac 上无法运行。
为什么错：官方写明 ARM64 包无法在 Intel Mac 上运行；反过来 X64 包可以通过 Rosetta 在 M 系列芯片上运行，兼容性更广——所以官网未识别设备时才默认提供 X64 版本。
正确做法：点屏幕左上角苹果图标 → 关于本机，确认芯片类型。M 系列 → ARM64 包；Intel → X64 包；拿不准 → X64，两类芯片都能运行。
❌ 登录卡住就无限重试
现象：点登录没反应、浏览器打不开、扫码后没变化，于是反复点、反复扫。
为什么错：官方 FAQ 给出的常见原因就三类——默认浏览器未设置；WorkBuddy 账号文件夹权限不足；安全软件拦截（火绒、360 安全卫士、电脑管家、Windows 安全中心等都可能误拦）。这些问题重试一百次也还是失败。
正确做法：停手，去 1.3 装不上怎么办 按官方 FAQ 的三条原因逐条排查；也可以先用客户端的「诊断工具」自检（见下面进阶技巧）。
进阶技巧（可选）
🔧 装完先跑一次「诊断工具」自检。 打开 WorkBuddy，在帮助菜单中打开「诊断工具」，点开始检测：它会一键检查网络、系统资源、安全软件、环境信息与崩溃日志，结果可视化展示，并自动生成 .txt 诊断报告（保存在日志目录 logs/self-check/ 下，保留最近 10 份）。
登录失败、连接异常时先自检再反馈；个人账号默认仅展示「网络」分组的检查项。
🔧 把手机也连上，电脑装好才有下半场。 官方支持连接 WorkBuddy 小程序、WorkBuddy App，还能接入微信助理、微信客服号、企微助理、QQ 机器人、飞书、钉钉机器人等远程渠道——配置总览在 5.1 助理总览，手机远程派任务的完整实战见 C2 手机远程遥控。
本课小结
✅ WorkBuddy 安装的主流程你已走完：官网「立即下载」→ Windows 向导式安装 / Mac 拖入「应用程序」→ 微信扫码登录 → 检查更新确认最新。
✅ 三个关键选择都拿到了官方依据：安装包按芯片选（Mac 拿不准选 X64）；Mac 必须拖进「应用程序」否则无法自动更新；个人登录 / 企业登录按账号类型选。
✅ 登录支持微信扫码（主）、手机号、邮箱、SSO；登录全程在当前网页完成，成功后返回客户端。
✅ 装不上时的三大方向你已经知道去哪查：系统要求（本页第 1 步）、官方 FAQ 三类登录问题、客户端诊断工具——完整排查在 1.3 装不上怎么办。
关键选择回顾：
| 选择点 | 推荐做法 | 依据 |
|---|---|---|
| 下载渠道 | 官网 workbuddy.cn「立即下载」 | 官方 Windows / Mac 安装指南 |
| Windows 系统版本 | Windows 10 及以上（x64） | 官方安装指南：Win7/8/8.1 不支持 |
| Mac 安装包 | M 系列 → ARM64；Intel → X64；拿不准 → X64 | 官方 Mac 安装指南 |
| Mac 安装位置 | 拖入「应用程序」文件夹后再启动 | 官方警告：从 .dmg 直接运行无法自动更新 |
| Windows「选择安装用户」 | 仅为我安装 | 官方《开启你的第一个任务》建议 |
| Windows 桌面快捷方式 | 建议勾选 | 官方 Windows 安装指南建议 |
| 登录入口 | 个人登录；购买企业版的选企业登录 | 官方《开启你的第一个任务》 |
| 登录方式 | 微信扫码为主；另有手机号 / 邮箱 / SSO | 官方 Windows / Mac 安装指南 |
下一课预告
主流程装好了，下一课按课程表讲两条备用安装路线：备用安装方式：统信 UOS、银河麒麟与历史版本。
你会学到：
- 统信 UOS、银河麒麟 V10 用户：在系统自带的应用商店里搜索 WorkBuddy 安装的完整步骤
- WorkBuddy 历史版本去哪下：官方归档页提供各版本安装包直链
- 什么时候需要装旧版本，以及旧版本和新版本怎么选
如果你的 Windows / Mac 安装一路顺利，1.2b 可以整页跳过，直接去 1.4 第一个任务：从一句话到可验收的产物；装的过程卡住了，先去 1.3 装不上怎么办 对照排查。