02 · 入门与安全
下载安装登录与更新
安装教程最怕把旧版本参数写成永久规则。下载域名、系统要求、登录方式和更新入口都会变化，所以这一章重点讲怎样确认官方来源、选择正确安装包、完成登录，并留下可复查的版本记录。
本章最终要解决的问题是：从哪里下载，Windows/macOS 如何安装、登录和更新？
版本说明：本章原始资料来自不同时间。界面名称、入口、模型、积分、价格、权限、连接器和企业能力如与当前客户端不一致，以当前官方说明、实际界面和企业合同为准。文中的历史数值不作为购买或合规承诺。
这一章怎么学
- 理解问题：从哪里下载，Windows/macOS 如何安装、登录和更新？
- 完成练习：安装完成记录、版本记录
先跑出一个可检查的小结果，再逐步扩大任务范围。 阅读正文时，把注意力放在任务输入、真实动作、交付文件和人工判断点上。
资料说明：下面的具体步骤、案例和截图根据已收集的第三方教程重组。正文中的第一人称均指原教程作者，不代表曾俊本人的经历或实测；案例数字也不能直接视为官方承诺。
🐉 腾讯出品 📦 零部署门槛 ⚡ 3分钟上手
WorkBuddy 安装部署完全指南
从下载安装到高效办公 —— 全场景 AI 办公工作台，你的职场好搭子
版本: 5.x | 更新: 2026年6月 | 适用平台: Windows · macOS
一、WorkBuddy 是什么
WorkBuddy 是腾讯云 CodeBuddy 团队推出的全场景职场 AI 智能体桌面工作台。你只需要用一句话描述需求，WorkBuddy 就能像同事一样自主规划、执行复杂任务，并交付可直接验收的结果。
▲ WorkBuddy 核心能力模型：自然语言 + 文件 + 连接器 → AI 自主执行 → 产出可验收结果
对比维度
传统 AI 对话
WorkBuddy
交互方式
只能对话，提供建议
能够实际执行任务
文件操作
需要手动操作文件
自动操作本地文件
任务复杂度
单步骤简单任务
多步骤复杂任务
输出形式
输出文字回复
交付可验收的结果
平台集成
无
连接飞书/企微/QQ/钉钉
🎯 适用场景一览
日常办公：生成工作报告、技术文档、README、PPT、会议纪要、周报、数据分析
代码开发：代码生成、Code Review、Bug 修复、重构优化、项目理解、网站/应用全流程开发
设计创意：界面设计稿、交互原型、Logo/品牌设计、营销海报、社交媒体配图
文件自动化：批量重命名、分类归档、桌面整理、格式转换，一条指令全搞定
二、系统要求
项目
最低要求
推荐配置
操作系统
支持的系统版本、芯片架构和安装包大小以当前官方下载页为准。 CPU 架构 x64 / arm64 (Apple Silicon 原生支持) Apple M 系列 / Intel 12代+ 存储空间 ≥ 200 MB ≥ 500 MB（含任务缓存） 安装包大小 网络 需要网络连接以调用 AI 模型服务（首次登录需联网激活） 账号 需注册并登录 WorkBuddy 账号（支持微信扫码 / 腾讯云账号） 💡 提示 WorkBuddy 是真正的免部署、零代码桌面应用——无需安装 Node.js、Python 或任何运行时环境，双击即用。完全兼容 OpenClaw 技能生态，现有 Skills 和工作流无需修改即可无缝迁移。 三、下载与安装 ⚠️ 重要提醒 官方入口曾多次调整，请从腾讯当前官方页面或企业管理员提供的地址进入，发布前重新核验域名。 3.1 选择对应版本 平台 架构 安装包文件名 Windows x64 WorkBuddy-win-x64-setup.exe Windows arm64 WorkBuddy-win-arm64-setup.exe macOS Intel (x64) WorkBuddy-darwin-x64.dmg macOS Apple Silicon (arm64) WorkBuddy-darwin-arm64.dmg 3.2 Windows 安装流程 运行安装程序 双击下载好的WorkBuddySetup.exe，弹出安装向导，点击【下一步】。 接受许可协议 勾选「同意许可协议」，点击【下一步】。 选择安装目录 可根据需求自行选择安装路径。建议安装到 D 盘或其他非系统盘，避免占用系统盘空间。 设置快捷方式 默认勾选即可，建议勾选「创建桌面快捷方式」，方便后续快速启动。 开始安装 点击【安装】，等待进度条完成。整个过程约 1–2 分钟。 安装完成 安装完成后，WorkBuddy 会自动启动，进入登录界面。 3.3 macOS 安装流程 打开 DMG 文件 双击下载好的.dmg文件，Finder 会挂载安装镜像。 拖入应用程序 将WorkBuddy图标拖拽到「Applications」（应用程序）文件夹。 允许运行（如遇拦截） 若提示「无法验证开发者」，前往系统设置 → 隐私与安全性，点击「仍要打开」即可。 🍎 macOS 用户注意 WorkBuddy 原生支持 Apple Silicon (M1/M2/M3/M4)，无需 Rosetta 转译，性能表现最佳。Intel Mac 同样完整支持。 四、登录与账号配置 启动 WorkBuddy 双击桌面快捷方式或从开始菜单/Launchpad 启动 WorkBuddy。 选择登录方式 WorkBuddy 支持微信扫码登录和腾讯云账号登录。推荐使用微信扫码，速度最快。 完成手机验证 微信扫码后，系统会要求进行手机号验证，确保账号安全。输入验证码即可完成登录。 登录成功 积分、Credits、赠送活动和消耗规则变化很快，本稿不保留历史额度；请以当前账户与官方计费说明为准。 五、授权文件访问权限 WorkBuddy 需要读取和修改本地文件才能帮你"干活"。首次使用时会引导你授权文件访问权限。 选择授权目录 根据引导，选择需要 WorkBuddy 操作的本地文件夹。常见选择包括：桌面、下载、文档 (Documents)等。 确认授权范围 WorkBuddy只能访问你主动勾选授权的文件夹，系统敏感目录（如系统盘核心目录）自动拦截，无法访问。 随时可调整 在设置中可随时增减授权目录范围，灵活控制。 🔒 数据安全承诺 API Key、数据留存和训练使用范围必须以当前隐私政策、第三方模型条款及企业合同核验。 六、界面概览 ▲ WorkBuddy 主界面布局：左侧任务列表 / 中间对话交互区 / 右侧结果展示区 区域 功能说明 侧边栏 显示任务列表（按文件夹分组），支持搜索和管理。底部显示用户头像和设置入口。 对话区 核心交互区域，包含任务标题栏、消息列表和输入框。所有对话和操作都在这里进行。 结果区 右侧面板，展示产物、全部文件、变更、预览四个视图，一键切换。 七、工作模式：Craft / Plan / Ask WorkBuddy 提供三种工作模式，根据任务需求灵活切换： ▲ 三种工作模式对比：Craft 立即执行 / Plan 先规划再确认 / Ask 纯对话咨询 八、创建你的第一个任务 8.1 描述任务 WorkBuddy 的核心优势是理解自然语言。你只需用一句话描述需求，它就能自主规划和执行。 场景 示例指令 文档生成 "帮我把这份销售数据生成一个分析报告，包含图表" 文件整理 "整理 Downloads 文件夹里的图片，按日期分类" PPT 生成 "根据这份会议纪要生成一个 PPT" 信息提取 "分析这份简历，提取关键信息生成表格" 深度研究 "调研一下 2024 年 AI 行业趋势，写一份报告" 代码开发 "帮我写一个用户登录页面，包含表单验证" 8.2 添加上下文 创建任务时，可以补充上下文让 WorkBuddy 更精准地理解需求： 方式 操作 引用上下文 通过@引用文件、文档、规则等信息 粘贴截图 使用Ctrl+V(Win) /Cmd+V(Mac) 粘贴剪贴板图片 上传文件 点击上传按钮或直接拖拽文件到输入框 补充说明 明确目标、输入、输出格式、约束条件 ✍️ 写好任务描述的 4 要素 1.目标是什么——要生成什么内容、处理什么文件 2.输入是什么——需要分析的数据、参考的文档 3.输出格式——Word、Excel、PPT 还是其他格式 4.约束条件——风格要求、字数限制、截止时间等 九、任务管理与空间 9.1 任务列表 左侧边栏展示所有任务，分为两个板块： 1任务：展示最近访问或最近更新的任务 1空间：按工作空间整理的任务，方便在同一个项目下集中查看 每个任务卡片显示：任务标题、当前状态、最近更新时间。 9.2 任务状态 状态 说明 🔄进行中 WorkBuddy 正在执行任务 ✅已完成 任务已成功执行完成 ❌失败 执行过程中出现问题，任务未能完成 ⏳待处理 任务等待进一步处理或输入 📋规划中 WorkBuddy 正在分析需求并整理执行思路 📁已归档 任务已被归档，可后续查阅 9.3 任务操作 操作 说明 📌 置顶 将任务置于列表顶端 ✏️ 重命名 修改任务名称 📂 打开文件夹 打开任务所在文件夹 💾 保存到工作空间 持久保存，随时用 IDE 打开查看 🔗 分享任务 自动生成公开链接，分享到任意渠道 🗑 删除 从列表中删除任务 📁 归档 归档后可在「系统设置-数据管理」中查看 十、任务对话与上下文 10.1 对话方式 任务创建后，在中间对话区持续与 WorkBuddy 互动： 1在输入框直接输入需求或补充说明 1按回车键或点击发送按钮发送消息 1在已有任务中继续追问，WorkBuddy 会基于之前的上下文继续处理 1查看执行过程中的回复、结果和中间步骤 10.2 消息发送与追问 场景 示例 新需求 "再加一个饼图"、"把字体调大一点" 修改意见 "表格按销售额排序"、"报告加上执行摘要" 继续追问 "帮我导出成 PDF"、"再分析一下环比变化" 10.3 支持的文件类型 PDF、Word、TXT、Markdown、RTF、Excel、CSV、TSV、PPT、常见图片 (JPG/PNG/GIF/BMP)、ZIP/RAR 压缩包以及各类编程语言代码文件。 10.4 顶部操作栏 功能 说明 🔍 对话内搜索 输入关键词快速查找目标对话内容 🔗 分享任务 自动生成公开链接，分享到任意渠道 📜 历史提问 查看任务内历史对话记录，支持点击跳转 📊 显示详情面板 打开右侧边栏，查看产物/文件/变更/预览 十一、结果查看与产物分享 11.1 右侧结果区四视图 ▲ 结果区四大视图：产物交付 / 文件浏览 / 变更对比 / 网页预览 11.2 产物分享与云端上传 在预览产物文件时，点击右上角分享图标，支持上传到： 1我的云端网盘——跨设备访问 1腾讯文档——在线协作编辑 1ima 知识库——知识沉淀与管理 1乐享知识库——团队知识共享 十二、连接器：打通第三方服务 连接器是 WorkBuddy 与外部服务之间的桥梁，让 AI 直接访问和操作第三方服务。 ▲ WorkBuddy 连接器生态：已内置 / 支持自定义扩展 12.1 连接示例：QQ 邮箱 进入连接器管理 左侧导航栏点击「连接器」，找到 QQ 邮箱卡片，点击+按钮。 扫码授权 使用 QQ 邮箱 App (7.1.5+ / 鸿蒙 0.2.9+) 扫描二维码授权。 确认权限 在手机端确认 WorkBuddy 申请的权限：读取邮件、发送邮件、管理文件夹等。 连接完成 卡片名称旁出现 🟢 绿色圆点即表示连接成功。 12.2 已支持的连接器 连接器 核心能力 📧 QQ 邮箱 收发邮件、搜索邮件、汇总线程、管理文件夹 📄 腾讯文档 创建/编辑在线文档、表格、幻灯片 📚 腾讯乐享 搜索/创建知识库文档、导入 Markdown、标签整理 🎥 腾讯会议 查询会议记录、纪要、参会人信息 📋 TAPD 项目管理、需求/缺陷/任务操作 ☁️ 腾讯网盘 云端文件管理、上传下载 十三、MCP：扩展 AI 能力边界 MCP（Model Context Protocol，模型上下文协议）可以理解为 AI 的"USB 接口"——让 AI 连接各种外部工具和数据源。 ▲ MCP 架构：WorkBuddy 通过 MCP 协议对接多种外部服务 13.1 两种配置级别 级别 适用场景 配置文件路径 用户级 配置一次，所有项目复用 ~/.workbuddy/mcp.json 项目级 仅当前项目生效，互不影响 <项目目录>/.workbuddy/mcp.json 13.2 快速接入企微机器人示例 Plaintext { "mcpServers": { "wecom": { "command": "uvx", "args": ["wecom-bot-mcp-server"], "env": { "WECOM_WEBHOOK_URL": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=your-key" } } } } 获取 WebHook URL 在企业微信群中添加群机器人，获取 WebHook 地址。 打开 MCP 配置入口 侧边栏 → 插件 → 右上角 MCP 服务器 → 配置 MCP。 填写配置并保存 将上述 JSON 粘贴到编辑器中，替换 WebHook URL。 检查状态 🟢 绿色 = 连接成功 / 🔴 红色 = 配置异常，需排查。 🧠 MCP 最佳实践 •公共能力配用户级：通知类能力一次配置，多项目复用 •专属接入配项目级：项目独立配置，避免互相影响 •从成熟示例起步：先接入 WeCom Bot 等路径清晰的 Server •描述尽量明确：说清通知对象、内容、是否需要 @ 十四、隐私与安全 🔐 WorkBuddy 安全模型 WorkBuddy 的设计理念是「数据留在本地，智能来自云端」： 维度 保障措施 文件处理 所有文件处理默认在本地完成，原始数据不上传云端 服务端数据 仅处理数据片段，用后即弃，不保存也不用于模型训练 访问控制 只能访问你主动勾选授权的文件夹，系统敏感目录自动拦截 高危操作 批量删除等危险操作需二次确认方可执行 连接器 每个连接器独立授权，不超出你在第三方服务中的已有权限 凭据安全 API 密钥与 Token 加密存储，建议及时撤销不使用的授权 十五、常见问题与实用技巧 Q1: WorkBuddy 需要付费吗？ Q2: 安装时提示「无法验证开发者」怎么办？(macOS) 前往系统设置 → 隐私与安全性，在页面底部找到被拦截的应用，点击「仍要打开」。这是 macOS Gatekeeper 的安全机制，正常现象。 Q3: 可以远程控制 WorkBuddy 吗？ 可以。在设置中绑定企业微信 / 钉钉 / 飞书 / QQ后，即可通过手机发消息远程操控电脑执行任务。最快 1 分钟完成绑定。 Q4: 上传文件失败怎么办？ • 检查文件格式是否在支持列表中 • 大文件建议先压缩拆分 • 持续失败请检查网络连接 Q5: 如何更新 WorkBuddy？ WorkBuddy 支持自动更新。有新版本时启动会自动检测并提示升级。也可以从官网重新下载最新安装包覆盖安装。 Q6: WorkBuddy 和 CodeBuddy IDE/CLI 的关系？ 三者同属腾讯云 CodeBuddy 产品矩阵： 1CodeBuddy IDE：面向开发者的 AI 编程 IDE 1CodeBuddy CLI：命令行 AI 编程助手 1WorkBuddy：面向全场景办公的 AI 桌面工作台（本文主角） Q7: 如何最大化利用 WorkBuddy？ 🚀 高效使用技巧 1.设定「北极星目标」：告诉 WorkBuddy 你的长期目标和偏好，它会越来越懂你 2.建立每日工作流：养成每日用 WorkBuddy 整理日程、生成周报的习惯 3.善用连接器：连接邮箱、文档、日历，让 AI 跨平台协作 4.经验沉淀：将好的工作流存为 Skills，变成可复用的"第二大脑" 5.多任务并行：同时发起多个任务，充分利用 AI 并行处理能力
把这一章真正跑一遍
下面这条任务可以直接放进 WorkBuddy。先用脱敏副本练习，确认无误后再替换成正式材料。
请不要操作系统设置。只告诉我当前客户端可见的版本信息、工作空间状态和创建练习任务前还缺少什么；不确定的地方明确写“未确认”。
本章完成后，应留下这些结果：
- 安装完成记录 已生成、能打开，关键内容能回到输入材料。
- 版本记录 已生成、能打开，关键内容能回到输入材料。
最后再看一遍实际文件和变更记录。删除、覆盖、外发、发布、付款、审批和生产写入继续由有权限的人确认。遇到材料冲突、权限不足或外部状态不确定，让任务停下并列出待处理问题。