WorkBuddy使用教程：从安装登录到完成第一个任务
如果你搜索“WorkBuddy使用教程”，通常想解决的不是一个单独按钮在哪里，而是一整套使用流程：WorkBuddy 是什么、从哪里下载、怎样登录、如何让它读取本地文件、任务该怎么描述、生成的结果保存在哪里，以及怎样把它接入自己的模型和自动化流程。本文把这些问题放在同一条路径里，带你完成一次可检查的任务。
WorkBuddy 是面向办公和内容生产场景的 AI Agent 工作区。它可以围绕文件、表格、网页和任务目标执行多步操作，最后交付文档、表格、演示文稿或整理后的数据。它与普通聊天的区别在于，工作区、工具和产物都成为任务的一部分。工具能读取哪些内容，取决于你选择的工作空间和授权范围；能否得到可用结果，则取决于目标是否清楚、输入是否完整和验收条件是否明确。
本文参考 WorkBuddy 官方公开文档的导航结构，并结合站内已有的 API、模型和中转站内容编写。产品菜单、登录方式、模型列表和费用会更新，本文不把某个截图中的按钮名称当作永久不变的事实。开始操作时，优先看当前客户端和官方文档显示的入口。
WorkBuddy 适合处理哪些任务
WorkBuddy 适合那些输入材料相对明确、输出形式可以描述、结果能够由人检查的任务。例如把一个文件夹里的会议记录整理成周报，把多张表格合并并清理重复项，根据已有资料生成演示文稿初稿，或者从网页和文档中提取带出处的要点。它也适合重复性较高的整理工作，但不能因为任务看起来机械，就跳过权限和结果核验。
不建议一开始就把含有生产密钥、个人敏感信息或不可恢复数据的目录交给 Agent。先建立测试资料，确认它会读取哪些文件、输出到哪里、是否会创建新文件，再扩大范围。对于发邮件、改线上表格、发布内容等有外部影响的动作，要把“生成草稿”和“正式执行”分成两个阶段。
| 任务类型 | 适合的输入 | 需要检查的结果 |
|---|---|---|
| 文件整理 | 文件夹、命名规则、示例文件 | 是否误删、重命名是否符合规则 |
| 周报生成 | 会议记录、时间范围、模板 | 事实、日期、遗漏和引用 |
| 表格清洗 | 原始表、字段说明、输出格式 | 行数、字段类型、空值和重复项 |
| PPT 初稿 | 提纲、素材、页数和受众 | 结构、数据、图片授权和可读性 |
| 网页资料整理 | URL、主题、截止时间 | 来源、时效、是否把推测写成事实 |
第一步：安装和登录
WorkBuddy 的官方文档将安装指南、功能说明和实践案例分开。使用前先确认你下载的是当前官方客户端或组织提供的版本。下载完成后打开应用，按当期界面完成登录。登录成功只说明账户认证完成，不代表模型、文件权限和自动化功能已经准备好。
第一次启动后，先检查应用版本、当前账户和工作区入口。若你同时使用个人账户和团队账户，确认任务将使用哪个空间、费用归属于哪个账户。不要在公开截图中展示账户邮箱、访问令牌和项目名称。工作区可能保存文件、会话或任务产物，开始真实工作前先阅读当前版本的隐私与权限说明。
如果客户端无法启动，先区分安装问题、系统权限问题和网络登录问题。命令行启动失败不一定代表桌面端安装失败；桌面端能打开也不表示终端环境已经配置好。遇到错误时记录系统版本、客户端版本、错误阶段和是否能打开空白任务，再决定是否升级或重新安装。
第二步：选择工作空间并授权文件夹
WorkBuddy 的工作空间是任务上下文的一部分。你可以把它理解成 Agent 被允许查看和产出文件的范围。选择项目目录时，先选一个测试文件夹，里面只放本次任务需要的资料。不要为了省一步把整个用户目录、云盘根目录或生产文件共享进去。
授权时检查三个问题：它能读哪些文件，能写入哪些位置，任务是否允许执行本地命令或调用外部服务。某些版本会在首次访问文件夹时弹出授权窗口；某些版本则在工作区设置中管理。菜单名称可能变化，但权限含义不变。若任务只是总结资料，就不需要把写权限扩大到整个项目。
开始任务前，可以让 WorkBuddy 先做只读检查：列出目录中与任务相关的文件，说明将读取哪些资料，不修改任何内容。你要核对它有没有选错文件、漏掉关键附件或把缓存和生成目录当成原始资料。只有范围确认后，才进入生成和写入阶段。
第三个步骤：写出可验收的任务
一个好的任务描述至少包含目标、输入、限制、输出格式和验收方式。目标说明你想改变什么；输入说明资料在哪里；限制说明哪些内容不能动；输出格式说明希望得到什么文件或表格；验收方式说明怎样判断结果完成。
可以使用下面的模板：
目标：把本周的会议记录整理成一份周报。
输入：读取工作区的 meeting/2026-10-19.md 到 meeting/2026-10-23.md。
限制：只使用这些文件，不补写没有来源的事实，不修改原始记录。
输出：生成 weekly-report.md，包含进展、风险、下周计划和待确认事项。
验收：每个日期和数字都能回到原文，输出文件保存到 reports/，完成后列出引用文件。这个模板的价值在于把“看起来不错”换成可检查的条件。若你想要一份 PPT，还要写清页数、受众、比例、语言和素材来源；若要清洗 Excel，要写清重复行如何处理、空值怎么保留、金额字段的单位。没有说明时，WorkBuddy 只能根据常见做法猜测，结果可能与业务习惯不一致。
任务描述不要同时塞进互相独立的十个目标。先完成一条可验收链路，再扩展。比如先让它列出表格异常，不要直接要求清洗、统计、画图、发邮件和归档。每一步留下产物，出了问题才知道是哪一个阶段产生了偏差。
第四步：理解执行过程和产物
WorkBuddy 执行任务时，可能经历读取资料、分析、调用工具、生成文件和总结结果。你不需要盯着每一段内部推理，但应关注它正在处理什么文件、是否遇到权限或格式错误、产物保存到哪里。长任务中如果界面提供过程日志或任务状态，保留关键错误和停止原因。
生成文件后，不要只看最终摘要。打开实际文件，检查标题、数字、表格列、图片和链接。对自动整理的文件，抽样检查原始资料和输出之间的对应关系。对生成的文案，检查事实、日期和语气；对表格，检查行数和公式；对 PPT，检查页面是否出现遮挡或字体过小。
如果任务中途失败，先查看已经生成的文件和工作区变化，再决定是否重试。流式中断或应用关闭不代表没有写入。重新执行前说明当前工作区状态，避免重复创建同名文件、重复发送通知或覆盖人工修改。
第五步：用 Skill、MCP 和自动化扩大能力
Skill 适合把一套稳定的方法、模板和检查规则封装起来；MCP 适合连接外部工具或数据；自动化适合按时间或事件重复执行。三者都扩大了 WorkBuddy 的工作范围，应该逐项启用并验证，而不是同时打开全部能力。
使用 Skill 时先阅读它的输入、输出、依赖和限制。一个“生成周报”的 Skill 可能要求固定目录和模板，如果你没有提供，结果就会退化为泛化文本。使用 MCP 时先调用只读工具，确认数据源和权限，再考虑写入。设置自动化时先在测试资料上手动运行，再增加定时触发。
站内专题：WorkBuddy Skill、MCP 与自动化教程会分别说明这些能力；如果你要连接 API 或更换模型，阅读WorkBuddy 接入第三方 API。
WorkBuddy 接入 ClawSocket 和自定义模型
如果当前版本提供 OpenAI Compatible、Custom Provider 或自定义模型入口，可以前往 ClawSocket 控制台创建项目 Key。本站常用入口是 https://api.clawsocket.com/v1。需要填写的通常是 Provider、Base URL、API Key 和模型 ID，但字段名称和是否自动追加请求路径要以当前版本为准。
先用短文本验证地址和密钥，再测试文件读取和流式输出。普通文本成功不代表工具调用、图片或长上下文也兼容。模型 ID 应从 ClawSocket 控制台复制，展示名称不一定等于 API ID。费用、额度和请求记录属于 ClawSocket 账户，不能用 WorkBuddy 的界面名称推断。
完整配置方法见WorkBuddy 中转站怎么选。配置中不要写真实 Key，也不要把包含 Key 的备份提交到 Git。生产环境建议按个人、项目、测试和 CI 分开创建凭证，设置额度并定期轮换。
三个新手常见错误
第一个错误是任务太大。用户一句“帮我整理整个资料库”，让 Agent 自己猜分类、命名、重复和归档规则，最后很难验收。先用五到十个测试文件验证规则，再扩大数量。
第二个错误是没有说明原始资料不能修改。对于整理、清洗和生成任务，明确“只读原始目录，输出到新目录”，能减少覆盖风险。第三个错误是把模型自述当作证据。它说“已完成”时，你仍需检查实际文件、数字、引用和日志。
FAQ：WorkBuddy 使用教程
WorkBuddy 和普通聊天有什么区别？
WorkBuddy 把工作空间、文件、工具和产物放进同一个任务流程中。普通聊天通常只处理你粘贴或上传的内容；WorkBuddy 是否能读取和写入文件，取决于当前工作区授权。
第一次使用应该做什么任务？
选择一个可恢复的测试文件夹，让它只读列出文件并总结目录，再做一个输出到新目录的小任务。这样可以同时确认登录、工作区、读取范围和产物位置。
为什么 WorkBuddy 生成的文件找不到？
检查任务中指定的输出目录、工作区当前路径和应用的任务产物面板。不要只看最终回答，打开工作区搜索文件名，并确认任务是否在中途失败。
WorkBuddy 可以接入 ClawSocket 吗？
如果当前版本支持 OpenAI Compatible 或 Custom Provider，可以尝试使用 ClawSocket 的兼容入口。先确认模型 ID、Base URL、Key 和流式/工具能力，再逐步扩大任务。
WorkBuddy 会自动修改原始文件吗？
是否写入由任务权限、工作区设置和具体操作决定。为了降低风险，明确要求原始目录只读，把产物输出到新目录，并在任务结束后检查实际 diff 或文件变化。
任务失败后要不要直接重试？
先检查是否已经生成文件或产生外部动作。确认当前状态后再重试，并在新任务中说明已有产物，避免重复写入或重复发送。
表格：第一次任务验收清单
| 检查项 | 通过标准 |
|---|---|
| 登录 | 当前账户与目标工作区一致 |
| 工作区 | 只授权任务需要的目录 |
| 输入 | 任务中列出的文件确实被读取 |
| 输出 | 文件保存到指定目录，格式可打开 |
| 事实 | 数字、日期和引用能回到来源 |
| 权限 | 没有执行未授权的外部动作 |
| 费用 | 能在对应账户看到请求或用量 |
完成这份清单后，再把 WorkBuddy 用到真实业务。你不需要一次记住所有菜单，只要能稳定完成“目标清楚、范围受控、产物可验收”的任务，就已经掌握了 WorkBuddy 的核心用法。