WorkBuddy安装与通讯软件接入教程

WorkBuddy

安装与通讯软件接入教程

一站式配置指南

涵盖 Windows · macOS 安装，以及微信、企业微信、QQ、飞书、钉钉接入

版本：v1.0|更新时间：2026 年 3 月

腾讯云 CodeBuddy · WorkBuddy 产品组

第一章WorkBuddy 产品简介

WorkBuddy 是腾讯推出的全场景职场 AI 智能体桌面工作台，面向各类职能角色设计。它不仅能与您对话，还能真正理解您的意图、自主规划步骤、操作本地文件，并交付可验收的任务结果。

1.1 核心能力

•理解自然语言：用一句话下达任务，无需学习复杂操作步骤

•自主规划执行：自动拆解任务、规划步骤并执行操作

•多模态任务处理：支持文档、表格、PPT、数据分析等多种任务类型

•本地文件操作：可读取授权的电脑文件夹，进行批量处理

•多平台接入：支持微信、企业微信、QQ、飞书、钉钉等通讯软件

1.2 适用场景

•文档、报告、周报、邮件的自动生成

•数据分析、表格处理与可视化

•PPT 演示文稿制作

•本地文件的批量处理与管理

•通过手机通讯软件远程操控电脑执行任务

1.3 与传统 AI 对话的区别

常见问题	解决方案
功能维度	WorkBuddy vs 传统 AI
任务执行	WorkBuddy 可自主执行，传统 AI 仅给出建议
文件操作	WorkBuddy 可读写本地文件，传统 AI 无法操作
远程控制	WorkBuddy 支持通讯软件远程指令，传统 AI 不支持
结果交付	WorkBuddy 直接生成文档/表格等产物，传统 AI 只生成文字

第二章安装指南

WorkBuddy 提供 Windows 和 macOS 两个版本，均支持一键安装，过程简洁高效。以下分别介绍两个平台的详细安装步骤。

2.1 下载 WorkBuddy

请访问 WorkBuddy 官方下载页面，根据您的操作系统选择对应的安装包：

官网地址：https://www.codebuddy.cn/work/

💡 提示：建议从官网下载最新版本，以确保获得最新功能与安全修复。

2.2 Windows 系统安装

适用于 Windows 10 / Windows 11 64 位系统。

步骤 1	访问官网 https://www.codebuddy.cn/work/，点击「Windows 版下载」按钮，下载 .exe 安装包到本地。
步骤 2	双击下载好的 .exe 安装文件，启动安装程序（如出现安全提示，点击「仍要运行」）。
步骤 3	阅读并接受用户许可协议，选择安装路径（建议保持默认路径，如 C:\Program Files\WorkBuddy），点击「下一步」。
步骤 4	等待安装进度条完成（约 1-3 分钟），完成后点击「启动 WorkBuddy」。
步骤 5	首次启动时，根据系统提示授予必要权限（文件访问、辅助功能等），这些权限是 WorkBuddy 执行本地任务所必需的。
步骤 6	使用腾讯云账号登录（可选择微信扫码登录或账号密码登录），注册新用户可获赠 5000 积分。
步骤 7	完成基础配置向导，WorkBuddy 安装完毕，可以开始使用。

💡 提示：Windows 安装过程无需任何编程知识，对电脑不熟悉的用户也可轻松完成。

2.3 macOS 系统安装

适用于 macOS 12 Monterey 及以上版本（支持 Intel 与 Apple Silicon 芯片）。

步骤 1	访问官网 https://www.codebuddy.cn/work/，点击「macOS 版下载」按钮，下载 .dmg 磁盘镜像文件。
步骤 2	下载完成后，双击 .dmg 文件，系统会挂载该磁盘镜像并弹出安装窗口。
步骤 3	在弹出的安装窗口中，将 WorkBuddy 图标拖拽到右侧「应用程序（Applications）」文件夹图标上。
步骤 4	等待复制完成后，前往「Launchpad」或「访达 > 应用程序」文件夹，找到并双击 WorkBuddy 启动。
步骤 5	首次打开时，macOS 会弹出安全提示「无法验证开发者」，请前往「系统偏好设置 > 安全性与隐私 > 通用」，点击「仍要打开」。
步骤 6	根据系统提示，在「系统偏好设置 > 隐私与安全性」中为 WorkBuddy 授予必要权限（辅助功能、屏幕录制、文件访问等）。
步骤 7	使用腾讯云账号登录，完成基础配置向导，安装完毕。

