WorkBuddy 从入门到精通：零基础新手完全教程

面向不懂编程的职场人。读完你将学会：搞清它和 Codex / Claude 的区别、装好、跑通第一个任务、把需求说清楚、修正错误，再用 Skill / 专家团 / 连接器 / 手机助理 / 自动化提效，最后沉淀成你自己的「AI 工作系统」。

一、WorkBuddy 是什么、不是什么

WorkBuddy 是腾讯云 CodeBuddy 团队推出的全场景 AI Agent 办公工作台。一句话区别：普通 AI 告诉你怎么做，WorkBuddy 直接在电脑上帮你做。 获得授权后，它能读取整理本地文件、处理 Word/Excel/PDF、生成报告和 PPT、联网搜集分析资料、调用 Skill 和连接器、组织多个专家协作、通过微信远程接单、定时执行重复工作——把任务从头做到交付，你只管验收。三个关键词：本地运行（装在自己电脑上，Windows/Mac）、自主执行（自己拆步骤、规划、交付）、数字同事（后台待命、定时干活）。它不是什么——三个合理预期，帮你少走弯路：

它不是永远正确。数字、事实和正式文件必须验收。
它不替你承担判断和责任。「报价多少」「方案选哪个」仍是你的决定，它负责把决策材料整理好。
它不是读心术。需求越模糊，结果越不稳定——所以第八节是全教程最重要的一节。

小知识：开发者圈把它戏称「国产小龙虾」，因为它和国外的 OpenClaw 定位相似，还兼容后者的 Skills 生态。

二、务实对比：跟 Codex、Claude 比，我该用哪个

三家不是谁强谁弱，而是出身不同：Codex 和 Claude 从代码世界长出来，WorkBuddy 从中国人的办公桌长出来。对小白，差别集中在四点：

一句话选择指南：

非技术岗、中文办公、腾讯系工具、想用手机远程派活 → WorkBuddy，几乎无门槛。
程序员、正式软件开发、复杂代码工程 → Codex 或 Claude Code 上限更高。
两者不互斥，重度用户的主流玩法是「混合工作流」：Claude/Codex 当大脑（复杂规划、写代码、长链路推理），WorkBuddy 当国内执行层（发邮件、写文档、出 PPT、同步企微）。已经用上 Codex/Claude 的人，几乎没人说 WorkBuddy 能全面替代它们——但也很少有人否认它在国内场景的补位价值。三个务实提醒：

别拿编程难题考验它。 有实测显示同一个复杂编程任务，Codex 五分钟搞定，WorkBuddy 反复修不好还耗光积分。它的主场是文档、表格、PPT、调研这类办公活。
超长任务成功率会明显下降。 几十步、跑一小时以上的任务，目前所有通用 Agent 都不可靠。大活拆小段验收是通用生存法则。
积分消耗比想象中快。 复杂任务一次可能烧几百积分，省钱诀窍见第十四节。

三、学习主线：从一个任务到一支 AI 团队

别一上来研究所有按钮。更有效的路径是：完成一个任务 → 复盘成功方法 → 固化为模板或 Skill → 设置自动化 → 组合成 AI 团队真正的精通不是「会用很多功能」，而是同一类任务能稳定重复完成**。一次成功，不该只发生一次。**

四、它能替你干什么

判断标准：凡是「重复、繁琐、步骤明确、结果容易检查」的电脑活儿，都先问问它。它特别顺手的是腾讯生态一条龙：读取腾讯会议纪要 → 在腾讯文档生成行动表 → 通过企微催办。这是它相对 Codex/Claude 的独家优势。

重度用户的真实用法（值得抄的作业）

上面是官方场景，更有参考价值的是我整理的社区里重度用户——包括早已在用 Codex/Claude 的人——实际拿它干什么：

