WorkBuddy 安装部署完全指南

🐉 腾讯出品 📦 零部署门槛 ⚡ 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/品牌设计、营销海报、社交媒体配图

文件自动化：批量重命名、分类归档、桌面整理、格式转换，一条指令全搞定

二、系统要求

项目	最低要求	推荐配置
操作系统	Windows 10 (64位) / macOS 12	Windows 11 / macOS 14+
CPU 架构	x64 / arm64 (Apple Silicon 原生支持)	Apple M 系列 / Intel 12代+
存储空间	≥ 200 MB	≥ 500 MB（含任务缓存）
安装包大小	约 150–180 MB
网络	需要网络连接以调用 AI 模型服务（首次登录需联网激活）
账号	需注册并登录 WorkBuddy 账号（支持微信扫码 / 腾讯云账号）

💡 提示

WorkBuddy 是真正的免部署、零代码桌面应用——无需安装 Node.js、Python 或任何运行时环境，双击即用。完全兼容 OpenClaw 技能生态，现有 Skills 和工作流无需修改即可无缝迁移。

三、下载与安装

⚠️ 重要提醒

请务必从官方唯一地址下载安装包：https://www.codebuddy.cn/work/。切勿从第三方平台下载，避免安装包被篡改或捆绑恶意软件。

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 支持微信扫码登录和腾讯云账号登录。推荐使用微信扫码，速度最快。

完成手机验证

微信扫码后，系统会要求进行手机号验证，确保账号安全。输入验证码即可完成登录。

登录成功

登录后系统自动完成授权，无需额外配置 API Key。新用户首次登录赠送 5000 Credits 体验额度。

五、授权文件访问权限

WorkBuddy 需要读取和修改本地文件才能帮你"干活"。首次使用时会引导你授权文件访问权限。

选择授权目录

根据引导，选择需要 WorkBuddy 操作的本地文件夹。常见选择包括：桌面、下载、文档 (Documents) 等。

确认授权范围

WorkBuddy 只能访问你主动勾选授权的文件夹，系统敏感目录（如系统盘核心目录）自动拦截，无法访问。

随时可调整

在设置中可随时增减授权目录范围，灵活控制。

🔒 数据安全承诺

所有文件处理默认在本地完成，原始数据不上传云端。服务端仅处理数据片段，用后即弃，不保存也不用于模型训练。高危操作（如批量删除）需二次确认方可执行。

六、界面概览

▲ 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 需要付费吗？

WorkBuddy 新用户首次登录赠送 5000 Credits 体验额度。后续按使用量计费，具体参考官方定价页面。

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 并行处理能力