⚠️ 注意：macOS 14 Sonoma 及以上版本，首次运行需在「系统设置 > 隐私与安全性 > 辅助功能」中手动添加 WorkBuddy 权限，否则部分功能可能无法正常使用。

2.4 首次登录与配置

完成安装并启动 WorkBuddy 后，您需要完成以下初始配置：

1.使用腾讯云账号登录，新用户可通过微信扫码快速注册并登录

2.选择您的 AI 模型偏好（支持 MiniMax、Kimi、DeepSeek、GLM 等国内主流大模型）

3.根据引导授权本地文件夹访问权限（可在设置中随时调整）

4.（可选）完成技能包安装，获得更丰富的办公自动化功能

💡 提示：WorkBuddy 内置 Claw（小龙虾）智能体引擎，初始化完成后即可开始通过自然语言执行任务。

第三章接入通讯软件

WorkBuddy 支持将您的手机通讯软件作为远程指令入口，无论您身在何处，只需通过熟悉的聊天软件发送一条消息，WorkBuddy 即可在您的电脑上自动执行相应任务并返回结果。

目前 WorkBuddy 支持以下通讯平台接入：

•微信（通过 ClawBot 插件，推荐，最为简便）

•企业微信（适合企业用户，通过 API 机器人接入）

•QQ（通过 QQ 开放平台机器人接入）

•飞书（通过飞书开放平台自建应用接入）

•钉钉（通过钉钉开发者平台自建应用接入）

💡 提示：微信 ClawBot 方式无需开发凭证，扫码即可绑定，最为推荐。其他平台需要在各自的开放平台上创建应用并获取相关凭证。

3.1 接入微信（ClawBot 方式，推荐）

微信 ClawBot 是微信官方推出的 AI 插件体系，WorkBuddy 已第一时间完成适配。只需用手机微信扫描一次二维码，即可完成绑定，无需任何开发技能。

3.1.1 前提条件

•电脑已安装并运行 WorkBuddy 4.6.4 或以上版本

•手机微信版本 8.0 或以上

•确保电脑网络连接正常

3.1.2 绑定步骤

步骤 1	打开电脑端 WorkBuddy，在左侧导航栏找到 CLAW 标签，点击右上角的「齿轮」图标，进入「CLAW 设置」。
步骤 2	在集成列表中找到「微信 ClawBot 集成」选项，点击右侧的「配置」按钮。
步骤 3	界面上会显示一个二维码，状态显示为「绑定中…」，请勿关闭此窗口。
步骤 4	拿出您的手机，打开微信，点击右上角「+」号，选择「扫一扫」，扫描界面上的二维码。
步骤 5	微信弹出确认页面后，点击「确认授权」。绑定成功后，WorkBuddy 界面上的状态会变为「已绑定」。
步骤 6	此后在微信中直接向 WorkBuddy 发送任务指令，电脑端会自动执行并将结果回复到微信对话中。

3.1.3 使用示例

绑定成功后，您可以在微信聊天中输入：

•「帮我总结桌面上的 report.docx 里的关键信息」

•「将下载文件夹中所有 xlsx 文件合并成一份并发我」

•「帮我写一封给客户的跟进邮件」

3.1.4 常见问题

常见问题	解决方案
二维码一直显示「绑定中」	检查 WorkBuddy 是否正常运行，网络是否连接，或点击「重试」重新生成二维码
扫码后状态未变为「已绑定」	确认微信账号已完成授权，若无反应可退出重试
微信消息发送后无响应	确认 WorkBuddy 在后台运行，集成状态为「已绑定」；必要时重新绑定
二维码过期	二维码有时效性，点击「重试」或「刷新」重新生成即可

3.2 接入企业微信

企业微信接入方式适合有企业账号的用户，通过创建 AI 机器人实现远程控制 WorkBuddy，支持企业内多人共享使用。

3.2.1 前提条件

•电脑已安装并运行 WorkBuddy，且已开启 Claw 远程控制功能

•拥有企业微信管理员权限账号（个人用户可在企业微信 App 中创建「个人团队」获取管理员权限）

3.2.2 配置步骤