生态 Skill 开箱即用，省掉自己搭管道。 有人用 Codex + SMTP 折腾半天给上百人发 QQ 邮件，被朋友一句点醒：「你咋不用 WorkBuddy？」——QQ 邮箱、腾讯文档、腾讯会议、公众号助手、企微、飞书这些 Skill 商店里都是现成的。本地杂乱文件批量清洗归类，再写入ima或飞书多维表格——本地文件权限 + 生态连接生态，已打通的场景，开箱即用的工具就是更高效。
「交付包」模式最出活。 老用户总结的高效套路不是聊概念，而是直接产出成套文件：Excel 经营分析包、会议纪要→待办表+汇报 PPT、客户方案包（Word+报价+PPT）。非技术的老板、销售、运营拿到就能验收，交付感最强。
团队协同是 Codex 给不了的。 多账号共享同一个项目、统一 Skill 标准，甚至团队成员共用老板订阅的高阶模型额度——Codex 偏个人工具，团队级协同正是 WorkBuddy 的差异化。
自媒体流水线。 用风格模仿类 Skill（如内置的公众号文风 Skill）配国产模型写稿，有实测称几乎看不出 AI 味；调研报告→结构化内容→多平台发布，国内平台的 Skill 更全，生成后直接能发。一句话：老用户的共识是「不是替代，是补位」——硬核代码和长链路推理留给 Codex/Claude，国内办公交付、腾讯生态任务、给非技术同事用的场景，WorkBuddy 开箱即用。

五、安装、工作空间与界面

安装

官网 workbuddy.cn 下载对应系统（Windows / Mac）客户端，安装登录即可。无需科学上网、无需配置环境。三个装机细节（老用户踩坑换来的）：

Windows 用户别装 C 盘。 它运行中会积累几个 GB 的缓存、日志和索引，C 盘被吃满后会报各种莫名其妙的错。安装路径和「工作空间」都手动指到 D 盘等数据盘。
装 Skill 前先开运行环境。 多数技能依赖 Node.js 等工具，去设置的「安全中心」把内置工具开关打开，否则装了技能也跑不起来、报「模块缺失」。
加入杀毒软件白名单。 它的自动化会模拟鼠标键盘，360/电脑管家可能误判拦截——表现为任务跑着跑着卡死。加白名单或跑自动化时暂停实时防护。

建一个专用工作空间（新手铁律）

首次使用它会让你授权本地文件夹。不要一上来就授权整个桌面或硬盘。 新建一个独立文件夹练手：

把要处理的文件复制进 input 再授权这个文件夹。工作空间既是项目范围，也是安全边界——出错不伤原件，隐私风险也最小。

认识界面

经典三栏布局：

关键意识：聊天里显示「完成」，不代表任务真正完成。 必须打开产物，检查内容、格式和文件变更。**

六、三种工作模式：问一问、做一做、想一想

WorkBuddy 常见三种模式（名称以客户端实际显示为准）：

记忆口诀：只想了解用 Ask，确定要做用 Craft，任务复杂用 Plan。拿不准时，优先 Plan。

默认模式是 Craft——你发的第一条消息，它就已经在直接执行了。有老用户让它「整理一下项目文件夹」，它按自己的理解把目录重组了一遍，文件都在，但找了半小时。新手阶段建议可以复杂任务调用 Plan 模式，看完执行计划再确认；「自动执行」开关更要慎开——开了之后遇到高风险操作它也不停下来问你。等摸清它的行为模式，再逐步放权。

**⚠️ **重要提醒：它现在其实还是有这三种模式，但是已经没有用户端的进入选项了，大家如果需要用plan模式的话，可以直接口头讲需要plan模式。现在官方也已经不强调这一点了，大家也可以忽略。

七、完成第一个任务

把一份会议记录放进 input，然后输入：

执行时观察：它读了哪些文件、准备做什么操作、有没有申请范围外权限。完成后检查：结论有没有原文依据、负责人和日期是否准确、有没有漏待办、原文件是否被动过。跑通这个闭环，你就入门了：选工作空间 → 说明需求 → 确认权限 → 观察执行 → 验收产物 → 提出修改

八、把需求说清楚：六要素指令法（附模板）

会不会用 WorkBuddy，90% 取决于你会不会说需求。一个完整任务要回答六个问题：

通用模板（复杂任务直接套）：

五个即用模板

文件整理（先方案后执行）

