WorkBuddy 怎么用？安装、登录、授权文件夹和第一个任务
WorkBuddy 的上手过程可以分成四个阶段：安装客户端，完成登录，选择一个工作空间，做一项可以检查的任务。很多教程把这四步混成“打开后随便问一句”，结果用户能看到回答，却不知道文件读取是否正确、结果存在哪个目录、任务使用了哪种权限。本文把每个阶段拆开，并给出一份适合第一次使用的验收清单。
WorkBuddy 官方文档目前按简介、安装、功能说明、实践案例、Skill、接入指南和费用组织内容。不同版本的菜单文字可能变化，因此下文使用“设置中的模型/工作区/权限入口”等功能含义来描述，不把某个版本的截图当作固定界面。你实际操作时，以客户端当前显示为准。
安装前准备
先确定你要使用的系统和项目资料。若只是体验，可以创建一个临时目录，放入几份不含敏感信息的 Markdown、CSV 或图片。若要处理工作项目，先确认团队是否规定客户端版本、账号类型、文件存储位置和网络环境。不要在没有备份的情况下把整个资料库作为第一次测试对象。
安装前还要准备登录方式。WorkBuddy 的登录页面可能要求账户认证、团队邀请或订阅确认；这些属于账户层，不等于模型 API 已经接通。若准备使用自定义模型，还需要另行准备对应服务商的 Key 和 Base URL，不能把网页登录密码当作 API 凭证。
下载、安装和版本检查
从 WorkBuddy 官方入口或组织提供的安装包开始。下载完成后检查文件来源与系统提示，避免运行来路不明的修改版客户端。安装过程中如需系统权限，确认安装位置和发布者，再继续。安装后打开应用，记录版本号，后续遇到问题时它是重要的排查条件。
如果应用无法打开，区分下载损坏、系统权限、网络登录和兼容性问题。重新下载只适合下载确实失败的情况；若应用已经能打开而登录失败，重点应转向网络、账户和组织策略。不要因为一个错误提示就删除全部配置，先保存已有工作区和任务记录。
第一次登录应该检查什么
登录后查看当前账户、团队空间和可用功能。若有多个身份，确认你选择的是拥有目标工作区权限的账户。然后找到模型或 AI 服务商设置，记录当前默认模型和是否允许自定义 Provider。不要直接把生产 Key 粘贴进去测试，先确认客户端是否支持你准备使用的接口格式。
登录状态异常时，记录错误发生在浏览器跳转、回调、账户验证还是工作区加载。应用可以打开但空白，可能是网络或缓存；能登录但模型不可用，可能是套餐或组织权限；能对话但不能读取文件，通常与工作区授权有关。按阶段排查比反复退出登录更快。
选择工作区和授权文件夹
点击新建任务或创建工作区后，选择一个专门的测试目录。目录里只放任务所需资料，最好把输出目录和原始资料目录分开。例如 input/ 保存原文件，output/ 保存生成物，notes/ 保存人工要求。这样你能清楚看到哪些文件是输入，哪些是新产物。
授权时检查是否包含隐藏文件、缓存、环境变量文件和旧导出。若 WorkBuddy 提供读写权限选项，第一次只给读取或工作区写入，不要把整个磁盘设为可写。工作区授权不是一次性解决所有安全问题；任务仍可能调用外部服务，模型也可能把你提供的内容纳入请求。
三种工作方式怎么选
常见工作方式可按主动程度理解。普通对话适合解释、规划和小段内容；工作区任务适合读取文件、生成产物和处理多步工作；自动化适合按时间或事件重复运行。它们不是质量等级，而是执行范围不同。
| 工作方式 | 适合场景 | 第一次使用建议 |
|---|---|---|
| 对话 | 解释概念、梳理需求、生成小段文本 | 不授权敏感目录 |
| 工作区任务 | 整理文件、生成报告、处理表格 | 使用测试目录，检查产物 |
| 自动化任务 | 周期性汇总、提醒、固定流程 | 先手动跑通，再设置触发 |
如果你还不知道最终输出格式，先用对话讨论。格式确定后再创建工作区任务。不要把需求讨论和批量执行塞进同一个无边界任务里，否则产生的文件和修改很难复核。
创建第一个任务
第一次任务可以是“读取三份会议记录，生成一份带来源的摘要”，因为输入范围、输出格式和验收方式都比较清楚。输入示例：
请读取 input/ 下的三份会议记录，生成 output/weekly-summary.md。
要求：按日期排序，分成已完成、进行中、风险和待确认四节；每个数字和日期都标注来源文件名；不要改动 input/ 中的原文件；如果某项信息没有来源，写“待确认”。完成后列出读取的文件和检查结果。发送前检查路径是否与工作区一致。执行过程中观察它是否只读取三份文件，是否把输出写到 output/。如果它提出要访问不相关目录，暂停并要求解释。任务结束后打开生成文件，不要只看聊天摘要。
结果验收和重试
验收不是挑错，而是确认任务满足目标。先检查文件是否存在，再检查结构、事实和格式。摘要类任务要看是否遗漏关键议题；表格类任务要看行数、列名和空值；PPT 要看页面布局和数据来源。若产物包含外部链接，打开几个关键链接确认地址和内容。
失败后先检查工作区状态。应用可能已经写入部分文件，也可能创建了临时目录。将已有产物告诉 WorkBuddy，再决定继续或清理。不要在不知情的情况下点几次“重试”，尤其是涉及邮件、云端表格或发布动作时。
文件夹授权的常见错误
授权了错误目录时，WorkBuddy 会声称找不到资料，或者读取了另一份同名文件。多份项目副本也会造成同样问题。先在文件管理器或终端确认目录位置，再重新选择。若文件本身被系统或其他应用锁定，先复制一份测试资料，不要直接解除所有权限。
文件夹内有 .env、私钥、客户名单和内部合同等敏感信息时，建议建立专门的输入目录，只复制任务需要的字段。不要把“方便读取”当作“应该全部授权”。工作区越大，任务上下文越复杂，费用和误读风险也可能增加。
工作区和 API 配置的关系
WorkBuddy 的工作区负责文件和任务，模型 API 负责生成和工具请求。你可以使用内置模型，也可以在支持的版本中设置自定义 Provider。设置 API 地址不会自动赋予文件权限；授权文件夹也不会自动解决 401 或 404。排查时分别检查工作区、模型和网络。
使用 ClawSocket 时，打开 ClawSocket 控制台，创建专用 Key，按照当前 WorkBuddy 版本的自定义模型入口填写 https://api.clawsocket.com/v1、Key 和实际模型 ID。先验证短文本，再验证文件任务和流式响应。完整接入方法见WorkBuddy API 接入。
三个新手常见错误
第一个错误是任务太大。用户一句“帮我整理整个资料库”，让 Agent 自己猜分类、命名、重复和归档规则，最后很难验收。先用五到十个测试文件验证规则，再扩大数量。
第二个错误是没有说明原始资料不能修改。对于整理、清洗和生成任务，明确“只读原始目录，输出到新目录”，能减少覆盖风险。第三个错误是把模型自述当作证据。它说“已完成”时，你仍需检查实际文件、数字、引用和日志。
FAQ：WorkBuddy 安装与第一个任务
WorkBuddy 安装后打不开怎么办？
记录系统、客户端版本和错误阶段，先区分下载、权限、启动和登录问题。若应用能打开但无法登录，不要把它当成安装文件损坏。
第一次应该授权哪个文件夹？
选一个只包含测试资料的专用目录，输入和输出分开。不要第一次就授权用户目录、云盘根目录或生产资料库。
任务提示词写多长合适？
长度没有固定标准，关键是包含目标、输入、限制、输出和验收。比起堆背景，写清文件范围和完成条件更有用。
生成的文件找不到怎么办？
检查工作区路径、任务输出目录和实际文件名，再查看任务是否中途失败。不要只依据最终回答判断文件已经写入。
可以直接处理真实客户资料吗？
先确认组织的隐私和权限要求。第一次应使用脱敏或测试资料，确定请求路径、存储位置和工具权限后再扩大范围。
自定义模型配置失败会影响安装吗？
不一定。客户端安装、账户登录、模型鉴权和工作区权限是不同环节。先用默认入口完成最小任务，再单独排查自定义 Provider。
第一次任务检查表
| 阶段 | 检查内容 | 通过标志 |
|---|---|---|
| 安装 | 客户端能启动 | 能显示版本和主界面 |
| 登录 | 账户和空间正确 | 能进入任务页面 |
| 授权 | 目录范围合理 | 只包含测试资料 |
| 输入 | 文件确实被读取 | 任务日志或结果列出文件 |
| 输出 | 产物可以打开 | 文件存在且格式正确 |
| 验收 | 事实和结构正确 | 抽样能回到原始资料 |
完成这次小任务后，再学习WorkBuddy Skill、MCP 与自动化，把稳定流程封装成可复用能力。
前往 ClawSocket，配置 WorkBuddy 可用模型 →
任务完成后如何保存工作方法
第一次任务通过后，别急着马上换一个完全不同的场景。先记录这次任务实际需要的目录、提示词、输出格式和人工检查点。下次遇到同类工作，可以把这些内容整理成一个模板，再根据新的日期、文件或受众替换变量。这样积累出来的模板比一句“按照上次做”更容易复用，也便于别人接手。
如果同一任务连续出现相同错误，例如日期被混淆、输出覆盖旧文件或遗漏来源，就把对应限制写进任务模板或 Skill。不要只在结果里补一句提醒，因为下一次执行时它可能看不到上一轮的聊天。长期规则、一次性范围和当次输入要分别保存，后续调整才不会互相覆盖。
什么时候应该暂停自动执行
遇到输入资料缺失、授权范围改变、输出需要对外发布或模型服务切换时，先暂停自动任务，回到手动验证。完成一次小范围复测后，再恢复周期执行。暂停不是失败，而是把变化隔离在可检查的阶段，避免错误结果连续传播到多个日期或多个团队。
记录暂停原因、已经生成的文件和下一步检查项。恢复时先读取当前状态，再继续剩余步骤，不要从头批量重跑。若服务商或模型发生变更，还要重新确认费用、流式、工具和数据发送范围，不能只看任务界面仍然能够打开。
给团队新成员的交接清单
交接文档至少应包含 WorkBuddy 版本、登录入口、工作区路径、输入和输出目录、默认模型、权限边界、常见错误以及负责人。真实 Key 不写入文档，成员按组织流程获得自己的凭证。每项说明都应有一个能在测试资料上执行的验证动作，避免新成员只能凭截图判断配置是否正确。
如果团队使用 ClawSocket，补充控制台入口、模型 ID 的查询位置、项目额度和撤销流程。若使用 MCP 或 Skill，说明连接负责人、只读与写入范围、失败通知和人工审核节点。一个清楚的交接清单能减少“安装正常但任务结果不一致”的重复排查。