步骤 1	打开浏览器，访问企业微信管理后台 https://work.weixin.qq.com/，使用管理员账号登录。
步骤 2	在左侧菜单中依次点击「安全与管理」→「管理工具」→「智能机器人」，点击「创建机器人」。
步骤 3	在创建页面点击「API 模式创建」，选择「URL 回调模式」。填写机器人名称（如 WorkBuddy 助手）并设置可见范围。
步骤 4	点击「随机获取」生成 Token 和 EncodingAESKey，请立即复制并妥善保存这两个参数，后续需要填入 WorkBuddy。
步骤 5	打开电脑端 WorkBuddy，点击 Claw 设置 → 选择「企微 AIBot 集成」，将上一步的 Token 和 EncodingAESKey 分别填入对应输入框。
步骤 6	点击「注册」按钮，WorkBuddy 会生成一个 Webhook URL，复制该地址。
步骤 7	回到企业微信后台机器人创建页面，在「URL」输入框中粘贴刚才复制的 Webhook 地址，点击「保存」完成配置。
步骤 8	在企业微信聊天中找到 WorkBuddy 机器人，发送一条测试指令，验证是否能正常响应。

⚠️ 注意：请妥善保存 Token 和 EncodingAESKey，丢失后需要重新生成，之前的配置将失效。

3.2.3 常见问题

常见问题	解决方案
机器人无响应	检查 WorkBuddy 是否在运行，Claw 服务是否开启，以及 Token/Key 是否填写正确
URL 验证失败	确认 WorkBuddy 已启动，Webhook URL 完整无误，重新复制粘贴后重试
管理员权限不足	个人用户可在企业微信 App 首页点击「+」创建「个人团队」获取管理员权限

3.3 接入 QQ

QQ 接入通过 QQ 开放平台的机器人功能实现，配置后即可在 QQ 中远程控制 WorkBuddy。

3.3.1 配置步骤

步骤 1	访问 QQ 开放平台（https://q.qq.com/），使用 QQ 账号登录并完成开发者入驻认证。
步骤 2	在开发者控制台中创建一个 QQ 机器人，填写机器人名称、头像和描述信息，提交审核（审核通常需要 1-3 个工作日）。
步骤 3	审核通过后，进入机器人管理页，获取并记录「AppID」和「AppSecret」这两个凭证。
步骤 4	打开 WorkBuddy，进入 Claw 设置 → QQ 集成，将 AppID 和 AppSecret 填入对应输入框，点击「注册」。
步骤 5	系统生成 Webhook 地址后，复制该地址（注意去掉 https:// 前缀）。
步骤 6	在 QQ 开放平台的「Webhook 设置」中粘贴处理后的地址，同时开启「单聊消息」权限。
步骤 7	扫码绑定测试账号，在 QQ 中与机器人对话验证连接是否正常。

💡 提示：QQ 机器人需经过官方审核，请提前几天申请，避免影响使用计划。

3.4 接入飞书

飞书接入通过飞书开放平台创建企业自建应用，适合企业内部或团队协作场景。

3.4.1 配置步骤

步骤 1	访问飞书开放平台（https://open.feishu.cn/），登录后点击「创建应用」，选择「企业自建应用」。填写应用名称、描述和图标。
步骤 2	进入应用详情页，找到「应用能力」区域，点击「机器人」并启用该能力。
步骤 3	前往「权限管理」，批量导入 WorkBuddy 要求的权限列表（可在 WorkBuddy 飞书集成配置页查看所需权限清单）。
步骤 4	在「凭证与基础信息」页面，获取并记录「App ID」和「App Secret」。
步骤 5	打开 WorkBuddy，进入 Claw 设置 → 飞书集成，填入 App ID 和 App Secret，点击「注册」并复制生成的 Webhook 地址。
步骤 6	回到飞书后台，进入「事件与回调」，粘贴 Webhook 地址，并订阅「接收消息」和「卡片回传交互」两个事件。
步骤 7	创建应用版本并发布，审核通过后即可在飞书中使用 WorkBuddy 机器人。

💡 提示：飞书自建应用审核通常较快，一般在工作时间内 1-2 小时内完成。

3.5 接入钉钉

钉钉接入通过钉钉开发者平台创建应用，支持在群聊或单聊中使用 WorkBuddy 机器人。

3.5.1 配置步骤