Excel 分析

PPT 制作

行业调研

会议纪要

每跑通一个任务，就把好用的指令存进自己的「模板库」——这是从入门到精通最便宜的投资。

九、结果不对怎么办

新手最容易在这里放弃：「做出来不是我要的，看来 AI 不行。」其实问题几乎都出在沟通上。原则：不满意就具体反馈，别推倒重来。 它记得上下文，指出问题让它改，比重开任务快得多。

推荐反馈格式（精确圈定修改范围，防止越改越乱）：

把「验收 → 反馈 → 修正」当成默认节奏，你会发现它的可用率远比第一印象高。

十、搞懂五个概念：Prompt、Skill、专家、专家团、连接器

进阶前先建立一张概念地图：

**记忆口诀：Prompt = 任务，Skill = 做法，专家 = 角色，专家团 = 团队，连接器 = 外部能力。什么时候用 Skill？ 同一套要求反复出现时：固定格式的会议纪要、每周项目报告、Excel 清洗流程、固定风格写作。好的 Skill 固定了输入范围、操作步骤、输出格式、质量标准和安全限制——每次只需说明具体对象。Skill 商店可一键安装，兼容 OpenClaw 生态；进阶玩法是把一本书、一门课「蒸馏」成自己的 Skill。装多少合适？ 两个极端都是坑：一个不装等于买了电脑不装软件；见一个装一个，装到一百多个之后想找某个技能得翻到崩溃。老用户的建议是——必装三样：浏览器操控（自动搜资料查数据）、办公四件套（Word/Excel/PPT/PDF）、联网搜索；其余按需再装，用到再去商店找完全来得及。什么时候用专家团？ 需要多角色协作的项目。比如做一套培训课程：调研专家收集资料、课程专家设计结构、写作专家产出内容、设计专家做视觉，团长拆解汇总。但不是 Agent 越多越好——普通任务一个 Agent 能干就别召集团队，角色越多，重复劳动和结果冲突越多。连接器怎么用？ 企微、腾讯文档、腾讯会议、QQ 邮箱等都有现成连接器，市场里一键安装；也支持 MCP 标准的其他服务。安装前检查五件事：来源是否可信、能读什么数据、有没有写入权限、用哪个账号执行、内容会不会发给外部服务。只装当前任务真正需要的。

十一、自动化：让它定时替你干活

「数字同事」真正的价值点：把重复的活儿设成定时自动执行，7×24 待命、主动产出。适合自动化的任务满足六个条件：会重复发生、输入来源稳定、执行步骤相似、结果容易检查、失败后可重试、权限范围可控。典型如：每日行业简报、每周项目周报、固定表格汇总、文件归档。**铁律：自动化之前，必须先手动跑通并验收过。自动化任务模板（注意「失败处理」和「禁止操作」两段，这是无人值守的保险绳）：

首次设置后必须检查：调度真的执行了吗、实际读了什么、生成了什么、存在哪里、会不会重复覆盖、失败时通不通知。**

十二、手机助理与办公平台接入

手机端：本机模式 vs 云端模式

WorkBuddy 小程序有两种执行方式（以客户端实际功能为准）：

手机只是入口，真正的执行环境取决于你选了本机还是云端。本机模式下电脑要保持开机联网、WorkBuddy 正常运行。

接入聊天软件

支持 微信、企业微信、飞书、钉钉、QQ。通用逻辑三步：对方平台建机器人 → 拿到凭证（ID/Secret）→ 填进 WorkBuddy 集成设置。难度从低到高：

建议先从微信练手，且绑定后第一条先发只读测试任务：

确认无误，再派真实任务。界面按钮名称可能随版本变化，以客户端实际显示为准。

十三、沉淀你的工作系统

回到学习主线的终点——真正的精通，是让好结果能被反复复用：

