从入门到精通！保姆级教程带你快速掌握WorkBuddy（一）

一、全文速览图

本文经公众号：腾讯技术工程（ID：Tencent_TEG）授权转载，如需转载请联系出处。

这是一份 WorkBuddy 的「从入门到精通」完整指南，从下载安装到基础使用，再到进阶玩法与效率技巧，3 万字带你一步步摸清 WorkBuddy 的核心能力。无论你是第一次接触，还是已经用过一段时间、想进一步解锁更多玩法，都可以在这里找到答案。

温馨提示：WorkBuddy 仍在持续迭代中，本文部分章节及操作界面可能会随产品功能更新有所调整，具体功能及使用方式请以 WorkBuddy 最新版本为准。

接下来，就从安装 WorkBuddy 开始。

二、安装WorkBuddy

1.Windows 安装

下载

首先安装WorkBuddy，点击登录网址https://www.codebuddy.cn/work/，选择WorkBuddy，点击立即下载WorkBuddy。

安装

下载之后，双击安装。

点击我同意此协议。

点击完成。

登录（用户）

点击登录。

选择微信登录。

扫码登录。

登录之后，在头像处点击，选择语言，可以切换语言：

更新

单击头像，单击检查更新。

这个表示是最新版本，没有的话它会自动下载安装更新。

2.Mac 安装

下载

访问WorkBuddy官网：WorkBuddy - AI Agent 办公新范式

点击“下载WorkBuddy”，电脑搭载M系列处理器（M1，M2或以上版本）选择“Mac ARM64”，老款英特尔处理器选择“Mac X64”。

允许下载。

安装

双击浏览器下载内容或访达-下载目录下的WorkBuddy安装包，打开安装程序。

拖动图标至Applications

等待安装。

“推出”WorkBuddy安装程序，清理桌面。

登录（用户）

在程序坞启动软件，或使用Command+空格检索WorkBuddy启动。

启动界面如图，点击登陆按钮。

跳转网页登陆，阅读并勾选服务条款和隐私协议，微信扫码即可登陆，若电脑已登陆微信可选微信快捷登陆。

登陆成功后返回WorkBuddy即可开始使用。

更新

点击左下角个人中心，选择检查更新即可检查是否有新版本，并且更新。

三、功能篇

你可能用过 ChatGPT 等 AI 聊天工具——你问它一个问题，它给你一段回答，然后就没有然后了，剩下的事还得你自己动手。

WorkBuddy 不一样，它不只是跟你聊天，而是真的能动手帮你做事，它可以直接读取你电脑上的文件，理解里面的内容，然后按你的要求去操作——整理文件夹、生成报告、制作 PPT、分析数据、批量处理表格，甚至帮你写代码、搭建网站。

你只需要用一句普通话告诉它你想做什么，它就会像一个坐在你旁边的同事一样，自己规划步骤、自己动手执行，最后把做好的成果交给你。

这里是一个 All in One 的 AI 工作台

1.新建任务栏：本地日常 AI 工作台

在新建任务中可以看到左侧是我们的功能区，右侧对话框是我们的产品功能

页面介绍

选择适合你的工作模式

WorkBuddy 提供了三种工作模式，对应不同的"放权程度"。

你可以把 WorkBuddy 想象成你新招来的一个助手，这三种模式就是你给他划定的权限范——是只让他回答问题，还是让他直接上手帮你干活，又或者让他先出个方案你审批后再动手。

问一问（Ask 模式）

在这个模式下，WorkBuddy 只能看你的文件、回答你的问题，不会对你电脑上的任何东西做修改。

比如你想问"这份合同里有没有提到违约金条款"、"帮我总结一下这个表格里的数据"，它会认真看完之后给你答复，但绝不会动你的文件。就像你问同事一个问题，他只会口头回答你，不会去翻你桌上的东西。

Ask 模式不会直接执行操作，仅作为对话聊天，适合先问清楚怎么做，再切换 Craft Agent 模式执行。

做一做（默认Craft 模式）

这个模式下，WorkBuddy 拥有最大的权限，可以直接帮你操作文件——整理文件夹、生成文档、做 PPT、处理表格，说一句话就帮你干完，最适合日常使用。

比如"帮我把桌面上这堆文件按月份分好类"、"根据这份数据做一个汇报用的PPT"，它就会自己动手完成。就像你把钥匙交给了助手，让他放手去干，效率最高，体验也最顺畅。建议在指定好工作文件夹、做好备份之后使用。