步骤 1	访问钉钉开发者平台（https://open.dingtalk.com/），登录后点击「应用管理」→「创建应用」，填写应用名称、描述等信息。
步骤 2	进入应用详情，找到「应用能力」→「机器人」，启用机器人能力，填写机器人基本信息并点击「发布」。
步骤 3	前往「权限管理」，开通以下三项权限：Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg。
步骤 4	在「凭证与基础信息」页面，获取并记录「Client ID」和「Client Secret」。
步骤 5	打开 WorkBuddy，进入 Claw 设置 → 钉钉集成，填入 Client ID 和 Client Secret，点击「注册」并复制 Webhook 地址。
步骤 6	回到钉钉机器人设置，进入「消息接收配置」，将模式切换为「HTTP 模式」，粘贴 Webhook 地址（注意将 http 改为 https）。
步骤 7	创建应用版本并提交审核，审核通过后即可在钉钉群聊或单聊中使用 WorkBuddy。

⚠️ 注意：钉钉应用审核可能需要 1-3 个工作日，若用于生产环境请提前申请。

第四章各平台接入方式对比

不同通讯平台在接入难度、配置复杂度和适用场景上有所不同，请根据自身需求选择合适的方式。

平台	配置难度	是否需要审核	是否需要开发凭证	适用场景
微信 ClawBot	⭐ 极简	否	否（仅扫码）	个人用户首选，手机直接控制电脑
企业微信	⭐⭐ 简单	否	是（Token/Key）	企业团队协作，内部多人共享
QQ	⭐⭐⭐ 中等	是（1-3天）	是（AppID/Secret）	QQ 重度用户，社群场景
飞书	⭐⭐⭐ 中等	是（较快）	是（AppID/Secret）	飞书企业用户，文档协作场景
钉钉	⭐⭐⭐ 中等	是（1-3天）	是（ClientID/Secret）	钉钉企业用户，工作流场景

💡 提示：建议普通用户优先使用微信 ClawBot 方式，企业用户可根据内部使用的协作工具选择对应平台。

第五章常见问题汇总

5.1 安装相关问题

常见问题	解决方案
Windows 提示「此应用来自未知发布者」	点击「更多信息」→「仍要运行」即可，这是 Windows SmartScreen 的安全提示。
macOS 提示「无法验证开发者」	前往「系统偏好设置 > 安全性与隐私」，点击「仍要打开」即可。
安装后应用无法启动	尝试以管理员身份运行（右键 > 以管理员身份运行），或重新下载安装包。
登录时提示账号未注册	访问 https://www.codebuddy.cn/ 注册腾讯云账号，或通过微信扫码直接注册。
权限授予后功能仍不正常	重启 WorkBuddy 应用，或在系统设置中删除权限记录后重新授权。

5.2 通讯软件接入相关问题

常见问题	解决方案
绑定成功但无法收到响应	检查 WorkBuddy 是否在后台保持运行，必要时关闭自动睡眠功能。
Webhook URL 失效	重新打开 WorkBuddy 集成设置，点击「注册」重新生成，并更新到各平台后台。
Token 或 Secret 配置后验证失败	确认复制时没有多余空格，检查是否混淆了不同平台的凭证。
机器人响应很慢	这取决于所选 AI 模型和任务复杂度，可在 WorkBuddy 设置中切换更快的模型。
如何同时使用多个平台	WorkBuddy 支持同时配置多个平台集成，各平台互不影响，可在设置中分别管理。

第六章使用技巧与进阶

6.1 如何写出高质量的任务指令

WorkBuddy 支持自然语言输入，以下技巧可以帮助您获得更好的任务执行结果：

•明确文件位置：提供具体路径，如「桌面上的 report.docx」

•描述期望结果：「请生成一份 Word 格式的报告，包含标题和三个章节」

•分步描述复杂任务：将大任务拆解为多个清晰步骤逐一发送

•补充背景信息：告诉 WorkBuddy 这份文件的用途和目标受众

6.2 文件授权管理

WorkBuddy 在执行文件相关任务时需要访问权限，您可以：

•在 WorkBuddy 设置 > 文件权限中管理已授权的文件夹

•随时撤销特定文件夹的访问权限

•建议只授权工作相关的文件夹，保护个人隐私

6.3 积分与模型选择

•新用户注册即获赠 5000 积分，可用于调用各 AI 模型

•可在设置中自由切换 MiniMax、Kimi、DeepSeek、GLM 等模型

•不同模型在速度、精度、擅长任务上各有侧重，可根据需求选择

6.4 获取帮助

•官方文档：https://www.codebuddy.cn/docs/workbuddy/Overview

•在 WorkBuddy 中直接发送问题，AI 助手可提供操作指导

•腾讯云开发者社区：https://cloud.tencent.com/developer

— 文档结束 —

如有疑问，请访问官方文档或联系腾讯云客服