复盘成案例：记下输入资料、拆解方式、验收标准、哪些步骤必须人工确认。
固化成 Skill / 自动化：稳定的做法变成 Skill 或定时任务，下次一键触发。
用好记忆机制：个人偏好写进全局记忆、项目背景写进项目记忆，它越用越懂你，省去每次重复交代。设置里还有「自定义指令」可以定它的默认语气、输出格式和文件命名规则——注意改完要新建任务才生效，旧任务不会应用。
组建专家团：常配合的专家固定成团，面向你的岗位形成专属工作流。
团队协作：把项目的指令、连接器、专家、Skill 统一配置后拉同事进来，全团队共享一套 AI 工作流——这是它相对 Codex 的独有能力。
保证可靠性：自动化流程设好失败回退和人工确认节点，别让它无人监管地跑错。

十四、安全、省钱与避坑

文件与权限安全

最小授权：只授权必要文件夹，财务、隐私等敏感目录不开放；不随意开启「完全访问」。
先备份再批量：批量处理前复制原件；默认要求「不覆盖原文件」；删除前必须先列清单。
小样本试跑：新流程先拿几条数据验证，对了再上全量。
看清再放行：高危操作它会请求确认——看清楚再点同意。
不装来源不明的 Skill 和插件；凭证（Secret）等同密码，不外泄。

信息安全（容易被忽视的一条）

永远不要提供：账号密码、身份证件、银行卡信息、API 密钥、私钥/助记词、未脱敏的客户隐私、公司禁止外传的资料。并且要清楚：本地执行 ≠ 数据完全不出电脑。 模型推理、云端模式和第三方连接器都可能涉及数据传输。敏感任务先确认产品和公司的数据政策。

省钱五招

先搞懂计费逻辑：每发一条消息，系统会把整个对话历史重新打包发给模型——对话越长，每一轮越贵，而且模型还会被无关历史干扰、质量下降。省钱和提质是同一件事：

按任务选模型（老用户实测积分能省一半以上）：
Auto 模式不建议新手用——它的分配标准是黑盒，简单任务可能被派了贵模型，积分哗哗流走还容易卡。「长上下文」开关也别常开，只在复杂任务时打开。
一个任务一个窗口：写作、整理、分析各开各的任务栏，别在一个窗口里从早聊到晚。完成的任务及时右键归档。
上下文长了就重开：长任务到中期，把「最终确认的结论」整理成一段话，开新任务贴进去，从干净的上下文继续——又省积分又防跑偏。
免费积分应领尽领：每日签到礼包 + 新用户注册积分，加起来够跑不少日常小任务。
及时止损：发现它在同一个错误上循环，立刻停——空转最烧积分。

三个新手常踩的坑

任务偶尔报错或中断是目前的常态（产品还在快速迭代），重试或拆小通常能解决，别一次失败就弃用。
别指望它一口气跑完一小时的大活——拆小、分段验收。
编程类复杂需求不是它的主场，办公场景才是。用对地方，体验天差地别。

十五、学习清单与延伸资源

按顺序打勾，从小白走到精通：

入门：装好客户端，建 input/output/reference 专用工作空间

入门：用 Ask、Craft、Plan 三种模式各完成一次任务

入门：跑通第一个任务（会议纪要或文件整理），完整走一遍验收

基础：练熟六要素指令法，建起自己的模板库

基础：经历一次「反馈 → 修改 → 验收」的完整循环

基础：完成一个多阶段项目（数据 → 分析 → PPT）

进阶：安装一个真正需要的 Skill 和连接器

进阶：手动跑通一个重复流程，再设为自动化（带失败处理）

进阶：用专家团并行做一个大项目

精通：绑定微信助理，先发只读测试任务，再跑通远程派活闭环

精通：配置全局/项目记忆，把成功方法沉淀成自己的 Skill延伸资源

WorkBuddy 官网：workbuddy.cn（下载、订阅价格、官方文档）
WorkBuddy 实战蓝皮书（社区开源，27 章，强烈推荐）：workbuddy.homes——从安装入门到岗位落地，边读边做效果最好。

一句话总结：选它，因为它离中国人的办公桌最近；入门靠完成一个小任务，进阶靠把需求说清楚，精通靠把成功方法沉淀成系统。别从「研究所有功能」开始——从今天工作里最重复、最繁琐、又最容易检查的那件小事开始。