想一想（Plan 模式）

这个模式是 Craft Agent 模式的增强版。WorkBuddy 可以查看你的文件，但不会直接修改，而是先给你写一份详细的执行计划——打算分几步做、每一步做什么、会动到哪些文件。

等你看过计划觉得没问题了，再让它去执行。就像装修房子之前先看设计图纸，你点头了师傅才开工。适合任务比较复杂、或者你希望对过程有更多掌控的时候使用。

新手建议：刚开始使用可以先从"Ask"模式入手，熟悉之后再切换到"Plan"或"Craft"，逐步放开权限。重要文件记得提前备份，用起来更安心。

切换模型

WorkBuddy 内置了多个主流 AI 大模型，你可以根据手头的任务随时切换。

这就像你手边有好几支不同的笔——签字笔写得正式、彩笔画得好看、铅笔方便修改——你可以根据需要随时换一支，也可以让 WorkBuddy 帮你挑。

下面简单介绍几个可选的模型，帮你在需要的时候做出选择：

MiniMax M2.5

擅长处理办公类任务，比如整理 Excel 表格、做数据分析、生成 PPT 等。如果你的日常工作主要和文档、表格打交道，选它比较合适。速度也很快，干活利索。

智谱 GLM-5

综合能力很强的一个模型，尤其擅长处理需要多步骤、长流程的复杂任务。比如你让 WorkBuddy 做一个完整的市场调研报告，需要先搜集资料、再分析整理、最后输出成文档，GLM-5 在这种"连环任务"上表现不错。

Kimi K2.5

最大的特点是"能看图"。你可以直接把截图、照片甚至录屏丢给它，它能看懂图里的内容并据此完成任务。比如你拍了一张纸质表格的照片，让它帮你录入成电子版，或者截图一个网页让它照着做一份类似的文档，Kimi 在这类"看图干活"的场景下很拿手。

DeepSeek V3.2

以性价比著称，日常对话、文案撰写、知识问答都很在行，响应速度快，消耗的额度也相对较少。如果你的任务不算特别复杂，用它既省钱又好使，是个实用的"万金油"选手。

设置工作目录

在开始使用 WorkBuddy 之前，有一个很重要的步骤：告诉它你要在哪个文件夹里干活。这就是"设置工作目录"。

打个比方，你请了一个助手到公司帮忙，你总得先告诉他："你的办公桌在这儿，要用的资料都在这个柜子里。"工作目录就是你给 WorkBuddy 指定的那个"柜子"——它默认会从这个文件夹里读取文件，生成的新文件也会放在这里面。

当然，如果你在对话中明确告诉它去别的地方找文件（比如"帮我把桌面上那个表格也拿过来处理一下"），它也能做到。但如果你什么都不说，它就只在这个文件夹里活动。

什么是文件路径？

这里需要解释一个概念：路径。路径就是一个文件或文件夹在你电脑里的"地址"，就像现实中的门牌号一样。

比如你在桌面上有一个叫"工作资料"的文件夹，它的路径大概长这样：

Windows 电脑：C:Users你的用户名Desktop工作资料

Mac 电脑：/Users/你的用户名/Desktop/工作资料

看起来有点复杂？不用担心，你完全不需要手动去拼这串地址。在 WorkBuddy 里设置工作目录时，你只需要点击选择按钮，然后像平时找文件一样，一层一层点进去，找到你想要的文件夹，选中它就行了。就跟你用微信发文件时选择文件是一样的操作。

如果图方便，不需要在特定文件夹下工作，直接点击新建任务，WorkBuddy 也会在每一个任务开始的时候新建一个文件夹来作为默认工作环境，实现和其他文件隔离。

怎么选一个合适的工作目录？

建议你为每一类任务单独建一个文件夹。比如：

要整理发票 → 建一个"发票整理"文件夹，把发票都丢进去，然后把它设为工作目录；

要写周报 → 建一个"周报"文件夹，把相关素材放进去；

要处理一批照片 → 建一个"待处理照片"文件夹；

或者偷懒，让 WorkBuddy 帮你创建和整理文件夹。

这样做的好处是：WorkBuddy 不会误碰到你其他的文件，你的东西井井有条，万一出了问题也只影响这一个文件夹。

选择技能

WorkBuddy 刚装好的时候，它已经能帮你做不少事了——写文档、整理文件、回答问题。但就像一个新员工，虽然脑子聪明，手边的工具还不够多。技能（Skills） 就是给它"配装备"的。

