夜雨聆风
🐉 腾讯出品 📦 零部署门槛 ⚡ 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 并行处理能力