打个比方：WorkBuddy 本身是一个聪明的大脑，但光有大脑还不够。你想让它做海报，就给它装一个"海报设计"的技能；想让它做 PPT，就装一个"PPT制作"的技能；想让它帮你上网查资料，就装一个"联网搜索"的技能。每装一个技能，它就多长出一双"手"，能多干一类活。

怎么使用技能？

在对话框里，你可以直接选择想要启用的已安装的技能。选中之后，WorkBuddy 在执行任务时就会调用对应的技能来完成工作。

比如：

你选了"PPT 制作"技能，然后说"帮我把这份销售数据做成一个汇报 PPT"——它就能直接生成一份排版好的演示文稿。

你选了"海报生成"技能，然后说"帮我做一张中秋节活动海报"——它就能帮你设计出来。

你选了"自动化报表"技能，然后说"把这几张 Excel 表合并，生成一份图表报告"——它就能一步到位。

WorkBuddy 目前内置了超过 20 种技能包，覆盖了文档处理、数据报表、海报设计、文件整理等常见办公场景，而且完全兼容 OpenClaw 社区的上万个技能，可以按需导入。你也可以自己创建新技能，不需要写代码，用自然语言描述就行。

一句话总结：WorkBuddy 本身是大脑，Skills 是它的工具箱。你根据要干的活，往工具箱里放对应的工具，它就能帮你把活干了。工具越多，它能做的事就越多。

新建任务

在 WorkBuddy 里，每一个对话就是一个"任务"。你可以把任务理解为一条独立的工作线——每条线上有一个 AI 助手在帮你处理一件事，它们之间互不打扰。

打个比方：你去银行办事，只开一个窗口的话，必须排队等一件事办完才能办下一件。

但如果同时开了好几个窗口，你就可以一边在 1 号窗口办转账，一边在 2 号窗口办信用卡，一边在 3 号窗口打流水。

WorkBuddy 的多任务就是这个意思——你可以同时开好几个"窗口"，让 AI 同时帮你做不同的事。

而且，每个任务都有自己独立的工作空间。1 号任务在处理你的财务报表，2 号任务在帮你写方案，3 号任务在整理文件夹——它们各干各的，不会互相影响，也不会把文件搞混。

如何新建任务？操作很简单：在 WorkBuddy 的主界面，点击"新建任务"，就可以新建一个任务了。若未指定文件夹，则默认为你创一个Claw 的工作目录。

在输入框输入你想让 AI 做的事，选好工作目录和模型，按回车发送就行了，一个新的任务就跑起来了。这时候你不用等它做完，可以再点"新建任务"，开第二个、第三个任务，让它们同时干活。

所有正在运行的任务都会显示在左侧的侧边栏里，就像手机上的聊天列表一样，你可以随时点击切换，查看每个任务的进度和结果。

一句话总结：一个任务就是一个独立的 AI 工作台。多开几个任务，就像同时请了好几个助手，各干各的，互不打扰。WorkBuddy 就是你的 All-in-One 工作平台——编程、写文档、做报表、整理文件，全都可以在一个软件里同时进行。

2.助理页面：远程遥控的"监控室"

简单来说，Claw 页面是专门服务于远程遥控场景的，你可以通过手机远程给龙虾发指令，它在本地接收指令并执行，然后你可以在本地查看执行结果。

助理页面是什么？

前面我们提到，WorkBuddy 可以通过微信、企业微信、QQ、飞书、钉钉等手机上的聊天工具远程下达指令。

你在手机上给"龙虾"发一条消息，它就会在你的电脑上自动干活。

那问题来了：你人不在电脑旁，怎么知道龙虾干得怎么样了？
这就是助理页面的用途。

它就像一个"监控室"，你回到电脑前打开这个页面，就能看到龙虾在远程工作时的完整记录：它是怎么思考的、做了哪些操作、生成了什么文件、最终结果是什么，一目了然。

点击“助理”后的文件夹图案，可以看到其工作目录

和普通任务有什么不同？

助理页面虽然看起来也像一个对话窗口，但它有几点和普通任务不一样：

工作目录是固定的：它默认使用一个叫 "Claw" 的专属文件夹作为工作空间，不能像普通任务那样自由指定目录。

不能新建对话：普通任务可以随时在当前工作空间下开新的，助理页面只有这一个，所有远程指令都在这里进行，也无法并行开多个任务。

没办法清空上下文：普通任务可以清除之前的对话记录重新开始，助理页面不行，它会保留完整的对话历史。

建议：如果你人就在电脑前，想让 AI 帮你干活，还是直接在主界面新建任务更方便——可以自由选择工作目录，开多个任务，随时清空重来。Claw 页面更适合"人在外面，活在电脑上"的远程办公场景。

如何配置助理远程连接

点击左下角个人中心中的“设置”。

选择“助理设置”，后续可以配置企业微信集成、企微AIBot集成、微信客服号集成等等功能，具体配置方法详见下文。

接入QQ

点击“QQ机器人集成”的配置按钮

方案一：扫码绑定

选择“扫码绑定”，使用手机QQ扫描二维码

手机界面出现确认连接界面。

1. 若存在机器人，可直接点击连接。
2. 若不存在机器人，点击创建新机器人，选中创建的机器人，点击连接，点击同意，则连接成功。

方案二：WebSocket长连接

1.登录 QQ 开放平台

通过以下链接访问QQ开放平台。QQ开放平台

使用QQ或者邮箱方式登录QQ开放平台。

若之前没有使用过QQ开放平台，请点击立即注册并注册账号。

按照要求填写邮箱地址，设置登录密码，并完成实名认证后，完成账号注册。

2.配置超级管理员、主体及认证信息

设置超级管理员。

填写相关信息，可为自己或他人设置超级管理员。

填写主体信息。

包括企业、个体户、个人，请根据实际情况按需选择。

下图以个人为主体为例，表单填写完成后点击继续。

信息审核成功且通过人脸识别后，即可入驻 QQ 开放平台。

3.创建 QQ 机器人

打开https://q.qq.com/#/网站，扫码登录。

选择类型进行创建资源，选择机器人后，点击创建QQ机器人。

然后点击创建机器人，即可完成创建。

可以修改机器人的名称，头像及介绍，点击确认即可。

提交后，可以看到修改后的机器人。

4.获取 AppID 和 AppSecret 信息进行连接

复制AppID、查看 AppSecret 并复制。

注意：当第二次复制 AppSecret 时需要重置。

在 WorkBuddy 中填写刚刚获得的 AppID、AppSecret。

此处选择 Web Socket 长连接，配置简单，连接稳定。

点击注册即可开始使用

方案三：使用URL回调

1.选择“使用URL回调”，复制粘贴获得的 AppID、AppSecret，点击注册

2.从“助理设置”中获得QQ集成的 Webhook

返回WorkBuddy复制得到的 Webhook。

3. 在QQ 开发平台配置回调地址

点击机器人后台https://q.qq.com/#/apps?tab=1，选择需要配置的机器人，点击高级设置（⚠️注意如有多个机器人，请选择对应的机器人配置Webhook）。

在回调配置请求地址，粘贴复制上述 Webhook，保存此WebHook。
https://q.qq.com/qqbot/#/developer/webhook-setting

注意由于 Claw 中默认带有https ，粘贴的地址需要去掉 https:// 后进行复制到请求地址中。

确认配置 WebHooks 回调地址。

在回调配置栏添加所有单聊权限。

4.开始使用 WorkBuddy Claw

完成配置后， QQ 扫码进行聊天https://q.qq.com/qqbot/openclaw/index.html

首先点击沙箱配置后，点击在消息列表配置处的二维码。

回到 QQ 中与 WorkBuddy 互动，发送一个需求。

实时执行效果预览。

接入元宝

方案一：扫码接入

在“助理设置”中找到元宝扫码绑定

打开手机“元宝”APP，选择“我们”，点击“我的Bot”。

选择“关联已有OpenClaw”，点击“扫描二维码”，扫描桌面端二维码即可

手机端需点击“授权关联元宝”，即可连接成功

方案二：配置集成

在“助理设置”中找到“元宝机器人集成”，点击右侧的“配置”按钮

打开手机“元宝”APP，选择“我们”，点击“我的Bot”。

选择“关联已有OpenClaw”，在这里可以看到App Id和App Secret

回到桌面端，中对应位置输入App Id和App Secret，点击注册

连接成功

到这里，WorkBuddy 最基础的使用框架已经搭起来了。

你已经知道怎么安装、怎么新建任务、怎么选模式和模型，也跑通了 QQ、元宝这些远程入口。

但如果真想把它变成一个随时能用的远程办公助手，光做到这里还不够。

接下来第二篇，我们继续把企业微信、微信客服号和微信小程序接进来，并进一步看看 WorkBuddy 怎么做项目协作、任务管理，以及查看 AI 最终交付的成果。